Grayboxing Levels in Unreal

February 5, 2019

Grayboxing in Unreal Engine

Basics of BSP

Wiki Unreal Engine – Basic Level Design BSP

I’ve started to learn the basics of the Unreal Engine (UE4), primarily with respect to it’s BSP (Binary Space Partitioning) and grayboxing levels. It’s the engine of choice for our Architectural Approaches to Level Design class specifically for this purpose.

Brushes

Unreal provides a base of shapes to work with that are perfect for setting up the overall shape and scale of a level or world in 3D. There are boxes, cones, stairs (linear, curved, and spiral), cylinders, and spheres. These shapes however also have various parameters associated with them that really help you mold out your world. The objects can have their sizes changed without strange scaling effects that need to be accounted for. The stairs have parameters for stair size and shape.

One particularly useful feature is that these shape brushes can be either additive or subtractive. Additive does what you would expect, creates the shape in the world. Subtractive however removes the colliding volume from any existing additive shape it intersects with. This can quickly and easily create some interesting shapes, or help build out rooms and doorways. Speaking of rooms, another helpful feature for this is that you can make some of these shape brushes hollow. This leaves a thin shell of the shape with a completely empty volume.

Geometry Mode

Finally, if you really want to stretch the creativity of your shapes, you can further edit them in Geometry Mode. This tool reminds me of Maya; it lets you do things like extrude faces or move around/remove vertices. This mode lets you craft the shapes almost anyway imaginable and is very easy to use.

Tower Defense Tutorial – Brackeys – Ep. 11

February 4, 2019

Tower Defense Tutorial

Episode 11 – Currency

Youtube – How to make a Tower Defense Game (E11 CURRENCY) – Unity Tutorial

By: Brackeys
Ep. 11

This episode gets into setting up the currency system for the game. We started by creating the TurretBluePrint script. This was set as System.Serializable, which lets us see the fields of the script in the editor. We also removed the MonoBehaviour reference (very important, I initially missed this and it was not showing up in the editor properly). We then went back through previous scripts (such as BuildManager and Node) and applied this new TurretBluePrint class where it made sense.

We finally moved the method that actually builds the turrets from the Node script into the BuildManager script. This started by creating a bool property CanBuild in the BuildManager. As a property, we only allow it to “get” something (it only has the get part of get/set). So it was:
Public bool CanBuild {get {return turretToBuild != null}}
Similar to writing a small function that checks if turretToBuild is equal to null or not.

We created a small helper method in the Node script simply titled GetBuildPosition. This returned a vector3 that summed the node’s transform.position and the determined positionOffset. This vector3 could then directly be referenced as the precise location to instantiate a turret relative to the node selected. Also wanted to make the GameObject turret variable in node public, so we added a Header “Optional” to make it very clear in the editor it was ok if this was not filled with something.

This is how everything works now:

  • Start by clicking on shop icon
  • Performs Shop method tied to button: calls SelectTurretToBuild method from BuildManager and sends it TurretBluePrint (class holding a turret prefab and a cost int) pertaining to the specific turret selected
  • In BuildManager, this method just sets the turretToBuild TurretBluePrint variable to the passed in TurretBluePrint
  • Then when player clicks on a node (OnMouseDown), it performs a few checks that just return first: is it over a UI element, if BuildManager’s CanBuild is false, or if turret does not equal null
  • If it passes all these checks, it calls the BuildTurretOn method from the BuildManager and passes in itself as the Node input for the method
  • BuildTurretOn instantiates the GameObject portion of the turretToBuild TurretBluePrint class (turretToBuild.prefab) at the proper position (from the node helper method GetBuildPosition)
  • Finally, BuildTurretOn also sets that node.turret variable to the instantiated turret gameObject (that node’s turret variable will no longer be null, so it will not pass the first OnMouseDown check)

Now we start on dealing with actual currency. We created a script PlayerStats to add to the GameManager to hold onto any player related stats. The most direct one being Money, which was created as a public static int so we could access it from anywhere easily. It will also carry over from one scene to the next. We then edited the BuildTurretOn method in the BuildManager so it would properly deal with currency. It first checks if the player has enough money before placing a turret (if they do not, then it does not do anything else). If that passes, it creates the turret and subtracts the cost from the player’s current money.

