Sandbox Logo

About Game Events


Easily dispatch events in your scene when stuff happens.

Basics

Declare an event type implementing with all the properties you want to pass around.
public record DamagedEvent(

GameObject Attacker,
GameObject Victim,
int Damage ) : IGameEvent;
Implement for your custom event type in a .
public sealed class MyComponent : Component,

IGameEventHandler<DamagedEvent>
{
public void OnGameEvent( DamagedEvent eventArgs )
{
Log.Info( $"{eventArgs.Victim.Name} says \"Ouch!\"" );
}
}
Dispatch the event on a or the , which will notify any components in its descendants.
GameObject.Dispatch( new DamagedEvent( attacker, victim, 50 ) );

Invocation order

You can control the order that handlers are invoked using attributes on the handler method.

* : run this first
* : run this last
* : run this before 's handler
* : run this after 's handler
[Early, After<SomeOtherComponent>]

public void OnGameEvent( DamagedEvent eventArgs )
{
Log.Info( $"{eventArgs.Victim.Name} says \"Ouch!\"" );
}