Wait for something to happen
wait_for_eventWaits for live Minecraft events—player joins, deaths, chat, console lines, weather, and more—filtered by player or world, then returns the event or times out.
Instructions
Wait until an event happens live and get it, or time out. Types are WebSocket topics: player.join, player.leave, player.death, player.advancement, player.chat (chat:read), player.command and server.console (a console line; both logs:read), player.respawn, player.level_up, player.sleep, player.world_change, player.kill, player.craft, block.break, block.place, world.weather, world.night_skipped, entity.boss_killed, raid.start, raid.finish, server.status, and more. Narrow it to one player or world. Use it for “tell me when Steve logs in”, “wait until night is skipped”, or “wait for the console to say Done”. Keep timeoutSeconds within what your client lets a tool run.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"types": "<types>"
},
"name": "wait_for_event"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| types | Yes | Such as ["player.join"] | |
| world | No | Only this world's events | |
| player | No | Only this player's events | |
| timeoutSeconds | No | Then answers timedOut |