UnityUtils

A collection of helpful Unity scripts and editor tools, purely for convenience.

---

ReadOnly

Source: FuzzyLogic's answer in the Unity forums

To convert any field into a ReadOnly column:

[ReadOnlyInsp] public float example;

Help Box

Source: unity-inspector-help

Add a help text box info into your inspector.

By default, you can just use:

[Help("This is some help text!")]
public float example = 1000f;

You can add an optional parameter that changes the icon that appears with the help box:

• UnityEditor.MessageType.Info : The default icon.
• UnityEditor.MessageType.Error : A red error icon.
• UnityEditor.MessageType.Warning : A yellow warning icon.
• UnityEditor.MessageType.None : Removes the icon, leaving only the text.

#if UNITY_EDITOR
[Help("This is some help text!", UnityEditor.MessageType.None)]
#endif
public float example = 1000f;

Serializables

Extension Functions for various Unity-specific class types such as Vector2 and Vector3. These scripts focus on creating SVector2, SVector3, and SQuaternion equivalents of primitive Unity Vector2, Vector3, and Quaternion classes for use in CSV-writing and such, as the primitive classes are not serializable for JSON or CSV reading/writing.

The existing list of serialized equivalents of primitive Unity classes are:

• Vector2 => SVector2
• Vector3 => SVector3
• Vector4 => SVector4
• Quaternion => SQuaternion
• Color32 => SColor32
• RaycastHit => SRaycastHit

To use these serialized equivalents, you must import the namespace using SerializableTypes.

Additive Scene Manager

Included in this package is an AdditiveSceneManager.cs component. This component is a special helper to enable ADDITIVE scene management. I.E. allows you to load and unload scenes on top of another existing, single scene. Helpful for situations where you may want singleton logic at a scene level, by containing major components in the base scene and only switching out certain content dynamically.

Usage

Installation is really simple: just add AdditiveSceneManager.cs to any GameObject in your base scene, and populate the Scenes list with all the additive scenes.

During runtime, if you are in the editor, you can debug how additive scenes load in via the Inspector; you can load and unload your additive scenes via some UI buttons we've added. You can also call the following functions to control loading and unloading:

• LoadScene(string scene_name, LoadSceneMode mode = LoadSceneMode.Additive): Loads a scene based on a string query. You CAN technically use this to load single scenes via the 2nd parameter, but this is not the intended function of this manager. **Only loads in scenes added to its Scenes list; doesn't control any scenes NOT added to that list.
• UnloadScene(string scene_name): Unloads a scene based on a string query. Only unloads a scene if 1) it's been added to the Scenes list of this manager, and 2) if it's loaded already. Doesn't do anything if the queried scene is unloaded already.
• QuerySceneLoaded(string scene_name): You can check if a scene has been additively loaded from this manager using this function. Returns a boolean indicating so.