What is browser Play?

A self-contained pixel adventure. No upload, no ROM file expected — press Start and go.

What does Emerald education mode track?

Onboarding milestones from emulator debug summaries: wake in the truck, Littleroot Town, Route 101, rescue Professor Birch, acquire a starter.

Liz — scratch-built Rust GBA emulator prototype. More at https://lizliz.xyz.

Handheld plastic · native Emerald route

vibe-gba

A scratch-built Game Boy Advance emulator prototype that proves the Emerald onboarding path — then lets you play a self-contained Route 101 adventure in the browser.

Play in browser GitHub repo Tester loop

ROM shelf — empty on purpose

No ROMs here. Bring your own legal ROM.

vibe-gba does not include ROMs, save files, BIOS dumps, or emulator state snapshots. This page is not a ROM library and will never ship one.

Browser Play — a self-contained pixel adventure. No upload, no ROM file expected. Press Start and go.
Local Rust track — headless research against a legal ROM (.gba) you already own.

Play without a ROM Run locally with your ROM

What works now

Loads user-provided .gba or zipped .gba files locally.
Runs deterministic headless frames with scripted input.
Captures screenshots, save states, and debug summaries.
Reaches Emerald onboarding milestones from native KEYINPUT.

New layer

The first Emerald education objective mode parses emulator debug summaries and tracks onboarding objectives:

Wake up in the moving truck.
Reach Littleroot Town.
Reach Route 101.
Rescue Professor Birch.
Acquire a starter.

Pokémon Emerald rendered at the Littleroot entry milestone — Littleroot entry milestone.

Pokémon Emerald rendered while walking through Littleroot — Native movement through Littleroot.

test-driven development starts here

Tester loop

When you test, send feedback in this exact shape so I can turn it into a failing test before touching production code:

What broke: the visible bug or wrong behavior.
What you expected: the behavior you think should happen instead.
What evidence you captured: screenshot, command output, browser URL, or reproduction steps.

cargo run -- /path/to/Pokemon\ Emerald.gba --frames 65200 --edu-mode --dump-state

Straight answers

FAQ

Does vibe-gba include ROMs?: No. It does not ship ROMs, save files, BIOS dumps, or emulator state snapshots. Bring your own legal ROM.
What is browser Play?: A self-contained pixel adventure. No upload, no ROM file expected — press Start and go.
What does Emerald education mode track?: Onboarding milestones from emulator debug summaries: wake in the truck, Littleroot Town, Route 101, rescue Professor Birch, acquire a starter.
Who makes vibe-gba?: Liz — scratch-built Rust GBA emulator prototype. More at lizliz.xyz.