Goemon64Recomp-Android

KO | EN

gitlite — search

#monitoring #tensorflow #android #automation #ai-agent #chatgpt #vue #chatbot #cross-platform #rag

Goemon64Recomp-Android

(★ 9)

Android port of Mystical Ninja Starring Goemon via static recompilation, with RT64 Vulkan rendering. Bring your own ROM.

File Explorer

ZIP Download

- - bug_report.md
- - appimage.sh
  - Goemon64Recompiled.desktop
- - apple_bundle.cmake
  - entitlements.plist
  - fixup_bundle.cmake
  - Info.plist.in
  - ld64
  - macports.yaml
- - check-dual-src-blend.sh
  - test-dual-src-blend-guard.sh
- - android-release.yml
  - android.yml
- dependabot.yml
- - build.gradle
  - proguard-rules.pro
- build.gradle
- gradle.properties
- gradlew
- gradlew.bat
- settings.gradle
- - cheats.rml
  - controls.rml
  - debug.rml
  - driver.rml
  - general.rml
  - graphics.rml
  - mods.rml
  - saves.rml
  - sound.rml
- - Arrow.svg
  - Plus.svg
  - Quit.svg
  - RecordBorder.svg
  - Reset.svg
  - Trash.svg
  - X.svg
- - LICENSE.txt
  - promptfont.css
  - promptfont.ttf
  - README.md
- - .nvmrc
  - .stylelintrc
  - main.scss
  - package-lock.json
  - package.json
- ChiaroBold.otf
- ChiaroNormal.otf
- config_menu.rml
- config_sub_menu.rml
- goemon-clipped.svg
- InterVariable.ttf
- LatoLatin-Bold.ttf
- LatoLatin-BoldItalic.ttf
- LatoLatin-Italic.ttf
- LatoLatin-Regular.ttf
- launcher.rml
- NotoEmoji-Regular.ttf
- recomp.rcss
- rml.rcss
- - n64-goemon-input-assignment.csv
  - README.md
- - goemon_basis_verify.md
  - goemon_character_swap_re.md
  - goemon_cheats_re.md
  - goemon_critic.md
  - goemon_default_cam_writer.md
  - goemon_global_camstate.md
  - goemon_math_helpers.md
  - goemon_overlay_scan.md
  - goemon_player_pos.md
  - goemon_save_re.md
  - goemon_trace_0800037C.md
  - menu-framerate-handover.md
  - README.md
  - vulkan_device_floor.md
- - resume-stress.sh
- android-profiling-plan.md
- android-profiling-results.md
- autosave.md
- deck_gyro_1.jpg
- 128.ico
- 16.ico
- 256.ico
- 32.ico
- 512.ico
- 512.png
- 64.ico
- app.rc
- goemon_config.h
- goemon_debug.h
- goemon_game.h
- goemon_render.h
- goemon_save_rollback.h
- goemon_sound.h
- goemon_support.h
- overloaded.h
- ovl_patches.hpp
- promptfont.h
- recomp_data.h
- recomp_files.h
- recomp_input.h
- recomp_ui.h
- trace.h
- - blockingconcurrentqueue.h
  - concurrentqueue.h
  - lightweightsemaphore.h
- - .gitignore
  - CMakeLists.txt
  - GamepadMotion.hpp
  - LICENSE
  - README.md
- - LICENSE
  - README.md
  - slot_map.h
- FindFreetype.cmake
- freetype-windows-binaries
- libadrenotools
- lunasvg
- mnsg
- N64ModernRuntime
- RmlUi
- rt64
- BUILTIN_MODS.md
- .gitignore
- actor_funcs.h
- anime.c
- attack_move.c
- attack_move.h
- autosave.c
- autosave.h
- background.c
- camera.c
- camera.h
- charswap.c
- cheats.c
- cheats.h
- compile_flags.txt
- custom_syms.toml
- dummy.c
- functions.h
- graphics.h
- impact_block_fix.s
- init_patches.c
- input.h
- macro.inc
- macros.h
- main.c
- Makefile
- misc_funcs.h
- overlay_reloc.c
- overlay_relocs.h
- patch_api_funcs.h
- patch_helpers.h
- patches.h
- patches.ld
- print.c
- recompui_event_structs.h
- required.c
- sasuke_bomb_fix.s
- sound.c
- sound.h
- sound_funcs.h
- structs.h
- syms.ld
- tagging.c
- types.h
- ui_funcs.h
- variables.h
- widescreen.c
- .gitignore
- .gitkeep
- InterfacePS.hlsl
- InterfaceVS.hlsl
- - config.cpp
  - controls.cpp
  - debug.cpp
  - input.cpp
  - recomp_actor_api.cpp
  - recomp_api.cpp
  - recomp_data_api.cpp
  - rom_decompression.cpp
  - save_rollback.cpp
  - scene_table.cpp
  - unknown_symbols.cpp
