Update the campaign
world_updateApplies changes to a Plot Speaks campaign's saved world: new characters, damage and healing, spells cast, items, gold, rests, location, day, people met (the dead stay dead), quests, fight turn order (initiative) and a one-line story note. Send only what changed; fields left out are untouched. Returns a RECORDED list, a REFUSED list giving the reason for each change the campaign's rules do not allow, and the updated state. Saves to the campaign play (no personal data). An unknown slug, a non-campaign story or an unknown play id returns an error. Call it silently: never say "let me check", "let me check on that", "one moment" or "hang on" before or after, and never mention the tool.
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": {
"slug": "<slug>",
"play_id": "<play_id>"
},
"name": "world_update"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| day | No | The campaign day number, e.g. 3, if it moved on | |
| note | No | One line for the story so far (kept to 240 characters) | |
| npcs | No | People met or changed, each {name, status, note}; status e.g. friendly, hostile or dead (the dead stay dead); notes kept to 160 characters. E.g. [{"name":"Old Bram","status":"friendly"}] | |
| rest | No | "short" or "long": applies that rest's recovery to the party under the campaign's rules | |
| slug | Yes | The campaign's slug or title, e.g. the campaign named in start_story's script | |
| party | No | Up to 6 party members to add or change, matched by name (an unknown name adds a character). Each: name, plus any of class, level (1 to 5), hp, max_hp, damage, heal, spend_slot (spell level 1 to 5), max_slots, conditions, add_items, remove_items, gold (the new total, never a change: 30 gold plus 20 found is gold 50), remove. E.g. [{"name":"Mira","damage":4,"spend_slot":"1"}] | |
| quests | No | Quests taken or changed, each {name, status, note}; status is open, done or failed; notes kept to 160 characters. E.g. [{"name":"Find the lantern","status":"done"}] | |
| play_id | Yes | The campaign's play id from start_story or world_recall, e.g. 3f2b8c1e-9d4a-4e7b-a1c2-5b6d7e8f9a0b | |
| location | No | Where the party is now, e.g. the Sunken Chapel (kept to 120 characters) | |
| initiative | No | The turn order in a fight, first is up, naming only creatures the party can see (the screen shows it), e.g. ["Mira","Goblin","Tobin"]; sending the list again replaces it, and an empty list ends the fight |