roblox_playtest
Control Roblox Studio playtest sessions to test and debug games by starting/stopping tests, moving cameras, triggering interactions, executing code, and reading game state.
Instructions
Control Roblox Studio playtest sessions and interact with the running game.
Actions:
"start": Begin playtest (RunService:Run). Scripts execute, physics activate. Params: mode ("run"|"play", default "run").
"stop": End playtest, return to Edit mode.
"status": Get current mode (Edit/Running/Client/Server).
"move_camera": Reposition camera during playtest. Params: position {X,Y,Z}, lookAt {X,Y,Z}.
"fire_click": Trigger a ClickDetector. Params: path (instance path).
"fire_proximity": Trigger a ProximityPrompt. Params: path (instance path).
"get_state": Read game state (player count, leaderstats, runtime info).
"execute": Run Lua code in the live game context. Params: code (string).
Workflow: start → interact/observe → screenshot (via roblox_scene) → evaluate → stop → fix → repeat.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Which playtest action | |
| mode | No | For start: "run" (server only) or "play" (client+server) | |
| position | No | Camera position {X,Y,Z} (for move_camera) | |
| lookAt | No | Look-at target {X,Y,Z} (for move_camera) | |
| path | No | Instance path (for fire_click/fire_proximity) | |
| code | No | Lua code (for execute) |