Zelda64 Recompiled Android

This fork packages Zelda64 Recompiled for Android. It is an early beta Android port of Recompiled with RT64 rendering, SDL input, public device storage, touch controls, Android motion controls, and Android-native mod support.

Known Beta Notes

• App currently runs on AYN/Retroid style devices. I have NOT been able to tackle Samsung/Google specfic coding yet.
• App seems to be compatible with Snapdragon/Adreno, except in Samsung's strict proprietary ecosystem - note this has largely to do with the core of RT64 upstream
• This is an early Android beta and may still have device-specific Vulkan or driver issues.
• I highly suggest using a Turnip Driver such as Mr Purple (https://github.com/MrPurple666/purple-turnip/releases)
• External mod compatibility depends on whether the mod is pure .nrm content or includes native code that must be rebuilt for Android. (Note I've pre-bundled mods necessary for using character models).
• If a mod causes crashes, remove it from /Zelda64/mods and try launching again.

This fork is based on Zelda64 Recompiled:

https://github.com/Zelda64Recomp/Zelda64Recomp

Zelda64 Recompiled uses N64: Recompiled, with RT64 as the rendering engine.

For general Zelda64 Recompiled information, modding documentation, and desktop releases, see the upstream repository.

Download

Get the current Android beta from this fork's releases:

https://github.com/linkzenic/Zelda64Recomp-Android/releases

The Android release APK does not contain game assets. You must provide your own supported ROM when the app asks for it.

Android Requirements

• Android 7.0 or newer
• ARM64 device
• Vulkan-capable GPU and working Vulkan driver (tested on Snapdragon 8 Gen 2 device, likely requires Adreno)
• Enough storage for the app data folder, saves, mods, and texture packs

This port has been tested primarily on Snapdragon/Adreno handhelds. If graphics are incorrect, crashes happen at game start, or Vulkan device creation fails, your device may need a newer or different Vulkan driver.

What This Android Fork Adds

• Android APK packaging for Zelda64 Recompiled
• Updated UI and designs
• On-screen touch controls option
• Editor menu (advanced settings)
• Android accelerometer/gyro input for gyro aim
• Physical controller support through SDL
• Use custom turnip drivers
• Import o2r mods for clock styles

Storage Layout

The app creates and uses:

/Zelda64/
  mods/
  saves/
  config/

On first launch, Android may ask for storage access. Grant it so the app can create and manage /Zelda64.

Mods

Mods can be installed from the app's Mods menu. Download manual mod packages, then choose them with the Android file picker.

Android cannot load desktop Linux, Windows, or macOS plugin binaries. Mods that include native code need Android ARM64 .so files built specifically for this port. If a mod package overwrites an Android .so with a desktop build, the mod will fail to load or the app may crash.

Bundled Android Mods

This fork includes a small set of Android-ready mods by default:

• Linkzenic Save Editor is built into app (no need to install)
• ProxyMM KV
• MageMod Audio API
• yazmt Player Model Manager plugin

ProxyMM KV and the player model manager are bundled as complete mod packages, not only as .so files. They need Android-native shared libraries, and users would otherwise be likely to download desktop packages whose native binaries are incompatible with Android. Bundling the full Android-ready packages prevents Linux .so files from replacing the Android builds.

ROMs And Assets

This project is not an emulator and does not include copyrighted game assets. You need a legally obtained supported ROM. The app will ask you to select it before starting the game.

Credits

• Zelda64 Recompiled contributors
• N64: Recompiled contributors
• RT64 contributors
• The Zelda64 Recompiled mod authors whose Android-ready packages are bundled in this fork
• yazmt
• MageMods
• ProxyRecomp_KV