2 Ship 2 Harkinian
2 Ship 2 Harkinian emulates The Legend of Zelda: Majora's Mask. It reads 2 files, 1 of them required: without a required file it does not start games.
About this profile
Technical notes
PC port of The Legend of Zelda: Majora's Mask built on the decompilation, by HarbourMasters. The game runs from assets extracted out of the user's N64 or GameCube Collector's Edition ROM into mm.o2r, plus the port's own archive 2ship.o2r, on the libultraship runtime. ZAPDTR and OTRExporter perform the extraction inside the executable.
RetroBat installs the 5.0.1 release ("Battler Bravo"): its 2ship.7z carries the 2ship.exe, 2ship.o2r, gamecontrollerdb.txt and assets tree of 2Ship-Battler-Bravo-Win64.zip byte for byte, so the profile is pinned to the 5.0.1 tag. Its launcher passes the ROM on the command line when mm.o2r is absent (only a .z64, .n64 or .v64 file, else it copies the ROM beside the executable), and deletes mm.o2r first when the major version stored in it differs from the one in 2ship.o2r, so the archive is regenerated. ref: emulatorLauncher Generators/PortsLauncher.Configuration.cs:1528-1564
Startup:
- 2ship.o2r is located in the application directories and its stored
port version must equal the build in major, minor and patch. A
missing or outdated 2ship.o2r shows an error and exits
(
mm/2s2h/BenPort.cpp:149-153,345-370). - mm.o2r is regenerated when its stored major version differs from the
build (
mm/2s2h/BenPort.cpp:282,958-960). - Without mm.o2r a ROM given on the command line is extracted.
Otherwise .z64, .n64 and .v64 files in the install and data folders
are offered, then a file dialog. With no mm.o2r at the end the port
shows an error and exits (
mm/2s2h/BenPort.cpp:447-540). - mm.o2r is added to the archive manager (
mm/2s2h/BenPort.cpp:612-616). A mods folder is created beside it when absent (mm/2s2h/BenPort.cpp:256-262).
ROM check: the size must be 32, 54 or 64 MiB, the data is converted to
big-endian order whatever the dump format, the word at 0x10 picks the
version (0x5354631C US 1.0, 0xB443EB08 US GC), and a CRC-32C of the whole
converted image must be 0x96F49400 or 0xBB434787. Compressed files are
refused. The extraction reads assets/xml/<version>, assets/filelists and
assets/Config_<version>.xml from the install folder, which ship with the
release (1329 files).
ref: mm/, 298-299, 307-357, 580-616,
mm/
The two SHA-1 values below are those the repository publishes for the .z64 forms of the two accepted ROMs (docs/supportedHashes.json). The code itself only checks the CRC-32C, so .n64 and .v64 dumps of the same ROMs are accepted too.
libultraship is a submodule pinned at 5.0.1 to 7cb10226e7875ec48ceec2f841d00afd84eef964. Its citations are at that revision.
2 files: 1 required, 1 optional. 2 more files come with the app.
By kind: 4 game data.
In this collection: 0 in repo, 0 missing and 2 unsourceable.
Game data
Section titled “Game data”mm.us.rev1.rom.z64 required unsourceable game data
The Legend of Zelda: Majora's Mask (USA) N64 ROM
- System: The Legend of Zelda: Majora's Mask
- Size: 32.0 MB
- SHA1:
d6133ace5afaa0882cf214cf88daba39e266c078 - Source:
mm/,2s2h/ Extractor/ Extract.cpp:54 mm/,2s2h/ Extractor/ Extract.cpp:63-66 mm/,2s2h/ Extractor/ Extract.cpp:307-317 docs/supportedHashes.json:2-5
- No file name is fixed. Picked from the install folder, a file dialog or the command line. Read only to build mm.o2r, which is used from then on.
- Not collectable: retail ROM the collection does not hold, and a same-named dump of another game must not stand in (acknowledged gaps)
mm.us.gc.rom.z64 optional unsourceable game data
The Legend of Zelda: Majora's Mask (USA) ROM from the GameCube Collector's Edition
- System: The Legend of Zelda: Majora's Mask
- SHA1:
9743aa026e9269b339eb0e3044cd5830a440c1fd - Source:
mm/,2s2h/ Extractor/ Extract.cpp:55 mm/,2s2h/ Extractor/ Extract.cpp:63-66 mm/,2s2h/ Extractor/ Extract.cpp:307-317 docs/supportedHashes.json:6-9
- Accepted in place of the N64 ROM and extracted to the same mm.o2r with the GC_US asset tables.
- Not collectable: retail ROM the collection does not hold, and a same-named dump of another game must not stand in (acknowledged gaps)
Comes with the app
Section titled “Comes with the app”2ship.o2r comes with the app game data
Port archive: shaders, textures and data added by the port
- Path:
2ship/2ship.o2r - System: The Legend of Zelda: Majora's Mask
- Size: 1.1 MB
- SHA1:
f9baf625f5fbedf98470a0acee4958ceb0d55f41 - MD5:
1e05eb39b5d76e1b5476ab7c2456f979 - Source:
mm/2s2h/BenPort.cpp:149-153,mm/2s2h/BenPort.cpp:345-370
- Its stored version must equal the executable's, so only the copy from the same release works. Hash of the copy in 2Ship-Battler-Bravo-Win64.zip.
- Not collectable: ships inside the 2 Ship 2 Harkinian release, and the collection does not hold it (acknowledged gaps)
gamecontrollerdb.txt comes with the app game data
SDL game controller mapping database
- Path:
2ship/gamecontrollerdb.txt - System: The Legend of Zelda: Majora's Mask
- Size: 589.3 KB
- SHA1:
cb03bd16cd6cf008478681e5c9fc5a2689b1e5e4 - MD5:
3155b5fd0be37137f422c3c0f032c13f - Source:
libultraship src/ship/ Context.cpp:277-283
- A load failure is logged and SDL keeps its built-in mappings. Hash of the copy in 2Ship-Battler-Bravo-Win64.zip.
- Not collectable: ships inside the 2 Ship 2 Harkinian release, and other revisions under the same name must not stand in (acknowledged gaps)
Next steps
Section titled “Next steps”- Get your files, for the setup you play on
- Every system, and the files each one needs
- When a game does not start