Read a scene's contents
dos2_sceneRead-onlyIdempotent
Reads a saved GM scene from campaign files: placed characters, encounters, item count and sticky notes. Use it to inspect prepared scenes; for a running game, use the live tools.
Instructions
Reads what the Game Master has placed in one scene, from the campaign files (LevelCache): characters with name, root template, position, vitality, experience, alignment and encounter; encounters with their members; the item count; the scene's sticky notes.
Read-only, and it shows the saved state, not a running game: for the live level use dos2_live_characters. Placed
characters cannot be edited through files; change them in the game or with the dos2_live_* tools. Fails with an
error if the scene has never been loaded in the game (it has no LevelCache file yet).
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": {
"campaign": "<campaign>",
"scene": "<scene>"
},
"name": "dos2_scene"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of characters to list (default 200). | |
| scene | Yes | Scene name or scene ID, as listed by dos2_campaign. | |
| campaign | Yes | The campaign to work on: its name, its folder name, its UUID, or a unique part of any of them. dos2_status lists the campaigns. |