scene-get
Get full scene details: tokens (HP, AC, conditions, grid positions), walls, lights, notes, regions. includeMap (default true) appends an ASCII tactical map — walls, doors, numbered tokens with a legend — for spatial reasoning; false when you only need the lists. includeScreenshot=true adds a canvas screenshot (~100-500KB) for terrain, art and ambiance the map cannot convey — first view, not every turn. levels lists the scene's levels (Foundry 14+), weatherEffects the weather ids scene-set accepts (bridge module 8.19.0+). sceneId omitted = the active scene (scene-list has the IDs).
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": "scene-get"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| levels | No | Append the scene's levels (Foundry 14+) | |
| sceneId | No | Scene ID (omit for active scene) | |
| includeMap | No | Append the ASCII tactical map (default true). | |
| weatherEffects | No | Append the weather effect ids for scene-set | |
| includeScreenshot | No | Include canvas screenshot (~100-500KB). Recommended on first scene view or when visual context is needed. Skip during combat rounds to save context. |