Unity Utilities

This is a collection of project agnostic utilities and extensions for Unity.

Serializable Types with Custom PropertyDrawers

They are implemented using PropertyDrawers for these specific types without a general editor that would inject itself everywhere. This makes this compatible and does not interfere with other custom editors.

• Couple<T1, T2> and Triple<T1, T2, T3> tuples
• Map<TKey, TValue> dictionary
• MinMax<T> range, with Clamp, Lerp, InverseLerp, Random, and Contains methods for MinMax<float> and, where applicable, also for MinMax<Vector2> and MinMax<Vector3>.
• MinMaxSlider attribute to draw MinMax as a slider
• OptionalValue<T> boolean enabled toggle wrapped around a value
• InterfaceReference<T> allows serializing objects that implement an interface

Attributes

• AutoSetup attribute that tries to wire component references automatically

Extensions

Extensions to Unity Vector types:

• .With, .Add, and .Rotate modifications, e.g. Vector3 v = transform.forward.With(y: 0f);
• Component wise Mul and Div
• SqrDist semantic shorthand
• Vector3.XY, Vector3.XZ, and Vector2.X0Y, Vector2.XY0 swizzling

MathV static class with component wise analogs of Mathf methods:

• Abs, Round, Max, Clamp, and Random that operate on a single vector
• Min and Max that operate on two vectors
• Max and Sum that iterate over the components of a single vector
• MinMax that returns an ordered pair

Extensions to C# System types:

• ICollection.IsValidIndex as guard against ArrayIndexOutOfBounds exceptions
• IDictionary.GetOrCreate
• KeyValuePair.Deconstruct

Extensions to Unity Physics:

• Overlap*, Check*, *Cast, and Contains methods that take *Collider as a parameter
• ToWorldSpace* extension methods for BoxCollider, SphereCollider, and CapsuleCollider
• Contains extension methods for BoxCollider, SphereCollider, and CapsuleCollider
• Layer to LayerMask conversion

Extensions to Unity's Animator:

• IsInState extension method for Animator returns whether the animator is in the specified state.
• GetTrigger extension method for Animator that wraps Animator.GetBool and can be used as a semantic companion to Animator.SetTrigger.

Extensions to Unity Objects:

• HasComponent
• GetOrAddComponent
• TryGetComponentInParent
• TryGetComponentInChildren
• GetComponentsInOnlyChildren
• GetComponentsInOnlyCousins
• SetPositionAndRotation that takes a Transform as parameter.

Extensions to Prefabs:

• RevertIdenticalTransformOverrides reverts unused overrides to local position and rotation to reduce prefab and scene file size and noise.
• HasIdenticalTransformOverrides returns whether RevertIdenticalTransformOverrides has something to revert.

Extensions to the Input System:

• InputActionMap.SetEnabled that calls Enable or Disable depending on the parameter.

Extensions to UI Toolkit:

• SetActive for VisualElement that mimics GameObject.SetActive.

UI Toolkit Custom Controls

• AspectRatioContainer that maintains a configured aspect ratio.

WoldPose and LocalPose

• Each is a lightweight struct that contains a position and a rotation field. Similar to Unity's Transform but without scale, parent, children, component, and other overhead.
• They contain the same data, but are semantically different, as they encode the space in which they are to be interpreted.
• Various TransformXXX and InverseTransformXXX methods are provided to convert objects between spaces.
• WorldPose and LocalPose can be implicitly created from Transform and Rigidbody. When implicit conversions from other custom types are added, WorldPose and LocalPose can be used as general purpose parameter that reduce the amount of overloads needed.

CachedValue

• Constructed from a calculation and validation function, it caches the result of the calculation and recalculates it only when the validation function returns false.
• Similar to Lazy<T> but with an additional IsStillValid function that allows updating the cached value when necessary.

Static Utils class with the remaining utilities:

• EnumValues iterator, e.g. foreach(var value in Utils.EnumValues<SomeEnum>())
• ReturnValueAndLogError utility for lean switch expressions

Changes to Editor Styling:

• Vector4 field in one line (like Vector3 and Quaternion fields).
• Prevent clipping of MinMaxSlider Handles at edges by added padding.