SUMMARY

  • *** Very Helpful! By removing the MonoBehaviour reference and adding the System.Serializable to a class, we can use it as a type of container to simply store multiple variables (different types and values) with multiple shown in the editor. For example, our TurretBluePrint class held a public GameObject and public int, so anytime we referenced a public TurretBluePrint in a script, it created a slot for a GameObject and an int in the editor tied to this one variable
  • Use Boolean properties (just “get” variables) as a safe and effective way to check state of other variables
  • Use small helper functions for cases of small arithmetic functions that will probably be needed a lot, especially if they can be well defined so the reason for the math is clear
  • Be careful with public static variables as they persist over scenes

Tower Defense Tutorial – Brackeys – Ep. 10

February 3, 2019

Tower Defense Tutorial

Episode 10 – Missile

Youtube – How to make a Tower Defense Game (E10 MISSILES) – Unity Tutorial

By: Brackeys
Ep. 10

This tutorial focused on the missile prefabs for the missile launcher object. There was a heavy focus on effects and visuals, but there were still some additional gameplay elements added to the Bullet scripts of the missiles specifically.

For the interesting gameplay of the missiles, a Physics.OverlapSphere was added so they could find other nearby gameObjects within a determined explosionRadius and damage those objects as well. This OverlapSphere puts all the colliders it finds into an array, which is then dealt with by a foreach loop.

We created a new particle effect for the missile. I still don’t quite understand the new nested prefab QoL changes in Unity, but I did create a nested prefab for this effect. The main effect was the debris falling apart, similar to the bullet. The child effect were flames, which were orange cubes that floated up. Finally we also added a point light that very quickly fades out. The fade out was done with the Animation window by recording and simply starting with the desired initial intensity, then reducing the intensity to 0 at a later time stamp.

SUMMARY

  • If you have a visual model that isn’t on the axes you want for any reason, just call it “Graphics” or “GFX”, and put it as a child to what you will consider the true gameObject to interact with and align that properly by rotating the new GFX/Graphics element
  • Look into particle effects, there are a lot of options
  • Look into nested prefabs in Unity 2018.3+
  • Physics.Overlap sphere is useful to find collidable gameObjects around a location

Learning Reaper – First MIDI Song

February 2, 2019

Learning Reaper

First MIDI Song

Reaper – First MIDI Song Tutorial

This was my first experience using Reaper software, learning to create MIDI audio files. There were some bumps getting started but it worked pretty well after I got going.

The first issue was since I use a Windows laptop it was recommended I get the ASIO audio drivers for working in a digital audio workstation (DAW). I did get those installed ahead of time and it was easy to set them as my audio drivers for Reaper, but it caused some issues since I didn’t fully understand it (and still don’t completely).

Using the ASIO drivers in Reaper made it impossible for me to watch the tutorial videos, as those videos had issues when they went to use the audio driver then. From my understanding, the ASIO drivers specifically make it so one specific program has full control of the audio drivers to help it accomplish its goals, a major one of which is reducing latency. The big latency occurs between playing a virtual instrument and the audio output of it through the software. I eventually just had to use some other audio drivers to mess around with Reaper and listen to tutorials on the same device (and found out quickly how annoying even a small latency is when trying to keep a rhythm).

