Press or release a button
control_emulatorPress or release OpalEmu controller buttons to register input, advance gameplay, and return a PNG screenshot; use down/up states to hold directions across frame skips.
Instructions
Presses or releases a controller button. The emulator briefly resumes just long enough for the input to register, then pauses again and returns a PNG screenshot. This advances the game and may affect progress. To hold a direction across skip_frames calls, send state="down" once and state="up" later.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"button": "<button>",
"state": "<state>"
},
"name": "control_emulator"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| state | Yes | "down" to press, "up" to release. | |
| button | Yes | Button to press/release. | |
| player | No | Controller port, 0-indexed. Defaults to player 1. |