begounet / adv-unity-event

Advanced Unity Event

Lightweight but more powerful version of Unity Event.

• Reorderable events
• Can directly use generic AUEEvent<T> instead of a creating a new class inheriting from UnityEvent
• Method searcher popup (AddComponent-like)
• Can use AUEGet<TResult> to create a method's result
• Supports AOT
• Supports runtime event subscription (and are displayed in the Inspector)
• Custom parameters:
  • Constant: support all basics native constants + UnityEngine.Object + custom serializable class
  • Dynamic: allow to select where you pass your method arguments
  • Method: use nested method as parameter
  • Property: use a property or nested property (following a path of properties and fields)
• Provide some static helpers to use directly in AUE methods for common operation (ie. BoolSH.Invert to invert a boolean value).

Changelog

Dependencies

Minimum version Unity required: 2019.3

• Type Codebase

Screenshots

Usage

// Create simple event, without arguments
[SerializeField]
private AUEEvent _simpleEvent;

// Create an event that pass an int argument
[SerializeField]
private AUEEvent<int> _intEvent;

 // Supports 4 arguments. Can add more easily.
[SerializeField]
private AUEEvent<int, float, string, Transform> _argEvent;

 // Create a specialized event from inheriting
[Serializable]
public class FloatAdvUnityEvent : AUEEvent<float> { }

[SerializeField]
private FloatAdvUnityEvent _floatEvent;

 // Create a method that will return a float
[SerializeField]
private AUEGet<float> _floatGetter;

// Create a method that will return a string, and allow to pass an int argument.
[SerializeField]
private AUEGet<int, string> _intGetter;

You can even make dynamic customizable AUEEvent. It can be useful to make kind of generic events :

[SerializeField]
private SerializableType _parameterType;

[SerializeField]
private CustomizableAUEEvent _customizableEvent;

private void OnValidate()
{
    if (_parameterType.IsValidType)
    {
    	_customizableEvent.DefineParameterTypes(_parameterType.Type);
    }
}

void Start()
{
    _customizableEvent.Invoke(value); // value must be of the matching type!
}

Advanced

• Editor