- - android_diag.cpp
  - android_glue.cpp
  - main.cpp
  - register_overlays.cpp
  - register_patches.cpp
  - rt64_render_context.cpp
  - support.cpp
  - support_apple.mm
- - ui_api.cpp
  - ui_api_events.cpp
  - ui_api_images.cpp
  - ui_api_images.h
  - ui_color_hack.cpp
  - ui_config.cpp
  - ui_config_sub_menu.cpp
  - ui_config_sub_menu.h
  - ui_elements.cpp
  - ui_elements.h
  - ui_gpu_driver.cpp
  - ui_gpu_driver.h
  - ui_helpers.h
  - ui_launcher.cpp
  - ui_mod_details_panel.cpp
  - ui_mod_details_panel.h
  - ui_mod_installer.cpp
  - ui_mod_installer.h
  - ui_mod_menu.cpp
  - ui_mod_menu.h
  - ui_prompt.cpp
  - ui_renderer.cpp
  - ui_renderer.h
  - ui_rml_hacks.cpp
  - ui_rml_hacks.hpp
  - ui_saved_indicator.cpp
  - ui_saves.cpp
  - ui_saves.h
  - ui_state.cpp
  - ui_utils.cpp
  - ui_utils.h
.gitignore
.gitmodules
aspMain.toml
BUILDING.md
CMakeLists.txt
CMakeSettings.json
COPYING
Goemon64RecompSyms
launch.vs.json
mnsg.dump_context.toml
mnsg.overlays.txt
mnsg.toml
patches.toml
README.md
recompcontrollerdb.txt
TODO.txt

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

