Event Reference
HoloMUSH is event-driven. Everything that happens in the game – speech, movement, object interactions – produces an event. Plugins subscribe to events and can emit new events in response. This page points you to the event-type catalogue and payload specs, then covers the stream system that organizes them.
For event sensitivity (whisper, DM, private-scene content), see Declaring event sensitivity.
Event types
Section titled “Event types”The authoritative, per-plugin catalogue of event types (with sensitivity) is auto-generated from plugin manifests — see the Event type reference. For complete payload schemas, see the World Model Design.
Stream Patterns
Section titled “Stream Patterns”Events are organized into streams. Each stream represents a scope – a location, a channel, or a specific character. Plugins subscribe to streams using patterns:
| Pattern | Matches |
|---|---|
location:<id> |
Events in a specific location |
location:* |
All location events |
channel:<name> |
A specific channel |
character:<id> |
Private messages, notifications |
global:* |
All global events |
* |
Everything |
Most plugins subscribe to location:* or specific event types within locations.
The character:<id> stream carries private messages (pages, whispers) and
per-character notifications.