Ship of Harkinian Android Port

A port of Ship of Harkinian to Android.

Original Repository: https://github.com/HarbourMasters/Shipwright

NOTE: Controller only. No touch controls yet except for in the enhancements menu.

Supported (probably): Android 4.3+ (OpenGL ES 3.0 + required)
Tested On: Android 10 and Android 13

Installation With PC (Any Device) :

1. Install the apk from here: https://github.com/Waterdish/Shipwright-Android/releases (Use soh.storage.apk if on Android 11+ as scoped storage requires an extra permission)
2. Run this version of the PC release: https://github.com/HarbourMasters/Shipwright/actions/runs/6539782569 to generate an oot.otr and/or oot-mq.otr file. After launching the game on PC, you will be able to find these files in the same directory as soh.exe or soh.appimage. On macOS, these files can be found in /Users//Library/Application Support/com.shipofharkinian.soh/
3. Transfer the oot.otr(and oot-mq.otr if using master quest) to Android/data/com.dishii.soh/files/
4. Launch the game

Installation Without PC (Lower Compatibility):

1. Install the apk from here: https://github.com/Waterdish/Shipwright-Android/releases. Use the rompicker version if on Android 11+
2. Open the app once. It will generate the directory for your rom.
3.If using soh.apk: Place your compatible "ZELOOTD.z64" rom (check here: https://ship.equipment/) at Android/data/com.dishii.soh/files/
If using soh.storage.rompicker.apk: Select your "ZELOOTD.z64" rom wherever you have it.
4. Select "Yes" when prompted by the app if you would like to generate an OTR. Select "Yes" when it finds your rom. Your screen will go black for approximately 30 seconds. It could take longer depending on your device.
5. When asked if you would like to extract another rom, select "No" to start the game.
6. It should launch straight into the game the next time you open the app.

Use Back/Select/- controller button to open Enhancements menu. Use touch controls to navigate menus.

FAQ:

Q: Why does it say No Rom Found?
A: If you are on Android 10 or below, your rom file was not placed at Android/data/com.dishii.soh/files/. Check to make sure it is there next to soh.otr. If you are on Android 11+, generating the rom is currently broken

Q: Why is it immediately crashing?
A: Try deleting and re-extracting the OTR file (oot.otr).

Q: Why are these changes not in the main Shipwright repository?
A: Working on it.

Build Instructions:

1.Edit the app/build.gradle file to point to your ndk folder. NDK 26+ tested as working.
2.Open the project in android studio and build.