Welcome to ToyBox - a collection of C# scripts and tools for Unity I've been collecting, using and polishing since approx 2014. They are mostly dependency-free, except some of them use [DebugButton] because it makes life so much easier, even for a small tool. Some of them are mine, while some have been collected from other people over the internet. I'll try to describe them here so you know what you're getting into.
A small tool, inspired from frustration, to generate assembly definition (.asmdef) files in a folder and each of its children where an Editor/ folder is detected, and making references to the root assembly. It can be even smarter, but it already saves some time when you wanna separate some code, or export a package or something.
Usage: select a folder in Project, right-click on it, Create > Assembly Definition (smart) and check out all your cool assembly definitions in all the children of your selected folder.
Sometimes for multi-platform projects (and without cloud build), one must make multiple builds for different platforms.
This tool is a nifty editor window with buttons to build to selected platforms. It incorporates basically 2 clicks: Switch Platform.... and Build (or Build & Run). This way you don't have to wait for Switch Platform and click Build again later, but open the Build > Build To Platform window, select the platform, click build and go make a coffee and wait for your build.
A super useful trick to make functions accessible in the Unity Inspector, for development/debug purposes. Simply add [DebugButton] before any function, and a nice button will appear in the (non-custom) inspector for that script.
Note: this was snatched from Kaae, a friend of a friend, and tweaked by me. There are also other versions if this out there, consider exploring them.
An attribute to use in combination with ScriptableObjects, or maybe other types of assets and prefabs (but easier with scriptableobjects because they can be found easily). Write the attribute like this:
[DefaultAsset("default fish")]
public GameObject defaultFish;
And it will try to assign the first result of the search result for that query. So as an example, the default fish is found by name. But if there is a duplicate file with the name that comes first, it's not so reliable so you should basically watch out with this one.
A UI script that you can put on a RectTransform to allow it to be dragged by mouse/touch, and to not allow it to go outside the screen. Use the RectTransformUtility.cs script for a few functions that can help with the world space / rect space / canvas space transformations (or at least can provide some insight in how that stuff works).
Utility to draw some debug lines just like Debug.DrawLine but in the game view and even in a build, using cubes. There is also a function for not letting them disappear if there is some condition, intended use case is in VR if you hold a button, you can keep the debug on screen to inspect it further.
Here it is drawing some random lines from a point.
One of my favorite little tools: use [EnumButtons] in front of an enum field to make a one-row selectable enum. It also supports flags.
Long enums are a pain, and the EnumButtons won't be useful there. Good thing there is [EnumLongSelection], it makes a window with all the enum options and it keeps the game running while you change the value. Useful in play mode for VR when a player is testing and a designer is tweaking values and changing enums while the player plays in VR. This could use a search function and some optimization but even this way it is usable in some cases. Here it is in a bad example, where it uses the enum KeyCode.
[EnumLongSelection(typeof(KeyCode))]
public KeyCode demoLongEnum;
A selection of scripts (currently just one but a few more ideas come to mind, might expand later) that connect UnityEvents to events from Unity. Put the script on an object and hook it up around the scene or in your prefab to do various things, such as turn objects on/off, run functions, etc, and also use a DebugButton to do that action immediately
- EventOnEnable.cs - run a unity event on OnEnable
What it looks like:
A tool for organizing assets. How to use: open the Horatius Quick Organizer window from the Tools/ menu in unity, select your completely unorganized assets, and click Flatten or Organize to create order (or chaos).
This one is found multiple places online, use by placing [ReadOnly] above a field and it will appear gray in the inspector, and one cannot change the value, only read it. It also features a runtime version, where a field is readonly, but only when the game is playing in Play Mode.
This one is totally snatched from here (and very useful when making games with multiple scenes): https://gist.githubusercontent.com/JohannesMP/ec7d3f0bcf167dab3d0d3bb480e0e07b/raw/e4d0c7f636ceb3d01a12303e775f268000f39f26/SceneReference.cs
Drop the TimescaleHack prefab in the scene (or the TimescaleHack.cs script on any object) and it will draw a little GUI interface that can slowdown time or accelerate it, and it snaps to 1 in the middle. Useful when debugging physics, AI or stuff that changes too fast to notice in real time.
Use it to cast a cone shape rather than a spherecast or boxcast. Doesn't work super well but it sort of works.
Have you ever not done something in Unity just because you dreaded the amount of work it might take, only to wish there was a tool that could quickly do it for you? If that thing was making a lot of prefabs at once, this tool is for you!
Create prefabs out of all children of a transform in the scene, or apply the changes made to existing prefabs parented under the same scene object, with the click of a button. It even handles unique names by suffixing some numbers, if you have multiple children you want to make prefabs out of, and they share the same name.
Unity will work for a bit cause it's slow to update many prefabs at once, but it beats getting carpal tunnel syndrome from too many clicks! Here is demo with 4 prefabs but it can handle endless amounts.
When exporting an object for sharing in another project, it can be useful to export without scripts, so that you can use Unity's built-in "Include Dependencies" checkmark on the export package screen. This script helps you remove all MonoBehaviours from an object so you don't have to do it by hand. Note: it doesn't always work as there are kinks to this export process, but it is a marginally-useful utility nonetheless.
A useful script that makes a transform follow another every update, with toggled position/rotation and update/fixedupdate/lateupdate. There are also smooth-follow versions out there, but sometimes you just need a simple reliable one.
A version of the FlyCamExtended from this place: http://wiki.unity3d.com/index.php/FlyCam_Extended But with some added functionality such as lock cursor, holding Alt disables camera rotation (useful for edit-time tweaks and for recording footage of the game view while tweaking stuff), smooth acceleration, some more parameters in the Inspector.
A UI script that can help with a basic functionality of grids: you want them to look like an evenly spaced grid independent of the size of the parent of the grid, and covering the whole width. It only works with constant cell count width/height but super useful for that. So here you go!
Some extensions of Linq queries that are typical for physics work in Unity, or whatnot.
ClosestRaycastHit - find the nearest hit out of a list of RaycastHit
AggregateSmart - a silly version of the Aggregate() to find one element that satisfies some condition when compared to all the other elements of a list (but ignoring nullable types when the list contains null stuff)
MaxIndex - find the index of the max element, not the max value as Max() does
ClosestColliderBounds and ClosestCollider and ClosestTransform - find the closest distance to one of those things out of a list of things
... maybe more on the way, now that I have a place to put those things as I develop them.
Simple script to make a transform point at another transform, with an option to point at the main camera without need of reference (and using a cached Camera.main for performance).
Move a transform without moving the children in relation to the world space. Nifty for setting up prefabs or levels or grouping objects. Remember to turn it off if you want to move the root object again!
Draws a little colorful sphere gizmo. Useful when doing stuff like procedural generation, AI nodes, whatever uses objects that need to be visible in the scene view. Example: these are all node gizmos that represent different spawn locations, AI pathfinding nodes, and other things that were important to show in the scene. Editor only.
Parent to object OnEnable. Leave null to set parent to null. Useful when you hack around with the hierarchy, could be extra useful in combination with FakeParenting Super useful when doing stuff with rigidbodies - rigidbody physics always more stable without parenting.
Position an object on another object using a raycast. Can be useful with procedural generation, or simple scene setup/level design.
One of the oldest and least polished scripts in the ToyBox. Dates back to 2014 when I made Sheepy in Iceland.
Snatched from https://github.com/ptrbrn/pTween
Added a couple more interesting functions, like pTween.Wait(), pTween.WaitFrames(), pTween.WaitFixedFrames(), pTween.WaitCondition()
Usage:
IEnumerator Sequence()
{
Vector3 p1 = new Vector3(0,0,0);
Vector3 p2 = new Vector3(0,10,0);
yield return StartCoroutine(pTween.To(2f, t => { transform.position = Vector3.Lerp(p1, p2, t); }));
}
A place for extensions to UnityEngine.Random
Useful when you wanna make a fake rope, or a hand/arm, or something that points to something else and has a line in between. Make an object that stretches for the desired length until a target. Requires LookAtObj. Used in #SelfieTennis for the unicorn arms/hands.
Flashes a color and fades it out. Using OnGUI() and GUI.DrawTexture()
A simple reliable wrapper for AudioSource that does things that I tend to use a lot. Random clips, uninterrupted, and initializing on Reset() with 3d spatial blend and no play on awake. Automatically adds and references AudioSource. A work in progress.
A spawner script with various utilities.
A useful script to toggle gameObject.activeSelf state between children of a transform. Useful for quick n dirty changes of the state of a thing, before you do some animation funk.
An extension to get the direct descendant children of a transform and put them in a list.
MIT because you are welcome to use this stuff however you want, and credit is appreciated.