search

Waterdish / 2ship2harkinian-Android

Creative Commons Zero v1.0 Universal
148 stars 2 forks source link

readme

2 Ship 2 Harkinian Android Port

A port of 2 Ship 2 Harkinian to Android.

Original Repository: https://github.com/HarbourMasters/2ship2harkinian

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

Supported (probably): Android 7+ (OpenGL ES 3.0+ required)
Tested On: Android 14

Installation:

  1. Install the apk from here: https://github.com/Waterdish/2ship2harkinian-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 O2R. Select "Yes" when it asks to look for a rom. Navigate to your "MM.z64" and select it. The extraction should start.
  4. It will launch straight into the game on subsequent plays.

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: Where do I add mods?
A: Android/data/com.dishii.mm/files

Q: Why is it immediately crashing?
A: Try deleting and re-extracting the O2R file (mm.o2r).

Q: The game opened once, but now it's just a black screen.
A: Reinstall and don't raise MSAA above 1 in Settings->Graphics

Q: The GUI scaling is too big/too small.
A: There is no GUI scaling option implemented yet. This will come in a future update.

Q: Gyro Aim?
A: It will come once it works in the base 2 Ship 2 Harkinian.

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.

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.
Picto box images render black.

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.