SplitScript reference / GBA
GBA
state provider
state GBA
Attaches to a supported Game Boy Advance emulator.
The provider discovers emulated EWRAM and IWRAM and exposes original GBA hardware addresses through the read-only value introduced by GBA. It owns discovery for VisualBoyAdvance and VBA-M, mGBA, NO$GBA, Mednafen, supported RetroArch cores, and mGBA-based BizHawk. Declare guest addresses directly instead of recreating emulator-specific DeepPointer mappings.
Examples
Read GBA work RAM
state GBA {
room: u8 at 0x03000010
}
Value type
| Member | Description | Available through |
|---|---|---|
| GBAEmulator | Retains a discovered GBA emulator memory 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.