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

MemberDescriptionAvailable through
GBAEmulatorRetains 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.