The Reaper interface also took me a while to get a hang of. Unfortunately my setup and docking did not end up working exactly like the tutorial, which I figured was some issue from just version differences, so that actually took a lot more time to get into a manageable spot than estimated. I was never able to get the Mixer docked “above” the MIDI keyboard section, but I was finally able to get the Mixer to show one mixer track at a time after hours of messing around (turned out I just needed to change a “right click in empty space” setting pertaining to holding the width of the mixers.

After getting through all the initial setup pains, everything actually went really well. Importing the different instrument tracks and messing with the settings and playing them is intuitive and well labeled. I really like how structured you can touch up the tracks after playing. That was especially helpful since I had the latency (messing up the rhythm), and I was using a computer keyboard to play (which makes playing the correct notes pretty difficult). Both of these things and WAY more can be edited after playing to make perfect whole, quarter, eight, whatever notes and play them at the exact right beats.

SUMMARY

  • ASIO drivers are weird and demand focus from a single software (can use workarounds but hard to setup)
  • Try to keep your digital instruments together folder wise, but if you need different ones, makes sure to add other locations in settings
  • Mixer – Uncheck “Show multiple rows of tracks if size permits” if you want your tracks to “stack”
  • Reaper is pretty easy to just mess around with (lots of drag and drop and just playing)
  • Make sure to keep instrument files in same place, or add them to locations Reaper searches

Concept for System for Generative Approach for Physics Based Games

January 31, 2019

Thesis – Generative System for Physics Based Games Concept

Text Book Problem Generator

My current thought on a system for developing generative processes for these games is somewhat like making a framework for problems in a physics text book. With the new system I’ve setup for directly tying physics concepts to these physics games (those lists of physics topics), I think I can relate a game’s parameters (those systematic game mechanic values) to the variables of the foundational equations corresponding to that same game’s potential learning concepts. Again, using Angry Birds as an example, let’s say “Impulse and Momentum” is a potential learning concept. A basic equation for momentum is (momentum) = (mass) * (velocity). Using this information, we can see that varying any parameters equivalent to or pertaining to the variables in this equation will require the player to “solve” the new “problem” presented to them by similarly varying their responses to the system.

So for example (an example within an example), varying the bird’s mass parameter directly correlates to varying the mass in the momentum equation. If the player is still trying to meet a similar/certain momentum result, they basically have to “solve” this equation by determining the correct velocity.

I know this might seem a bit obvious, but I’m hoping it’s one of those situations where it just works out so nicely because it’s actually a good solution. This system also presents a fairly basic way of ensuring different in-game scenarios feel differently. You could keep track of the values for the “problems” presented to the player, and just check if a produced “problem” has values that are “too close” to these archived values. Back to the Angry Bird example, a game scenario presented to the player that they needed momentum in the range of (10 kg*m/s – 15 kg*m/s) with a bird of mass 5 kg (so solution range velocity is (2 m/s – 3 m/s)). The next produced scenario is a momentum range of (11 kg * m/s – 16 kg * m/s) with a bird of mass 5 kg (solution range velocity is (2.2 m/s – 3.2 m/s); maybe the system throws this out and generates a new scenario because it sees the momentum range, mass, and solution velocity are all very similar to something produced before.

The needed “distance away” from an archived problem could also be a weighted, combined distance of all the variables that could be tweaked depending on how you want to setup the system. This way, maybe you have another problem with a similar solution value (like the (2 m/s – 3m/s)), but the momentum and mass involved in the scenario are so different that it still feels like a different, interesting experience.

Tower Defense Tutorial – Brackeys – Ep. 09

January 29, 2019

Tower Defense Tutorial

Episode 09 – Missile Launcher

Youtube – How to make a Tower Defense Game (E09 MISSILE LAUNCHER) – Unity Tutorial

By: Brackeys
Ep. 09

This tutorial covers making the Missile Launcher turret. A lot of it is the same as setting up the first turret, but it’s good practice to repeat the setup. It is extra useful for me because I am using Unity 2018.3 and there is a new way of working with prefabs so any practice with that is very useful.

There is a keyboard shortcut for selecting a variable and changing its name across all instances within the script (and even other scripts). Use Ctrl + r + r, then just type the new name over the old one.

SUMMARY

  • VS Keyboard Shortcut: Ctrl + r + r : Lets you replace all instances of a variable (even across scripts) with a new name
  • Just keep practicing with new Unity prefab setup
  • Simple way of creating UI icon from last time worked well again here

Tower Defense Tutorial – Brackeys – Ep. 08

January 27, 2019

Tower Defense Tutorial

Episode 08 – Shop

Youtube – How to make a Tower Defense Game (E08 SHOP) – Unity Tutorial

By: Brackeys
Ep. 08

This tutorial begins to set up the shop UI for the tower defense game. Setting up the shop UI begins with adding a UI Panel to the Canvas. This was brought down to the bottom and set to stretch across horizontally with the anchors. Then a Horizontal Layout Group component was added, which helps deal with the organization/alignment of children UI objects within this UI object’s space. Those children UI objects are buttons, which are used to choose different turret options for purchase. Going along with the Horizontal Layout Group, all of the buttons had a Layout Element component added to them. This allows you to enter some information on things such as preferred dimension, min dimensions, etc.

We used a quick and simple method to create a nice visual “button” so the player knows what tower is being selected to build. We went into the existing turret model’s prefab and took a screen shot of it with the Snip tool. Then we took that over to Photoshop and erased out the background (this was more easily done by making sure to turn off the skybox in the prefab editor visual so the background was entirely the single Unity blue color). I also changed the PS canvas size to a nice 256 x 256 pixels. Then exported out a .PNG with transparency on. We pulled the image into the Unity editor and changed the texture to a 2D sprite. This image could then be used as the UI sprite of the button, and we had a button that is a sample image of the actual model of our turret.

A Shop script was added to the Shop gameObject. This mostly deals with the actions that the buttons on the UI should perform. This deals a lot with relaying information to the BuildManager script, so a reference to that is immediately set in the Start of the Shop script. It then has methods dictating what turret the BuildManager should be preparing to build. Then, as seen in the earlier tutorials, the Nodes (spaces to place turrets) have their own scripts to access the BuildManager to see what is prepared to be built, and then the Node script actually instantiates the turret as long as the proper conditions are met. The BuildManager acts as the central scripting “hub” for dealing with all of the turret building.

As a final QoL touch for the game, a restriction was placed for highlighting and selecting nodes that were behind important interactive UI elements (we don’t want players placing turrets when they are simply going to select a turret to build). To do this, we went into the Node script and added the namespace {using UnityEngine.EventSystems;}. Then in both the OnMouseDown and OnMouseEnter methods, we added an if statement that just returns {if (EventSystem.current.IsPointerOverGameObject())}. This stops the rest of the method from occurring if the mouse cursor is already on an EventSystems object (i.e. a UI element).

SUMMARY

  • Use Horizontal Group Layout and Layout Elements components on UI elements to help organize and space them nicely
  • Create simple UI button sprite images of models with Snip of prefab editor image, Photoshop out background color, export as .PNG with transparency
  • Have a script that deals with the UI element methods (i.e. what the buttons do) and have it reference the script(s) where most of the “work” is done
  • Use an if statement check with UnityEngine.EventSystems to make sure players clicking on UI elements don’t click on other game elements with that same click, using IsPointerOverGameObject

Tower Defense Tutorial – Brackeys – Ep. 06, 07

January 26, 2019

Tower Defense Tutorial

Episode 06 – Turrets

Youtube – How to make a Tower Defense Game (E06 BUILDING) – Unity Tutorial
Youtube – How to make a Tower Defense Game (E07 CAMERA) – Unity Tutorial

By: Brackeys
Ep. 06

This tutorial covers the user interactions with the node spaces. We started with an OnMouseEnter and OnMouseExit methods. These simply changed the color of the node when hovering the mouse over the node object.

A BuildManager script was created and added to the GameManager object in the game to help dealing with building turrets. We want to access this to handle the building of turrets. The BuildManager used a basic singleton pattern. To do this, we created a public static BuildManager variable called instance within the BuildManager script itself. This will effectively reference itself. In the Awake method, we just set instance equal to this.

Building a turret just used the basic instantiation setup again. The only slight difference is that the node script references the BuildManager script to determine what turret to build (will be more useful in the future with different turret types).

SUMMARY

  • OnMouseEnter and OnMouseExit very straightforward Unity methods for dealing with hovering mouse actions.
  • Learn more about Singleton pattern and why it’s useful
  • Basic color change on hover setup: store original color at start; change color during action (i.e. OnMouseEnter); change back to stored original color after event
  • Easy to access public singleton-like class and its methods with the instance = this setup; Just {name of script}.instance.{name of method}()
  • Setting a Color variable as public in Unity editor just lets you select any color with normal color selection palette
Ep. 07

This tutorial focused on creating the camera controller. It was created in sort of an RTS style. This would be down on keypress, using if (Input.GetKey(“w”)), which would then perform a transform.Translate(). Translate is an easy way to move objects without any need for physics.

To go with typical RTS camera movement, we wanted to move the camera around when the player has the mouse cursor around the edges of the screen. We started with Input.MousePosition, which registers the screen position of the mouse relative to the bottom left corner. This method of tracking the mouse obviously varies with the screen size, so it is a good idea to use this in conjunction with references to the screen size (i.e. Screen.height) as opposed to hardcoded values. We didn’t want to require the mouse to be at the complete border of the screen to move the camera, so we added a panBorderThickness variable to subtract from the screen dimension variables to create an area near the border of the camera where the movement would apply.

The camera movement buffer zones become the following:

  • Top: mousePosition.y >= Screen.height – panBorderThickness
  • Top: mousePosition.y <= panBorderThickness
  • Top: mousePosition.x >= Screen.width – panBorderThickness
  • Top: mousePosition.x <= panBorderThickness

We also added a zooming effect. It can feel extra nice if you rotate the camera relative to its zoom. There is an extra amendment to this tutorial for this effect. This will use the scroll wheel. It is treated more similarly to a joystick, where you use Input.GetAxis. You can find the reference name of the mouse scroll wheel in Project Settings -> Input. Finally, to restrict the zooming values, we created a min and max value and used Mathf.Clamp to limit that.

Unity Forum Link – More Information for Nicer Camera Controller

SUMMARY

  • transform.Translate() good for non-Physics based movement
  • Use Screen.Height and Screen.Width with a border buffer to create zones of mouse position to move camera in RTS-style
  • Create min/max values for camera distance so it doesn’t fly away from game

Tower Defense Tutorial – Brackeys – Ep. 05

January 25, 2019

Tower Defense Tutorial

Episode 05 – Turrets

Youtube – How to make a Tower Defense Game (E05 SHOOTING) – Unity Tutorial

By: Brackeys
Ep. 05

This tutorial starts adding the shooting logic to the turrets. It begins with a basic setup to have a fire rate/firing cooldown based on a timer subject to Time.deltaTime. It then gets into some variable organization where they are situated in a way that makes more sense and adds in headers for clarification in the Unity editor. Creating a header just requires this: [Header(“Header Name”)]. This really nicely separates the variables in the editor, as it sections them off along with the title at the top of that block of variables.

The bullets for the turret are created with a basic Instantiation. However, since we want to reference the bullet instantiated in someway, we set it equal to a GameObject variable. This also requires “object casting”, so the instantiation has (GameObject) in front of it. I need to look into object casting.

This required more instances of destroying gameObjects, and again the tutorial adds the return command afterward to make sure to account for the processing time needed to destroy an object. I need to look into proper use of “return” in Unity scripting.

Determining if the bullet hit the target used an interesting method. The vector between the bullet and its target was determined each frame in Update as normal, but instead of using this solely for directional purposes by normalizing it, the distance (magnitude) was used to determine collision. Another variable, distanceThisFrame, was created and was just the bullet’s speed * time.deltatime. This would determine how far the bullet should move this frame. This was compared with that directional vector between the bullet and the target, and if the distance between them was less than the distance the bullet should travel, it was determined the bullet should collide. I think this specifically works better with a “homing” style projectile, since this means the target moving out of the way isn’t really an option anyway, and it constantly wants to update direction anyway.

They created a simple particle effect to go with the bullet collision. They treated this similarly to the instantiation of the bullet. The particle effect was instantiated as a new gameObject variable, and cast as a gameObject. This was then immediately referenced the next line to Destroy it after a time (after its duration basically). This is a good way to keep your scene clean with instantiated particle effects so they don’t linger as gameObject even after they appear to be gone.

SUMMARY

  • Headers are fantastic for keeping public variables organized in the Unity editor.
  • Destroying gameObjects can take processing time, so using return in conjunction can help keep code safe and do what you expect.
  • Look into proper use of “return;” command.
  • Look into “casting to GameObject”
  • Instance particle effects as gameObject variables to reference to easily destroy them so they do not clog scene

Tower Defense Tutorial – Brackeys – Ep. 04

January 24, 2019

Tower Defense Tutorial

Episode 04 – Turrets

Youtube – How to make a Tower Defense Game (E04 TURRETS) – Unity Tutorial

By: Brackeys
Ep. 04

This starts the creation and implementation of the turret objects.

Use OnDrawGizmosSelected to show important editor information when an object is selected. In this case, DrawWireSphere was used and it showed a wireframe of a sphere with a radius corresponding to the range of the turret.

Wanted turret to update to find targets to fire at, so method UpdateTarget was created. This is going to be relatively expensive using distance checks so it was made as a separate “Update” method so we could run it much less than every single frame. This method was then called in Start with an InvokeRepeating call, which lets you set a time to start running, and a time interval to repeat the method.

Rotating the turrets required usage of Quaternions. First, the direction was obtained with a simple Vector3 between the object and target. This was converted to a Quaternion variable with Quaternion.LookRotation(). It was then converted back to an angular measurement, which was another Vector3 variable that took the Quaternion and just applied .eulerAngles to it. Finally, that angular value was passed specifically to the transform’s rotation value as a Quaternion.Euler rotation vector (which we just passed the y portion of our rotation vector to the y portion of this rotation vector). So keep in mind dealing with angular movement may require lots of back and forth with angles and quaternions.

PROBLEMS

There was an issue where the turret rotation was off by 90 degrees, so the tutorial solved this by separating out the prefab and rotating the rotationPoint(partToRotate) that was an empty parent object of the intended object needing rotation by -90. The child/parent relationship was then put back together and the prefab was reassembled. I decided to just add 90 degrees to the y rotation of partToRotate in the script when assigning the rotation and this worked fine. However, when we changed the method to add a Lerp for the rotation, this broke my solution. This makes sense because the Lerp wanted to go between the partToRotate original rotation and the new rotation, neither of which had my additional 90 degrees in it. Then when it would go to assign the new partToRotate.rotation with my additional 90 degrees and go back to Lerp again, the value was then way out of the original range. This gave a crazy looking jittery effect. This has taught me that I don’t understand Quaternions at all and will need to look into those in the future.