scene-set
Create a scene (no sceneId; name required), copy one (cloneFrom), or change one: size, background image, grid, darkness, weather, global light, fog, token vision, initial view, linked playlist and journal. resetFog clears explored fog, regenerateThumbnail re-renders the thumbnail; level creates (name) or changes (levelId) a scene level (Foundry 14+). Paths from file-list, weather ids from scene-get weatherEffects. Removing: scene-delete; showing to players: scene-activate. Requires bridge module 8.19.0+. EXAMPLE: {"sceneId":"s1","darkness":0.8,"weather":"rain","globalLight":{"enabled":false}}
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-set"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| grid | No | ||
| name | No | ||
| level | No | Scene level: {levelId?, name?, elevation: {bottom, top}, background: {src}, sort} | |
| width | No | Pixels | |
| folder | No | Folder ID (from folder-list) | |
| height | No | Pixels | |
| padding | No | 0–0.5 of the size | |
| sceneId | No | Scene ID (from scene-list); omit to create | |
| weather | No | Weather effect id; null = none | |
| darkness | No | 0 day – 1 night | |
| resetFog | No | Clear explored fog for everyone | |
| cloneFrom | No | Scene ID to copy instead of creating empty | |
| journalId | No | Journal opened from the scene's notes | |
| background | No | Background image path | |
| navigation | No | Show in the scene navigation bar | |
| playlistId | No | Playlist (from playlist-list) played on activation | |
| globalLight | No | ||
| initialView | No | Where the camera opens (pixels, zoom) | |
| tokenVision | No | ||
| darknessLock | No | ||
| journalPageId | No | ||
| fogExploration | No | ||
| animateDarkness | No | Fade to darkness over N ms | |
| backgroundColor | No | "#rrggbb" | |
| playlistSoundId | No | ||
| regenerateThumbnail | No | Re-render the scene's thumbnail |