Giter VIP home page Giter VIP logo

shipwright's Introduction

Welcome to the Ship of Harkinian!

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.

Quick Start

  1. Download The Ship of Harkinian from Discord.
  2. Requires an oot debug rom (not Master Quest).
Build team: `zelda@srd022j`
Build date: `03-02-21 00:49:18` (year-month-day)
sha1: cee6bc3c2a634b41728f2af8da54d9bf8cc14099
  1. Use the OTRGui to generate an oot.otr archive file.
  2. Launch soh.exe

Congratulations, you are now sailing with the Ship of Harkinian! Have fun!

Additional Setup Information

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.

The Extraction Tool

  • Open a rom to initiate generating the oot.otr archive file.
  • If a second button exists then oot.otr already exists. To prevent overwriting the old oot.otr use this button to choose a new game directory. The new directory must not already contain an oot.otr to prevent an error.
  • When the process completes, place oot.otr beside soh.exe if 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.

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.

Running The Ship of Harkinian

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.

Currently, DirectX 11 and OpenGL is supported. Change the renderer by opening the shipofharkinian.ini configuration file in notepad and add sdl to gfx backend for OpenGL or leave blank for DirectX.

Take The Survey

Want to use cartridge readers in tandem with the OTRGui? Take this survey to increase chances of this becoming reality.

Discord

Official Discord: https://discord.com/invite/BtBmd55HVH

Building The Ship of Harkinian

  1. Install Python
  2. Install Visual Studio 2022 Community Edition 2b. In the Visual Studio Installer, install MSVC v142 - VS 2019 C++.
  3. Clone the Ship of Harkinian repository.
  4. Put your 2020 OoT debug rom in the soh folder.
  5. Launch soh/fixbaserom.py.
  6. Launch soh/extract_baserom.py.
  7. Copy the baserom folder from the soh folder into the OTRExporter folder.
  8. Run OTRExporter/OTRExporter.sln.
  9. Switch the solution to Release x64.
  10. Build the solution.
  11. Launching OTRExporter/extract_assets.py will generate an oot.otr archive file in OTRExporter/oot.otr.
  12. Run soh/soh.sln
  13. Switch the solution to Release x86.
  14. Build the solution.
  15. Copy the OTRExporter/oot.otr archive file to soh/Release.
  16. Launch soh.exe.

Troubleshooting The Exporter

  • Affirm that you have an /assets folder filled with XMLs in the same directory as OTRGui.exe
  • Affirm that zapd.exe exists in the /assets/extractor folder

The Harbour Masters Are...

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

Special Thanks

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
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
MicTheMicrophone 	| Voice actor for the King
Amphibibro		| Voice actor for Link

Lemons

shipwright's People

Contributors

m4xw avatar megamech avatar kenix3 avatar kiritodv avatar maikelchan avatar melonspeedruns avatar emill avatar nestelami avatar revosucks avatar sirius902 avatar torphedo avatar kev4cards avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.