Playtest a game: send inputs and watch what happens
interact_sceneLoad a game HTML file and run a playtest script of key presses, clicks, and waits interleaved with screenshots and state reads to verify that game mechanics like movement, jumping, and scoring function correctly.
Instructions
Loads a game HTML file and executes a script of inputs (key presses/holds, clicks, waits) interleaved with screenshots and state reads, so you can VERIFY the gameplay you wrote actually works: does the player move, jump, collide, score? Games should expose window.__state = () => ({...}) for read_state assertions. Always playtest after building or changing game mechanics — a game that renders is not a game that plays.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file_path | Yes | Absolute path to the game's .html entry file | |
| script | Yes | Playtest script, executed in order. Take screenshots and read_state between actions to verify the gameplay actually works. | |
| format | No | jpeg | |
| width | No | Viewport width in px | |
| height | No | Viewport height in px | |
| settle_frames | No | requestAnimationFrame frames to wait after load before capturing | |
| extra_wait_ms | No | Extra fixed wait after settling, for slow async scenes | |
| timeout_ms | No | Hard cap for the whole operation |