gc_rom_load
Boots a game ROM on a selected Dolphin instance or real GameCube console, using host-side paths for emulators and console-side paths for hardware.
Instructions
Boot/load a ROM on an instance.
This is the unified entry point for pointing a target at a game:
Real GameCube hardware — sends a
BOOTcommand to the console's Swiss netboot listener (TCP 4242 on the instance'sbba_ip).rom_pathmust be a console-side path (sdc:/orfsp:/, e.g.sdc:/games/Foo.iso). If the console is currently inside a game the listener is down; this first tries to return to Swiss with the A+Z+START combo (which needs hardware button pressing, not implemented yet).Raises :class:
NetbootErrorif theBOOTcommand is not answered withOK— including when the listener returns no reply at all (console mid-boot / dropped connection) or refuses the ROM (ERR <reason>).Dolphin instance — stops the current process and relaunches it booting the given host-side ROM/DOL/ELF path.
For hardware, set the console's IP with gc_hardware_update(instance_id, bba_ip='<console-ip>') before loading a ROM.
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_rom_load"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rom_path | Yes | ||
| instance_id | Yes |