base on Ship of Harkinian Android Port # Ship of Harkinian Android Port A port of Ship of Harkinian to Android. Original Repository: [HarbourMasters/Shipwright](https://github.com/HarbourMasters/Shipwright) Supported (probably): Android 4.3+ (OpenGL ES 3.0+ required) Tested On: Android 10 and Android 13 ## Installation Installation instructions: 1. Install the apk [from here](https://github.com/Waterdish/Shipwright-Android/releases). 2. Open the app once. It will generate the directory for your rom. Allow all file permissions and then close and reopen the app. 3. Select "Yes" when prompted by the app if you would like to generate an OTR. Select "Yes" when it asks to look for a rom. Navigate to your *"ZELOOTD.z64"* and select it. The extraction should start. 4. When asked if you would like to extract another rom, select "Yes" to choose another rom or select "No" to start the game. 5. It will launch straight into the game on subsequent plays. (If you would like to get the rom selection dialog back, delete the .otr files in *Android/data/com.dishii.soh/files/*) Use *Back/Select/-* controller button, or the *Android back button* (swipe left if using gesture controls) to open **Enhancements menu**. Use touch controls to navigate menus. ## FAQ **Q: Why is it immediately crashing?** A: Try deleting and re-extracting the OTR file (oot.otr). **Q: The game opened once, but now it's just a black screen.** A: Reinstall and change MSAA to 1 in Settings->Graphics **Q: I can't map the C buttons because the window is cut off.** A: Go to Settings->Graphics->ImGui Menu Scale and change it from X-Large to a smaller value. **Q: Some buttons on my controller won't map.** A: Unfortunately the only option for now is to use a different controller. Some controllers have issues with this app. **Q: My controller is not doing anything.** A: Close the Enhancements Menu. If the Enhancements Menu is not open, open it with the Android back button and check if it is detected in Settings->Controller->Controller Mapping. If it is, press refresh. **Q: Why are these changes not in the main Shipwright repository?** A: Working on it. ## Known Bugs - [Orientation Lock does not work.](https://github.com/libsdl-org/SDL/issues/6090) - Near-plane clipping when the camera is close to walls. ## Build ### Build Tools - [Ubuntu Noble Numbat | 24.04.2 LTS](https://releases.ubuntu.com/noble/) - [CMake 3.31.5](https://github.com/Kitware/CMake/releases) - [OpenJDK 17 | Java Development Kit](https://jdk.java.net/archive/) - [Android Studio Koala | 2024.1.1 Patch 2 August 8, 2024](https://developer.android.com/studio/archive) - Android SDK 31 | Android 12 - Android SDK Build-Tools 30.0.2 - Android SDK Command-Line Tools 17.0 - Android NDK 26.0.10792818 - Android Gradle Plugin (AGP) 7.0.3 **Note:** These are the tools and versions that has been tested and are supported to build the project directly. If you want to use different tools/versions, note that you would need to figure out by yourself how to setup and configure the tools/project to build with them. ### Build Instructions 1. Use a Linux base OS system (Windows build support seems to be unsupported. For Windows users, you can use WSL or a full VM). 2. Download and install OpenJDK: ```bash cd ~ wget -O openjdk.tar.gz https://download.java.net/java/GA/jdk17.0.2/dfd4a8d0985749f896bed50d7138ee7f/8/GPL/openjdk-17.0.2_linux-x64_bin.tar.gz tar -xvzf openjdk.tar.gz && rm -f openjdk.tar.gz sudo mv jdk* /opt/jdk_17 sudo rm -f /etc/profile.d/jdk.sh echo "export JAVA_HOME=/opt/jdk_17" | sudo tee /etc/profile.d/jdk.sh echo "export PATH=/opt/jdk_17/bin:\$PATH" | sudo tee -a /etc/profile.d/jdk.sh sudo chmod +x /etc/profile.d/jdk.sh source /etc/profile.d/jdk.sh ``` 3. Download and install Android Studio: ```bash cd ~ wget -O android-studio.tar.gz https://redirector.gvt1.com/edgedl/android/studio/ide-zips/2024.1.1.13/android-studio-2024.1.1.13-linux.tar.gz tar -xvzf android-studio.tar.gz && rm -f android-studio.tar.gz sudo mv android-studio /opt/android-studio sudo rm -f /usr/local/bin/android-studio sudo ln -s /opt/android-studio/bin/studio.sh /usr/local/bin/android-studio ``` 4. Execute Android Studio: ```bash android-studio ``` 5. Go to "Tools/SDK Manager" and install the next tools: - Android SDK 31 | Android 12 - Android SDK Build-Tools 30.0.2 - Android NDK 26.0.10792818 - Android SDK Command-Line Tools 17.0 - Android SDK Platform-Tools 35.0.2 - CMake 3.31.5 6. Edit the *app/build.gradle* file to point to your ndk folder. 7. Sync and Build the Project. ", Assign "at most 3 tags" to the expected json: {"id":"10548","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"