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" }} ]
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "poll_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum events to return | |
| sessionId | No |