MergeShip2 -- Ocarina of Time and Majora's Mask in one game
===========================================================

Ship of Harkinian (Ocarina of Time) and 2 Ship 2 Harkinian (Majora's Mask) running together in
one program (mergeship.exe). Walk from Hyrule into Termina and back; your items, songs and masks
come with you, and Majora's Mask's transformation masks work in Hyrule.

Build: 1.0.4 (2026-11-12; mergeship 5612ddf, Shipwright 1925c056f, 2ship2harkinian 672f9c2c2)

What you need
-------------
  - Windows 10/11, 64-bit.
  - Your own ROMs (none are included):
      * The Legend of Zelda: Ocarina of Time -- any version Ship of Harkinian supports
        (e.g. NTSC 1.0 / PAL GameCube / Master Quest), as .z64 / .n64 / .v64.
      * The Legend of Zelda: Majora's Mask -- US 1.0 (N64) or US GameCube, as .z64 / .n64 / .v64.

First run
---------
  1. Unzip this folder anywhere you can write to (not Program Files).
  2. Run mergeship.exe.
  3. "No O2R Files ... Generate one now?" -> Yes -> choose your Ocarina of Time ROM.
  4. "Majora's Mask ROM ... Select your Majora's Mask ROM now?" -> Select ROM -> choose your MM ROM.
  5. Wait for both extractions (a few minutes). oot.o2r and mm.o2r are created next to the exe.
     Later launches skip this.

Playing
-------
  - Start (or load) a file in Ocarina of Time. Termina is reached through the Lost Woods; the
    Clock Tower passage in Clock Town brings you back.
  - Every MergeShip feature is optional: the port menu (Esc or F1) > Mergeship; in Termina,
    2Ship's menu > Mergeship.
  - Pause menu: C-Up switches between the Hyrule and Termina versions of a page.
  - Randomizer: SoH's Randomizer menu > Mergeship tab -> "Unified Randomizer" makes one seed over
    both worlds (Termina: Shuffle, Termina: Dungeon Items, entrance shuffle, goals, hints).
  - Anchor (online co-op) uses one connection for both worlds.
  - Singleplayer Mode (Mergeship > Singleplayer, never on randomizer files): the Happy Mask Salesman
    travels Hyrule selling Majora's Mask's masks (and keeps his shop in Castle Town); beating Ganon
    returns Link to the Temple of Time as a child with Navi, and Termina opens after that -- as
    New Game Plus, with Navi at Link's side in place of Tatl.

Files
-----
  mergeship.exe            the program
  soh.dll, 2ship.dll       the two games
  libultraship.dll, SDL2.dll
  soh.o2r, mergeship2.o2r, 2ship.o2r   the ports' own assets (fonts, textures, MergeShip content)
  assets\                  what the first run needs to extract your ROMs
  created at run time:     oot.o2r, mm.o2r, shipofharkinian.json, 2ship2harkinian.json,
                           Save\ (Hyrule saves + the shared save), saves\ (Termina saves),
                           Randomizer\ (seeds), logs\

Known issues
------------
  - Each game's items are its own (the unified randomizer's default): an Ocarina of Time item shows on
    Ocarina of Time's pages and a Majora's Mask item on Majora's Mask's, in both worlds, and both work in
    both worlds. Hearts, magic, rupees and ammo (bombs, bombchus, sticks, nuts, arrows) are one shared pool
    across both games, and with Anchor across the team.
  - New swords and shields are not put on when you get them (Mergeship menu: "Don't Auto-Equip New Swords and
    Shields", on by default); equip them from the pause menu.
  - With the seed's Bombchu Bag on, Termina's bombchus come only with the bag; packs of chus refill after that.
  - Start a new file for each new build (a file from an older build can carry older item data).
  - Report problems with the logs\ folder and, for a crash, the .dmp file in it.

Licenses: see licenses\. Ocarina of Time and Majora's Mask are (c) Nintendo; this program contains
no Nintendo assets and needs your own copies of the games.
