Dolphin MMJR - RetroBIOS¶
Valid BIOS CRC32
ipl_ntsc:
- crc32: 6DAC1F2A, name: NTSC v1.0
- crc32: D5E6FEEA, name: NTSC v1.1
- crc32: 86573808, name: NTSC v1.2
- crc32: 667D0B64, name: MPAL v1.1 (Brazil)
ipl_pal:
- crc32: 4F319F43, name: PAL v1.0
- crc32: AD1B7F16, name: PAL v1.2
Technical notes
Android-only Dolphin fork continuing the MMJ line, published as the org.mm.jr package. The repositories it released from are gone, including the Dolphin-MMJR1 link in its own README; this reading is taken from a surviving copy that carries the release build metadata of the app, applicationId org.mm.jr and versionCode 15808. ref: Source/Android/app/build.gradle:23-29, Source/Android/app/release/output-metadata.json
Two roots. The user directory is dolphin-mmjr at the root of external storage. The Sys directory is extracted from the APK assets into the app's internal files directory, and the first run after a versionCode change deletes it and extracts it again, so nothing placed there survives an update. Paths below are relative to the user directory; entries with no path are read only from the Sys directory and name their location in their note. ref: Source/Android/app/src/main/java/org/dolphinemu/dolphinemu/utils/DirectoryInitialization.java:93-134, Source/Core/Common/CommonPaths.h:22-24, Source/Core/Common/FileUtil.cpp:756-807
The GameCube boot ROM is looked up as GC/
Fonts follow the IPL. When a dump is present the Shift JIS and Windows-1252 fonts are read out of it at offsets 0x1aff00 and 0x1fcf00, for 0x4a24d and 0x2575 bytes; otherwise the standalone font files are loaded whole, and the bundled ones have different padding from the console fonts. ref: Source/Core/Core/HW/EXI/EXI_DeviceIPL.cpp:99-127, Source/Core/Core/HW/EXI/EXI_DeviceIPL.cpp:159-172, Source/Core/Core/HW/EXI/EXI_DeviceIPL.cpp:199-240
DSP HLE is the default and reads dsp_coef.bin alone, for polyphase resampling coefficients, skipping any file that is not 0x1000 bytes. DSP LLE, reached by setting DSPHLE to False in Dolphin.ini, loads both ROMs from GC/ in the user directory then Sys/GC/, rejects either at the wrong size and refuses to start when one is missing. Both are byte-swapped into memory and the pair is then hashed with adler32 against six known combinations. ref: Source/Core/Core/HW/DSPLLE/DSPLLE.cpp:120-138, Source/Core/Core/HW/DSPLLE/DSPLLE.cpp:140-176, Source/Core/Core/HW/DSPHLE/UCodes/AX.cpp:45-58, Source/Core/Core/DSP/DSPCore.cpp:38-105, Source/Core/Core/HW/DSP.cpp:190
Wii emulation reads keys.bin from the NAND root every time the key store is built, and keeps the built-in keys when it is absent. SYSCONF is read through the emulated filesystem and rebuilt unless it is exactly 0x4000 bytes, setting.txt is read for its serial number then deleted and written again, and the WiiConnect24 files shipped in Sys/Wii are copied into the NAND without overwriting what is there. A missing SD card image is created at 128 MB. ref: Source/Core/Core/IOS/IOSC.cpp:94, Source/Core/Core/IOS/IOSC.cpp:136-140, Source/Core/Core/IOS/IOSC.cpp:559-584, Source/Core/Core/SysConf.cpp:55-66, Source/Core/Core/Boot/Boot_BS2Emu.cpp:228-256, Source/Core/Core/WiiRoot.cpp:217-227, Source/Core/Core/IOS/SDIO/SDIOSlot0.cpp:60-79
Every boot looks for a symbol map named after the running game ID, in Maps/ then Sys/Maps/, and reloads it whenever the running title changes. The game ID comes from the disc metadata, not from a debugger setting. ref: Source/Core/Core/Boot/Boot.cpp:253-290, Source/Core/Core/ConfigManager.cpp:698-720, Source/Core/Core/ConfigManager.cpp:742-754
16 files | 0 required, 16 optional | 15 in repo, 1 missing | 11 with HLE fallback
IPL.bin optional in repo HLE fallback north-america
GameCube boot ROM, NTSC-U directory
- Path:
GC/USA/IPL.bin - System: nintendo-gamecube
- Size: 2.0 MB
- Validation: crc32
- Source:
Source/Core/Core/ConfigManager.cpp:861-868,Source/Core/Core/HW/EXI/EXI_DeviceIPL.cpp:99-112,Source/Core/Core/HW/EXI/EXI_DeviceIPL.h:43,Source/Core/Core/Boot/Boot.cpp:296-330 - Platforms: batocera, emudeck, lakka, recalbox, retroarch, retropie, rocknix
- Read whole into a 2 MiB buffer with no size check, then descrambled from 0x100 for 0x1afe00 bytes. The crc32 gate runs when the IPL itself is booted, and the four non-PAL dumps pass here without complaint.
IPL.bin optional in repo HLE fallback europe
GameCube boot ROM, PAL directory
- Path:
GC/EUR/IPL.bin - System: nintendo-gamecube
- Size: 2.0 MB
- Validation: crc32
- Source:
Source/Core/Core/ConfigManager.cpp:835-849,Source/Core/Core/Boot/Boot.cpp:298-337 - Platforms: batocera, emudeck, lakka, recalbox, retroarch, retropie, rocknix
- The two PAL dumps are the ones this directory takes without a mismatch warning.
IPL.bin optional in repo HLE fallback japan
GameCube boot ROM, NTSC-J directory
- Path:
GC/JAP/IPL.bin - System: nintendo-gamecube
- Size: 2.0 MB
- Validation: crc32
- Source:
Source/Core/Common/CommonPaths.h:32-34,Source/Core/Core/HW/EXI/EXI_DeviceIPL.cpp:174-186 - Platforms: batocera, emudeck, lakka, recalbox, retroarch, retropie, rocknix
- JAP is the only Japanese directory name this fork knows. FindIPLDump, which serves the font path, scans USA then EUR then JAP and stops at the first hit.
font_western.bin optional in repo HLE fallback
Windows-1252 font, loaded at 0x1fcf00
- Source:
Source/Core/Common/CommonPaths.h:105,Source/Core/Core/HW/EXI/EXI_DeviceIPL.cpp:126,Source/Core/Core/HW/EXI/EXI_DeviceIPL.cpp:199-240 - Platforms: lakka, retroarch, retropie
- Read from GC/ in the Sys directory, with no user directory fallback. Skipped in favour of the IPL dump whenever one is found.
font_japanese.bin optional in repo HLE fallback
Shift JIS font, loaded at 0x1aff00
- Source:
Source/Core/Common/CommonPaths.h:106,Source/Core/Core/HW/EXI/EXI_DeviceIPL.cpp:125,Source/Core/Core/HW/EXI/EXI_DeviceIPL.cpp:199-240 - Platforms: lakka, retroarch, retropie
- Read from GC/ in the Sys directory, with no user directory fallback. Skipped in favour of the IPL dump whenever one is found.
dsp_rom.bin optional in repo HLE fallback
DSP instruction ROM
- Path:
GC/dsp_rom.bin - Size: 8.0 KB
- Adler32:
0x66f334fe - Validation: size
- Source:
Source/Core/Common/CommonPaths.h:108,Source/Core/Core/HW/DSPLLE/DSPLLE.cpp:120-152,Source/Core/Core/DSP/DSPCore.h:35,Source/Core/Core/DSP/DSPCore.cpp:38-80 - Platforms: lakka, retroarch, retropie
- DSP LLE only, and LLE aborts when the file is absent or not 8192 bytes. The adler32 is taken over the byte-swapped image and the value here is the Nintendo pair; five replacement pairs are also accepted.
dsp_coef.bin optional in repo HLE fallback
DSP coefficient ROM
- Path:
GC/dsp_coef.bin - Size: 4.0 KB
- Adler32:
0xf3b93527 - Validation: size
- Source:
Source/Core/Common/CommonPaths.h:109,Source/Core/Core/HW/DSPLLE/DSPLLE.cpp:120-152,Source/Core/Core/HW/DSPHLE/UCodes/AX.cpp:45-70,Source/Core/Core/DSP/DSPCore.h:49 - Platforms: lakka, retroarch, retropie
- Read by DSP LLE alongside the instruction ROM, and by the AX ucode under HLE for polyphase resampling, which drops any file that is not 0x1000 bytes and plays on without it.
codehandler.bin optional in repo
Gecko code handler
- Source:
Source/Core/Common/CommonPaths.h:124,Source/Core/Core/GeckoCode.cpp:121-136 - Platforms: lakka, retroarch, retropie
- Read from the root of the Sys directory when cheats are enabled, and written into guest memory between the installer bounds; too large a file is refused and cheats stay off.
keys.bin optional in repo HLE fallback
BootMii key dump, console keys and identity
- Path:
Wii/keys.bin - System: nintendo-wii
- Size: 1.0 KB
- Validation: size
- Source:
Source/Core/Core/IOS/IOSC.cpp:94,Source/Core/Core/IOS/IOSC.cpp:136-140,Source/Core/Core/IOS/IOSC.cpp:559-584 - Read at every key store construction, so on every Wii title. Supplies the console private key and signature, the MS and CA identifiers, the NAND key and HMAC and the backup key. A short read leaves the built-in keys in place, the structure being fixed at 0x400 bytes.
SYSCONF optional in repo HLE fallback
Wii system configuration
- Path:
Wii/shared2/sys/SYSCONF - System: nintendo-wii
- Size: 16.0 KB
- Validation: size
- Source:
Source/Core/Common/CommonPaths.h:90,Source/Core/Core/SysConf.cpp:20,Source/Core/Core/SysConf.cpp:55-66 - Opened through the emulated filesystem and accepted only at 0x4000 bytes; anything else is replaced by a freshly generated one.
setting.txt optional in repo HLE fallback
Wii region and language settings
- Path:
Wii/title/00000001/00000002/data/setting.txt - System: nintendo-wii
- Size: 256 B
- Validation: size
- Source:
Source/Core/Common/CommonPaths.h:122,Source/Core/Common/SettingsHandler.h:22-27,Source/Core/Core/Boot/Boot_BS2Emu.cpp:228-256 - Read for its serial number at Wii boot, then deleted and written again from the emulated region settings. The read fills a fixed 0x100 byte buffer, so a shorter file yields nothing.
sd.raw optional in repo HLE fallback
Wii SD card image
- Path:
Wii/sd.raw - System: nintendo-wii
- Source:
Source/Core/Common/CommonPaths.h:119,Source/Core/Common/FileUtil.cpp:802,Source/Core/Core/IOS/SDIO/SDIOSlot0.cpp:60-79 - Opened read-write when the SD device is opened; a 128 MB image is created when the file is missing.
wiitdb.txt optional in repo
user title database
- Path:
Load/wiitdb.txt - Aliases:
titles.txt - Source:
Source/Core/Core/TitleDatabase.cpp:26-48,Source/Core/Core/TitleDatabase.cpp:50-63,Source/Core/Core/TitleDatabase.cpp:86-94 - One title id equals name pair per line, ids of four characters and up. titles.txt is read only when wiitdb.txt yields nothing. Overlays the per-language databases shipped in the Sys directory.
mios-ipl.map optional missing
MIOS symbol map
- Path:
Maps/mios-ipl.map - Source:
Source/Core/Core/IOS/MIOS.cpp:47,Source/Core/Core/IOS/MIOS.cpp:55-66 - Read from Maps/ in the user directory when MIOS starts, and a successful load re-applies the HLE function patches against the symbols it names.
GFZE01.map optional in repo
symbol map for game id GFZE01
- Source:
Source/Core/Core/Boot/Boot.cpp:253-290 - Reached by the per-title lookup, which reads Maps/
.map from the user directory then the Sys directory. Ships in Maps/ inside the Sys directory.
GMBE8P.map optional in repo
symbol map for game id GMBE8P
- Source:
Source/Core/Core/Boot/Boot.cpp:253-290 - Reached by the per-title lookup, which reads Maps/
.map from the user directory then the Sys directory. Ships in Maps/ inside the Sys directory.
Generated on 2026-08-23T16:12:06Z