scene_state
Captures a Roblox Studio camera snapshot of visible objects with world positions and on-screen pixel coordinates, letting you map screenshot pixels to exact 3D locations. Read-only.
Instructions
Spatial snapshot of the scene as the editor camera sees it: camera intrinsics (CFrame, FOV, viewport) + a curated list of visible objects, each with world position/orientation/size AND its on-screen pixel (x,y,depth,onScreen) via WorldToScreenPoint. This is what grounds a screenshot — it lets you say "object X is at screen (px,py) = world (x,y,z)". A Model counts as one object (bounding box); closest objects first. Pair with the official Roblox_Studio MCP's screen_capture. Read-only.
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_state"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| place | No | Target place (PlaceId or project name). Defaults to the bound/sole connected place. | |
| maxDepth | No | walk depth (default 2); Models are taken whole | |
| rootPath | No | Scope the scan (default Workspace) | |
| maxObjects | No | default 40, capped 120 for transport | |
| nameFilter | No | substring match on Name | |
| classFilter | No | IsA class filter, e.g. Model, MeshPart | |
| onScreenOnly | No | default true — drop objects off-screen / behind camera |