OatsUtil is a Unity package with a collection of different utilities for Unity scripting. It mostly consists of things I've rewritten multiple times in different projects so I'm putting it all in one package that can be imported into future projects.

Contains:

• ComponentExtensions class which gives Unity components methods for getting references to components and GameObjects with null checks and exception logging.
• InBetweening classes to easily make tweening coroutines
• CollectionExtensions class which gives Arrays and Lists methods for getting random elements and shuffling their elements.
• StringExtensions class which gives strings methods for formatting, including pluralizing, adding quotes and adding formatting tags.
• IEnumeratorExtensions class which gives IEnumerators the .Then() method, allowing Enumerators to be strung together in a sequence.
• NumberUtils class with methods for various numerical operations like mapping a value from one range to another, wrapping a value in a range, and checking if a value is within a range.
• SceneUtils class with methods for accessing GameObjects in the current scene.
• MissingGameObjectException an exception type for when a Unity GameObject is missing

Before, using GetComponent:

LineRenderer lineRenderer = GetComponent<LineRenderer>();
if (lineRenderer == null)
{
    Debug.LogException(
      throw new MissingComponentException("A LineRenderer is needed"),
      this;
    );
}

After, using RequireComponent from OatsUtil:

LineRenderer lineRenderer = this.RequireComponent<LineRenderer>();

The RequireComponent<>() method will check for the component and log the exception if the component is missing.

Before, using FindChild(name):

Transform pivotPoint = transform.FindChild("pivot");
if (pivotPoint == null)
{
    Debug.LogException(
      throw new System.InvalidOperationException("A child name \"pivot\" is needed"),
      this;
    ); 
}

After, using RequireChildGameObject from OatsUtil:

Transform pivotPoint = this.RequireChildGameObject("pivot");

The RequireChildGameObject() method will check for the child and log an exception if it doesn't exist.

Use both RequireChildGameObject and RequireComponent:

this.RequireChildGameObject("Door").RequireComponent<HingeJoint>();

player1 = SceneUtils.FindComponentInScene<PlayerController>("Player1");
player2 = SceneUtils.FindComponentInScene<PlayerController>("Player2");

var MovementTween = new InBetween<Vector3>()
    .LerpWith(Vector3.Lerp)                             // lerp function for the type of value being tweened 
    .From(transform.position)                           // starting value of tween
    .To(transform.position + Vector3.right)             // ending value of tween
    .For(2f)                                            // how long in seconds the tween is
    .Curve(InBetweenCurves.EaseInAndOut)                // specify an easing funcion. Either a float => float function or AnimationCurve
    .OnFrame(vector => transform.position = vector);    // function that runs on each frame of the tween

StartCoroutine(MovementTween.ToEnumerator());

Above code moves the object one unit to the right over 2 seconds with an ease-in-and-out easing function.

You can also make some of the variables editable in the inspector by using a InBetweenConfig object:

[SerializeField] private InBetweenConfig MovementTweenConfig;

public void Move()
{
    var MovementTween = new InBetween<Vector3>()
        .LerpWith(Vector3.Lerp)
        .From(transform.position)
        .To(transform.position + Vector3.right)
        .OnFrame(vector => transform.position = vector)
        .WithConfig(MovementTweenConfig);               // pass config object to specify time, curve and steps

    StartCoroutine(MovementTween.ToEnumerator());
}

This code connects four IEnumerators so that when they run in a coroutine they will run one after the other in sequence.

var AttackSequence = LookAtPlayer()
    .Then(Shoot())
    .Then(ResetPosition())
    .Then(Reload());

StartCoroutine(AttackSequence);

You can also pass in an Action to run after a coroutine completes

StartCoroutine(AttackSequence
    .Then(() => {
        Debug.Log("Done attack sequence");
    })
);

myList.Shuffle();

You can also pass in a System.Random object to the shuffle method

System.Random myRandom = new System.Random(rngSeed);
myList.Shuffle(myRandom);

int randomElement = myList.Random();

"Hey!".Bold() + " She said " + "Go over there".Quote() + " to find the " + "stanted".Italic() + " sign."

When put into a rich text UI element, it will appear as: Hey! She said "Go over there" to find the slanted sign.

float throttleForce = NumberUtils.MapRange(
  minimumLeverRotation,
  minimumLeverRotation,
  minimumForce,
  maximumForce,
  currentLeverRotation
);

Download the latest release from the Releases page. Import the package file into Unity. To use the utilities, only the OatsUtil folder is required, the Editor folder contains unit tests and is optional.

Add using OatsUtil; at the top of any of your scripts to use the methods and classes in this asset package.

• Import the package and make sure to import all the folders including /Editor/UnitTests.
• In Unity do Window -> General -> Test Runner
• In the Test Runner window, select the EditMode tab
• Click "Run"