An Android port of [Goemon 64: Recompiled](https://github.com/klorfmorf/Goemon64Recomp) — plays *Mystical Ninja Starring Goemon* natively on your phone or handheld, using [RT64](https://github.com/rt64/rt64) for Vulkan rendering.

This is a packaging/port layer on top of the upstream recompilation project (built on [N64: Recompiled](https://github.com/Mr-Wiseguy/N64Recomp)). For how the recompilation itself works, or for desktop builds, see the upstream repo.

## Download

Get the APK from the releases page:

**https://github.com/ogdanimal/Goemon64Recomp-Android/releases**

The APK does not include the game. You'll need your own legally obtained ROM.

## Getting Started

1. Install the APK and open the app.
2. On first launch, you'll be asked to pick your ROM file — use the file picker, it gets copied into the app's own storage.
3. Make sure you have a gamepad. **The game is controller-only** — there is no touchscreen control scheme. A handheld's built-in controls work as-is; on a phone, pair a physical or Bluetooth pad first.
4. Press Start.

**Requirements:** Android 9.0+, a 64-bit (`arm64-v8a`) device, and a Vulkan-capable GPU. This covers effectively any phone or handheld from the last several years. Tested primarily on Snapdragon/Adreno handhelds (Retroid Pocket 5, AYN Thor).

## Something's Wrong — Quick Fixes

| Problem | Try this |
|---|---|
| Game closes itself a few seconds after starting | Known bug in some Qualcomm/Adreno drivers. Go to **Settings → Graphics → Framebuffer Effects** and turn it off, *or* load an alternate driver (see [GPU Driver](#gpu-driver) below). |
| White screen, textures missing | Fixed as of `1.0.3` — update to the latest release. |
| Hook Chain (R) does nothing in Impact battles | Fixed as of `1.0.6` — update to the latest release. Analog Camera was reserving R everywhere, including the mech battles where the game needs it. |
| Black border around the edges during Impact battles | Fixed as of `1.0.6` — update to the latest release. Impact battles now use the full screen. This works well, but it reveals image the original developers never expected to be on-screen, and only a couple of fights have been checked — if something at the edges looks clearly wrong, [please report it](../../issues). |
| "Failed to write to the save file" | As of `1.0.7` the message names the exact file it tried to write and what the system said about it, which usually points at the cause. If it isn't obvious, [open an issue](../../issues) with that text. |
| Want to bring a save over from another device | **Settings → Saves → Import** as of `1.0.7` — no adb or file manager needed. See [Importing a Save](#importing-a-save). |
| Some controller buttons do nothing, and don't respond when rebinding | Android doesn't recognize your pad's exact model. Fixed for DualSense Edge on Android 12 and earlier as of `1.0.4`; for anything else, [open an issue](../../issues) with your pad model and Android version. |
| Still stuck | [Open an issue](../../issues) with your device model and Android version. |

More detail on each of these is in [Troubleshooting Details](#troubleshooting-details) below.

## Default Controls

The default gamepad layout (Xbox-style face buttons). Everything is remappable in **Settings → Controls**.

| Button | N64 | In-game action |
|---|---|---|
| A | A | Jump |
| B | B | Attack |
| X | C-Up | Magic |
| Y | C-Left | Weapon swap |
| Right Bumper | C-Down | Change character |
| Left Trigger | Z | Crouch |
| Right Trigger | R | Camera control (zoom modifier when Analog Camera is on; still the Hook Chain in Impact battles) |
| Left Bumper | L | Unused by the game (free for mods) |
| D-Pad ↑ ↓ ← → | C-Up / C-Down / C-Left / C-Right | Magic / Character / Weapon / Map |
| Left stick | Analog stick | Move |
| Right stick | C-buttons | Drives the camera instead when Analog Camera is on |
| Right stick click (R3) | — | Recenter the analog camera |
| Start | Start | Pause |
| Select | — | Open this app's settings menu |

The right stick and D-Pad both cover the C-buttons, so with Analog Camera on, the right stick orbits while the D-Pad keeps the C-button actions.

## Optional Features

Everything below is opt-in and lives in the in-game settings menu.

- **Analog Camera** — free-look with the right stick. Hold **R** + push the stick to zoom. Per-axis invert and sensitivity settings included. Click **R3** to hand control back to the game. R is only reserved during normal exploration, so Impact battles keep the Hook Chain.
- **Swap Characters While Moving** — swap (C-Down) without stopping first. Doesn't speed up the swap itself, just removes the need to stand still.
- **Attack While Moving** — keep moving through a ground attack instead of rooting in place. Purely cosmetic; Goemon's chain pipe is unaffected since it anchors to a fixed point.
- **Autosave** — saves through the game's own save system (so it's an ordinary save, not a separate slot). **Back up your save before enabling this** — it overwrites your existing file. Manual save: **L + R + Z** during normal gameplay.
- **Cheats** — Infinite Health, Infinite Money, Infinite Lives. These write into your save at area transitions; turning a cheat off doesn't undo what it already did.
- **Restart Game** — restart to the title screen or back to this app's launcher, without closing the app.
- **Higher internal resolutions** — 3x/4x/6x/8x, beyond the console's native tiers.
- **Import a save** — see below.
- **GPU Driver** — see below.

### Importing a Save

**Settings → Saves** brings in a save file you already have — from another device, another Goemon 64 port, or a backup. It opens the system file picker and the app copies the file into place itself, so you don't need adb or a file manager that can reach `Android/data`.

The file is checked before anything is replaced: it has to be the right size *and* actually contain Goemon save data, so a save for a different game, or a flash dump from another emulator that happens to be the same size, is refused rather than imported. Whatever save was already there is kept alongside the new one as a `.pre-import.bak` file, so an import can be undone by renaming that file back.

Importing is only possible before you start the game. Once it's running the game holds your save in memory and writes it back out as it goes, so a file swapped underneath it would be overwritten.

### GPU Driver

On Adreno devices, **Settings → GPU Driver** lets you load a different Vulkan driver instead of your device's own — useful when the system driver is what's broken (see the crash fix above). It's per-app: nothing on your device is modified, no root needed.

Import a driver `.adpkg` or `.so` through the file picker and restart when asked. [Mr. Purple's purple-turnip](https://github.com/MrPurple666/purple-turnip/releases) builds are the usual source for Adreno handhelds. If you're not sure where to start and you're on **Android 12**, [**T24**](https://github.com/MrPurple666/purple-turnip/releases#release-vturnip_mrpurple_T24-toasted.adpkg) is a reasonable first try — but treat it as a starting point, not a guarantee, since driver compatibility varies by chip. A driver that doesn't work costs you nothing but a restart: the app confirms a new driver is actually working before keeping it, and falls back to the system driver otherwise.

This tab appears regardless of GPU, but the available replacement drivers are Adreno/Qualcomm builds, so there's nothing useful to import on Mali or other hardware.

## Troubleshooting Details

The quick fixes above cover the common cases. This section explains *why*, for anyone who wants it.

**Mali white screen (fixed in `1.0.3`).** The renderer used a Vulkan feature (dual-source blending) that no Mali GPU supports, causing a white screen with missing textures. `1.0.3` added a fallback chosen automatically from the GPU's reported capabilities — no configuration needed. On GPUs without that feature, N64 coverage-based effects (like anti-aliased edges) are approximated rather than exact; no visible difference was found in testing on Mali-G57/G77. If you see edge or transparency artifacts on Mali, please open an issue.

**Adreno launch crash (fixed in `1.0.4`).** Some Adreno devices (reported on a Motorola G60, reproduced on an Adreno 630) closed the app a few seconds into gameplay. This is a bug in the Qualcomm Vulkan driver itself, not the game — the same build runs fine under a third-party driver on the same hardware. Two independent workarounds, either is enough:
- **Graphics → Framebuffer Effects → Off** avoids the driver call that crashes. Works everywhere, no installation needed, at the cost of some visual effects.
- **Settings → GPU Driver** (above) runs the game on a different driver entirely. Adreno hardware only.

Both settings are reachable even on an affected device — the crash only happens once the game itself starts rendering, and this app's own menu (Start Game / Controls / Settings / Mods) comes up before that.

**GPU Driver build notes.** Tested against Mr. Purple's Turnip builds on an Adreno 630 running Android 12:

| Build | Driver version | Result |
|---|---|---|
| **T21** | `25.2.0-devel-Unified-1.4.318` | Works |
| **T24** | `26.0.0-T24-1.4.335` | Works — the build the game was actually played on |
| **T29** | `26.2.0-T29-1.4.354` | Does not load on Android 12 (needs `pthread_getaffinity_np`, likely Android 13+) |

The package's own `minApi` field doesn't flag the T29 case — all three declare the same value. That's one GPU on one Android version, so treat it as a starting point rather than a compatibility list; newer builds generally want newer Android. A driver that works at first and degrades later isn't detected automatically — switch back by hand if that happens. And if Android kills the app very early in a session, a driver you'd already confirmed may ask for confirmation again next launch.

**Controller buttons that do nothing.** Controllers are recognized through SDL's controller database, bundled with the app. If your pad is newer than your Android version knows about, Android hands it over as a generic HID device with some buttons in slots that have no defined meaning — those buttons do nothing in *any* app, and remapping can't reach them. `1.0.4` added an entry for the DualSense Edge on Android 12 and earlier (Circle/R1/Create/Options weren't registering). Android 13+ already handles that pad correctly. For any other pad with dead buttons, open an issue with the model and Android version.

## ROM and Storage

This app is not an emulator and doesn't include copyrighted game assets. On first launch, the ROM you select is verified and copied into the app's private storage — no manual folder setup or legacy storage permissions required. Saves and settings live in the same app-scoped location. That location is awkward to reach by hand on modern Android, which is why moving a save in is done through [Importing a Save](#importing-a-save) rather than by copying files around.

## Building

The Android app is a Gradle module under `android/` that drives the native CMake build:

- Android Studio (or the Gradle wrapper), **NDK 27.1.12297006**, **CMake 3.22.1**
- Native code builds for `arm64-v8a`
- Initialize submodules first: `git submodule update --init --recursive`
- **A supported ROM is required at build time.** `RecompiledFuncs/` and `RecompiledPatches/` are generated (not committed) by running the host recompiler + patches codegen against the ROM; the ROM's data never ships in the APK. A clean clone can't build without this step.
- A release keystore can be supplied via `keystore.properties` (repo root or `android/`)

See **[BUILDING.md](BUILDING.md)** for the full step-by-step build (host tooling, ROM codegen, and the APK build).

## Credits

- [Goemon 64: Recompiled](https://github.com/klorfmorf/Goemon64Recomp) contributors
- [@linkzenic](https://github.com/linkzenic) — [Zelda64Recomp-Android](https://github.com/linkzenic/Zelda64Recomp-Android), whose Android port paved the way for this one
- [N64: Recompiled](https://github.com/Mr-Wiseguy/N64Recomp) contributors
- [RT64](https://github.com/rt64/rt64) contributors
- [Zelda64Recomp](https://github.com/Zelda64Recomp/Zelda64Recomp), the base the upstream project builds on
- SDL contributors
- Icon and background graphic by [Jingleboy of Goemon International](https://goemoninternational.com)

Goemon64Recomp-Android

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README