Countdown Manager
manage_countdownCreate, advance, list, or remove countdown timers in the active Novel; timers can fire a world effect at their threshold and auto-advance on scene transitions.
Instructions
Manage countdown timers in the active Novel. set accepts a starting tick count and optional total; advance fires the configured world_effect when the countdown reaches its threshold, and on_scene_transition advances it automatically; direction shifts NPC dispositions only when scope is also set. remove is GM-only and deletes the timer without firing its world_effect. Mutating actions persist to the Novel and are audited; list is read-only. Use when: starting, advancing, removing, or listing clocks. Do NOT use when: tracking a vow's progress — use manage_vow (action: milestone). Revert with manage_history (action: undo).
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": {
"action": "<action>"
},
"name": "manage_countdown"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Countdown name (set/advance/remove). | |
| type | No | round or narrative (set). | |
| scope | No | Optional scope name (set). | |
| ticks | No | Starting ticks (set). | |
| total | No | Optional capacity for decrement refills (set; defaults to ticks). | |
| action | Yes | set, advance, remove, or list. | |
| survival | No | Survival-resource parameters applied when a room hazard names this countdown (set; REQ-622c). | |
| triggers | No | Optional world-model triggers (set). | |
| direction | No | Optional direction: increment or decrement (set). | |
| world_effect | No | Optional world-model effect applied when the countdown fires (set). | |
| on_scene_transition | No | When true, advance on each scene transition (set). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | No | Human-readable text envelope mirroring the structured result (REQ-001, REQ-548a). | |
| status | Yes | Machine-readable result status: OK, NEED_INPUT, WARNING, PARTIAL, or an error category (REQ-002, REQ-548c). |