SplitScript reference / GCN
GCN
state provider
state GCNAttaches to a supported Nintendo GameCube emulator.
The provider discovers the console's 24 MiB MEM1 mapping and exposes original GameCube addresses through the read-only gcn value of type GCNEmulator. Multi-byte values are decoded using the console's big-endian byte order. It owns discovery for Dolphin and 64-bit RetroArch using dolphin_libretro.dll. Declare guest addresses directly instead of recreating Dolphin mappings, DeepPointer chains, or byte swapping.
Examples
Read GameCube memory
state GCN {
room: u16 at 0x80001000
}Value type
| Member | Description | Available through |
|---|---|---|
| GCNEmulator | Retains a discovered Nintendo GameCube MEM1 mapping. |
Mapping lifecycle
The provider validates its private memory mapping before each state poll. If that mapping disappears while the host process remains open, the current logical attachment ends: attachment-scoped state and pending continuations are cleared, and onDetach runs if onAttach had completed. Discovery then continues cooperatively against the same host process. A replacement mapping starts a new attachment, runs onAttach again, and establishes a fresh old / current baseline.