Libraries

s&box libraries list

Game Events

facepunch.libevents

Strongly typed game events

About

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!\"" );
}

More by Facepunch

04
Spline Tools thumbnail
Spline Tools facepunch.splinetools

Work In Progress Spline Tools.

+0 24h
12favorites
17upvotes
86%Terry score