roblox_scene
Control the camera and capture rendered screenshots in Roblox Studio to verify scene composition, placement, and orientation.
Instructions
Control the camera and capture rendered viewport screenshots.
Actions:
"screenshot": Render a PNG image of what the camera currently sees. Returns an image you can analyze visually. Use it to verify placement, scale, orientation, and scene composition. No textures are rendered — use roblox_get action "texture_info" if you need texture/decal context. Params: maxParts (default 2000).
"move_camera": Reposition the Studio camera. Two modes: (A) Auto-frame an object: set focusInstance to an instance path (e.g. "Workspace.GasStation"). The camera automatically positions itself at a good distance and angle to see the entire object. Optional: angle (elevation in degrees, default 35), yaw (horizontal rotation in degrees, default 45). (B) Explicit placement: set position {X,Y,Z} (where the camera IS in world space) and lookAt {X,Y,Z} (the world point the camera POINTS AT). Both must be provided and must be different points. Example: position {X:50, Y:20, Z:50} lookAt {X:0, Y:0, Z:0} places camera at (50,20,50) aiming at the origin.
Typical workflow: move_camera (frame your subject) → screenshot (see the result) → evaluate → adjust.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Which scene operation | |
| maxParts | No | Max parts to render (default 2000, for screenshot) | |
| focusInstance | No | For move_camera mode A: instance path to auto-frame, e.g. "Workspace.MyModel". Camera positions itself to see the whole object. | |
| angle | No | For move_camera with focusInstance: camera elevation angle in degrees (default 35). 0 = eye level, 90 = top-down. | |
| yaw | No | For move_camera with focusInstance: horizontal orbit angle in degrees (default 45). 0 = front, 90 = side, 180 = back. | |
| position | No | For move_camera mode B: where the camera IS in world space {X,Y,Z}. Must also provide lookAt. | |
| lookAt | No | For move_camera mode B: the world point the camera AIMS AT {X,Y,Z}. Must differ from position. |