push_event
Queue game events like NPC actions, combat updates, and world changes for RPG sessions, enabling automated event processing and frontend display.
Instructions
Push an event to the inbox. Used by DM or internal systems to queue events.
NPCs "doing things" on their own, combat updates, world changes - all go here. Frontend polls this to show what happened.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| eventType | Yes | ||
| payload | Yes | Event data (JSON object) | |
| sourceType | No | ||
| sourceId | No | ID of source NPC/entity | |
| priority | No | 0=normal, 10=urgent | |
| expiresAt | No | ISO timestamp when event expires | |
| sessionId | No |