V-Rally 3 + SeedSigner 0.8.7 (personal variant v0.1.0)
Pi Zero v1.3 / SeedSigner Plus HAT / landscape 320x240

FLASH FILE
output/seedsigner-v0.8.7-vrally3-v0.1.0-plus-pi0.img
One flashable image contains the OS, your supplied V-Rally 3 GBA backup, gpSP
emulator and SeedSigner 0.8.7. The existing Dino images are preserved separately.

FLASH
1. Raspberry Pi Imager > operating system > Use custom.
2. Select the V-Rally image above and the intended microSD card.
3. Skip OS customization; keep write verification enabled, then write.
4. Flashing erases the selected card. Eject, insert in the Pi, then power on.

CONTROLS
Use automatic transmission in the game options.
D-pad LEFT/RIGHT: steer; also navigate menus.
D-pad UP: forward drive (GBA R), plus normal UP for menu navigation.
D-pad DOWN: reverse (GBA L), plus normal DOWN for menu navigation.
Top side button KEY1: accelerate / GBA A / accept menu choices.
Middle side button KEY2: brake / GBA B / go back.
Bottom side button KEY3: START / start game or pause.
D-pad CENTER click: SELECT / change camera.
KEY1 + KEY2 together: handbrake (GBA A+B).
Hold KEY1 + KEY3 together for 2 seconds, then release EVERY button for at least
80 ms: leave the game and enter SeedSigner with its original splash.
The same shortcut is available on the visible game-error screen.
On that error screen, press the middle button KEY2 to retry the game.
SeedSigner Power > Restart returns to V-Rally with fresh volatile game data.
The shortcut changes the interface; it is not authentication.

IMAGE DETAILS
The official SeedSigner 0.8.7 Pi0 kernel, firmware, device trees and application
files remain unchanged. The Plus display settings and proven Python ST7789/GPIO
hardware owner are retained. The gpSP ARMv6 core and its open GBA BIOS are retained.
Game simulation uses the GBA clock; LCD presentation may omit intermediate frames.
The 240x160 game is nearest-scaled to 320x213, centered on the 320x240 panel.
Game saves, progress and high scores are RAM-only and disappear on power-off or
restart. No game networking is enabled and no Nintendo BIOS is bundled.
Dino ROM, sprite artwork and playable Python fallback are absent in this variant.
The launcher's shared source still contains its unused Dino path for compatibility
with the separate Dino image. V-Rally startup failures stay on a visible error
screen; they do not automatically expose the signer.

VALIDATION
The image manifest and .sha256 companion identify the exact build and ROM bytes.
Packaging tests verify GBA headers, ZIP handling, source provenance, ROM readback,
unchanged official base files and deterministic rebuilds where mtools is available.
Software checks do not establish gameplay speed or physical button/display
behavior. Test boot, racing, pause, forward/reverse, handbrake, the hold/release
shortcut, signer menus and camera on your Pi. Use a disposable test seed/PSBT to
check the custom image before putting real funds at risk.
The official signature authenticates the upstream base only; additions have the
custom image checksum and bundled source provenance.

REBUILD
From the existing project checkout, after building the current ARMv6 host:
python3 scripts/build_vrally3_image.py --rom '/path/to/V-Rally 3.zip' \
  --base '../seedconsole-dualboot/downloads/seedsigner_os.0.8.7.pi0.img' \
  --output 'output/seedsigner-v0.8.7-vrally3-v0.1.0-plus-pi0.img'
The output must not already exist. A .gba file is also accepted. The source input
is read only and never copied into the tracked project payload. The builder stages
temporary game content, records its SHA256 and calls scripts/build_image.py.
Exact runtime/build sources and their hashes are included in the overlay under
/opt/dino/native/source/vrally3-native-source.tar.gz and source-manifest.json.
The gpSP source archive, GPL notices and open BIOS notices remain included.
The source archive does not contain the proprietary game; supply your own backup.

PRIVATE COPY
V-Rally 3 is proprietary. This personal image does not grant redistribution rights.
Do not publish the ROM or the complete image containing it. The reusable builder
and runtime changes can be shared independently with their respective licenses.

ROLLBACK
Reflash a previously working Dino image in output/, or reflash official SeedSigner
0.8.7 Pi0. This variant does not overwrite the existing Dino image artifacts.
