Replication event
In one line: a one-off fact the server tells clients — an attack, an explosion, a notice — routed to the sessions it concerns and delivered with their next frame.
State says what is; an event says what happened. A system emits one with ctx.Subscriptions.Emit(in evt), and its declaration
decides who hears it:
| Routing | Reaches |
|---|---|
RouteNear(point, radius) |
sessions whose view contains the point the event carries |
RouteToKnown(entity…) |
sessions that already hold any of the entities it names |
RouteToOwner(entity) |
the session controlling that entity |
RouteToSession() |
the one session the emitter names (EmitTo) |
Broadcast() |
every session |
An event is encoded once, after the tick's projection, and the same bytes reach every session it matches; an EntityId field travels as
the netId the client knows (0 when it has none). A session that misses frames receives the events of the ticks it missed with its next
one, from an event log eight ticks deep.
Events are best effort by default. A session more than eight ticks behind loses the events of the ticks past the log, and its next
frame starts with the built-in EventsLost event counting them. Most of what must never be lost is state: a death is a mode change the
client learns from its next record, not only a message.
A reliable event (.Reliable()) is for a fact the client cannot learn again from state — a trade's outcome, a loot drop. While a session
lives, it receives every reliable event routed to it, once and in emission order; a session that cannot keep up is closed (1013) and
reconnects. Reliable events are budgeted (SubscriptionsOptions.ReliableEventBytes): an emit past the budget is refused, never dropped later.
How it relates
- Client command — the other direction: intents from clients.
- Projection — the state that events complement, never replace.
- System — systems emit events in the tick; the runtime's in-process event queues are a different thing (signals between systems).
In the API
SubscriptionsRegistry.Event<T>(…)andEventBuilder<T>.SubscriptionsCommands.Emit<T>/EmitTo<T>.
Learn & use
- Narrative: Guide ch.7 §6 — events
- Feature detail: Events