gc_instance_start
Starts a new Dolphin emulator instance and boots a specified GameCube ROM, DOL, or ELF file with configurable controller, video, BBA, and resolution settings.
Instructions
Start a new Dolphin instance booting the given ROM/DOL/ELF.
Args: instance_id: Unique id for the instance. rom_path: Path to a .iso/.gcm/.dol/.elf file. controller_ports: Which GameCube ports (0-3) get a controller (default [0]). bba_mode: Broadband Adapter mode: ipc, hle, xlink, tap, tapserver, modem, or None/empty to disable. bba_mac: MAC address for the BBA (must start with 00:09:bf or 00:17:ab). video_backend: OGL, Vulkan, Null, or Software Renderer. capture_backend: auto, xvfb, or framedump. memory_backend: process_vm or dolphin_engine. internal_resolution: 1x/2x/... internal resolution. native_resolution: GameCube native framebuffer "WxH" (default 640x480). gpu_accel: auto/none/software/vgl/vgl-egl/vgl-glx (default auto). extra_core: Extra Dolphin.ini [Core] overrides. boot_ipl: Boot the original GameCube IPL (disable "Skip System Menu"), so the boot logo/menu runs before the disc. Only meaningful for a GameCube disc ('.iso'/'.gcm'); requires the server to be configured with a GC_MCP_IPL_DIR folder containing /IPL.bin files (see gc_server_info). Errors if IPL boot is requested but no IPL folder/files are configured. info: Free-form description/annotation shown in list and status output.
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": {
"instance_id": "<instance_id>",
"rom_path": "<rom_path>"
},
"name": "gc_instance_start"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| info | No | ||
| bba_mac | No | ||
| bba_mode | No | ||
| boot_ipl | No | ||
| rom_path | Yes | ||
| gpu_accel | No | ||
| extra_core | No | ||
| instance_id | Yes | ||
| video_backend | No | ||
| memory_backend | No | ||
| capture_backend | No | ||
| controller_ports | No | ||
| native_resolution | No | ||
| internal_resolution | No |