poll_events
Retrieve and mark as read unread game events generated by NPCs, combat, world systems, and schedulers while the player was away, maintaining game world autonomy.
Instructions
Poll the event inbox for unread events. Returns events and marks them as consumed.
Events are generated by NPCs, combat, world systems, and schedulers. They represent things that happened "while the player wasn't looking" - making NPCs feel autonomous.
Example response: [ { "eventType": "npc_action", "payload": { "npcName": "Bartender", "action": "wipes a glass nervously" }}, { "eventType": "quest_update", "payload": { "questName": "Missing Merchant", "update": "New rumor heard" }} ]
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum events to return | |
| sessionId | No |