Jump to content
Setting up an AI agent? ReverseEngineering.wiki skill (works from the command line, no configuration): https://reverseengineering.wiki/skill/rewiki/SKILL.md · setup for every client, including MCP: https://reverseengineering.wiki/llms.txt · REWiki:Connect

Format:Virtual Boy ROM image

From ReverseEngineering.wiki
Format
Extensions .vb, .vboy
Endianness little
On this wiki Facts · Code · Notes · Topics

Raw cartridge dump of the Nintendo Virtual Boy (.vb, .vboy): a power-of-two sized ROM (256 bytes to 16 MiB) mapped at 0x07000000, with the game header in the last 544 bytes, the reset code at the very end and the NEC V810 reset vector at 0xFFFFFFF0.

Image and mapping

The file is the cartridge ROM only. Beetle VB (libretro.cpp, Load) accepts files whose size is a power of two, at least 256 bytes and at most 16 MiB (1 << 24); it maps the ROM into the 0x07000000 region (the CPU address space repeats every 128 MiB, A &= (1 << 27) - 1), and ROMs smaller than 64 KiB are mirrored up to 64 KiB. Because the last bytes of the 16 MiB window hold the reset vector (CPU reset address 0xFFFFFFF0 in v810_cpu.cpp) and the header, a ROM smaller than 16 MiB repeats so that its end appears at the end of the window.

Header

The header is at the end of the ROM, at CPU address 0xFFFFFDE0 (ROM offset size - 0x220). Unverified: layout from the Virtual Boy documentation (Sacred Tech Scroll), not read in code here.

ROM offset from header Size Field
+0x00 20 game title (ASCII or Shift-JIS)
+0x14 5 reserved
+0x19 2 maker code (ASCII)
+0x1B 4 game code
+0x1F 1 version

Beetle VB declares the same field set in struct VB_HeaderInfo (title, game_code u32, manf_code u16, version u8) but the parsing is absent in the libretro port; Virtual Boy emulators otherwise do not check the header.

Vectors

Unverified: interrupt and exception vectors (game pad, timer, game pak, link, VIP, FPU, illegal opcode, address trap) live at fixed addresses 0xFFFFFE00-0xFFFFFFF0 inside the last 512 bytes of the ROM.

Related

Platform:Virtual Boy.

Code & repositories

  • https://github.com/libretro/beetle-vb-libretro @ d5ae54c8e23b573a3b34e888b2d48a588027e92c · license: GPL-2.0 (declared by the contributor; GitHub's detector did not recognize COPYING)
    Mednafen Virtual Boy core: V810 CPU, bus decode, ROM/RAM mapping
    Tested on: source read, not run: read the source, not built · checked 2026-10-18