A PC port of OoT allowing you to enjoy the game with modern controls, widescreen, high-resolution, gyroscopy and other great features! Setup is simple, let's get started!
The Ship does not include assets and as such requires a prior copy of the game to play.
- Download The Ship of Harkinian from Discord.
- Requires a supported copy of the game (See supported games below).
- Use the OTRGui to generate an
oot.otrarchive file. - Launch
soh.exe
Currently the recommended option
Build team: `zelda@srd022j`
Build date: `03-02-21 00:49:18` (year-month-day)
sha1: cee6bc3c2a634b41728f2af8da54d9bf8cc14099
May lead to crashes and instability
sha1: 0227d7c0074f2d0ac935631990da8ec5914597b4
Build team: `zelda@srd022j`
Build date: `03-02-21 00:16:31` (year-month-day)
sha1: 079b855b943d6ad8bd1eb026c0ed169ecbdac7da (Produced by decomp)
sha1: 50bebedad9e0f10746a52b07239e47fa6c284d03 (Alternate)
Congratulations, you are now sailing with the Ship of Harkinian! Have fun!
The Ship of Harkinian uses a proprietary versioning system consisting of a sci-fi film character followed by a phonetic alphabet code word. The film character represents a major release version which increments with the addition of many new features and bug fixes. The code word represents a minor release version which increments with small updates mainly comprised of bug fixes. For example, DECKARD ALFA.
- Open OTRGui.exe, and select one of the supported roms listed above, to generate the
oot.otrarchive file. - If a second button already exits then
oot.otralready exists. To prevent overwriting the oldoot.otruse this button to choose a new game directory. The new directory must not already contain anoot.otrto prevent an error. - When the process completes, place
oot.otrbesidesoh.exeif it is not already.
This packaging process can take up to 5 minutes.
Close the OTRGui when the Done! message appears.
If you get another message, then you might have selected the wrong rom. Make sure to use a rom consistent with the above checksum.
- Place one of the supported roms in the same folder as the appimage.
- When you run the soh appimage, it should begin generating the
oot.otrarchive file. - When the process completes, place
oot.otrin the same folder as the appimage, if it is not already, then run the appimage.
The packaging process can take up to 5 minutes.
If you get any errors, then you might have selected the wrong rom. Make sure to use a rom consistent with the above checksum.
- Run
soh.app, and when prompted, select one of the supported roms listed above. - You should see a notification saying
Processing OTR, then, once the process is complete, you should get a notification sayingOTR Successfully Generated, then the game should start.
The packing process can take up to 5 minutes.
If you get an error saying Incompatible ROM hash, you have selected the wrong rom, make sure the checksum matches one of the ones listed above.
- Download the latest PC release of the Ship of Harkinian, and follow the instructions above for generating the
oot.otrarchive on that platform. - Place the
.nroand theoot.otrarchive into a folder calledsohin your Switch folder on your Switch
- Download the latest PC release of the Ship of Harkinian, and follow the instructions above for generating the
oot.otrarchive on that platform. - Copy the
.rpxand theoot.otrarchive towiiu/apps/soh
If you still cannot get the tool to work, join our Discord Server and ask for help in the #support text channel. Keep-in-mind that we do not condone piracy in any way.
Launch the game. If the window immediately closes, or if there are visual artifacts, you may have selected the wrong rom in the OTRGui tool.
Default keyboard configuration:
| N64 | A | B | Z | Start | Analog stick | C buttons | D-Pad |
|---|---|---|---|---|---|---|---|
| Keyboard | X | C | Z | Space | WASD | Arrow keys | TFGH |
Other shortcuts:
| Keys | Action |
|---|---|
| F1 | Toggle menubar |
| F5 | Save state |
| F6 | Change state |
| F7 | Load state |
| F10 | Fullscreen (OpenGL) |
| Alt+Enter | Fullscreen (DirectX) |
| Ctrl+R | Reset |
Currently, DirectX 11 and OpenGL are supported. Change the renderer by opening the shipofharkinian.json configuration file in notepad and add sdl to the quotes in "GfxBackend": "" for OpenGL or leave blank for DirectX.
Want to use cartridge readers in tandem with the OTRGui? Take this survey to increase chances of this becoming reality.
Official Discord: https://discord.com/invite/BtBmd55HVH
Refer to the building instructions to compile SoH.
The CI works via Github Actions where we mostly make use of machines hosted by Github; except for the very first step of the CI process called "Extract assets". This steps extracts assets from the game file and generates an "assets" folder in soh/.
To get this step working on your fork, you'll need to add a machine to your own repository as a self-hosted runner via "Settings > Actions > Runners" in your repository settings. If you're on macOS or Linux take a look at macports-deps.txt or apt-deps.txt to see the dependencies expected to be on your machine. For Windows, deps get installed as part of the CI process. To setup your runner as a service read the docs here.
- Confirm that you have an
/assetsfolder filled with XMLs in the same directory as OTRGui.exe - Confirm that
zapd.exeexists in the/assets/extractorfolder
Nightly builds of Ship of Harkinian are available here: Windows, macOS, Linux, Switch, Wii U
Kenix | Lead Developer/Public Relations - Resource Management Programmer, Audio System Programmer, and General Programmer
Jack Walker | Lead Developer - OTR Format Programmer, Resource Load Programmer, and General Programmer
Louist103 | Developer - Save System Programmer and General Programmer
Emil | Developer - Fast3D Programmer
m4xw | Developer - Shipwright, Throwing Baguettes, and General Programmer
MelonSpeedruns | Developer - General Programmer
Rozlette | Developer - General Programmer
JoshDuMan | Developer - General Programmer
KiritoDev/Lywx | Developer - General Programmer
Theo3 | Developer - General Programmer
Random06457 | Developer - Linux Build
Decomp & ZAPD | Made this project even possible in the first place!
MNGoldenEagle | Patiently explained audio data formats, encouragement, and founding ZSO which was the first source of the game's code and resource format documentation.
Rrrrry123 | Speedbunner, encouragement, and community moderation
Fierce deity | Encouragement and community moderation
mzxrules | For his contributions to decomp
zel. | For his contributions to decomp
Aloxado | Developer - General Programmer
MegaMech | Developer - General Programmer
Revo | Tester - GCC support and General Testing
zfg | Tester - General Testing
Horseless Headman | Tester - General Testing
Steven Pritchett | Tester - General Testing
Trenton May | Tester - General Testing
Zeldaboy14 | Tester - General Testing, encouragement, and community moderation
Koby Howell | Tester - General Testing
Logg | Tester - General Testing
Taylor Daley | Graphic Design
Can't Sleep | Graphic Design
Kenix | Producer / Writer
briaguya | Writer
rainbow_fash | Executive Producer
ReveriePass | Editor
MicTheMicrophone | Gwonam / The King
Amphibibro | Link
AceHeart | Zelda