moceure/BananaNative

选用指南

AI 根据 README 整理 · 2026/11/4 14:21:49

使用方式

通过安装 APK 并使用应用内界面添加游戏文件夹来使用；游戏准备可在 Mac 或手机上完成。

查看 README 依据

```sh brew install --cask dotnet-sdk # plus micromamba micromamba create -p ~/bananative-env -f android/environment.yml ~/bananative-env/bin/python scripts/pack_android.py /path/to/<game> ``` The last command writes the pack to `<title ID>-work/android-pack` next to your game folder. Copy the game folder to the phone (say `Switch2/<game>`) and the pack next to it (`Switch2/<title ID>-work/android-pack`). Install the APK from [Releases](../../releases), allow **All files access**, tap **Add game** and pick the game folder. It finds the

pack and is ready to play. ### Phone only Copy the game folder to the phone, install the APK, **Add game**, then **Prepare**. It runs in the background and can be paused; keep the phone on the charger. Phone-only setup works for `040074A01BF12000` for now: `0400C3F00006E000` runs out of memory while its code is rewritten on the phone, so use a Mac for that one. If something doesn't work, start with Settings › **Readiness check**. A game's ⋯ menu has **Share log**. ## Features

部署要求

需要 Android 13+ 手机，配备 Snapdragon (Adreno) GPU 和至少 12 GB RAM；测试设备为 Snapdragon 8 Elite Gen 5 16GB。需要游戏 dump 文件夹，不支持 NSP/XCI。

查看 README 依据

| `0400C3F00006E000` | 1.8.0 (base game) | Work in progress: in game and driving, with graphics problems | Only these versions run; the app tells you if your dump is a different one. ## What you need - An Android 13+ phone with a Snapdragon (Adreno) GPU and at least 12 GB of RAM. Tested on a Snapdragon 8 Elite Gen 5 with 16 GB. - A phone cooler is recommended, strongly for `0400C3F00006E000`. - Tested only with the phone's own Qualcomm (system) GPU driver and the latest Turnip; other drivers may not work.

- Your own dump of the game as a folder. No keys or firmware are needed; NSP and XCI files don't work. ``` <game>/ base/ exefs/ and romfs/ updates/<version>/ the update, if the version above is one dlc/<title id>/<n>/ extra content, if you have it ``` - Optionally, your own `Lossless.dll` from Lossless Scaling, for frame generation. ## Setup Each game is prepared once: its code is rewritten for Android and its shaders are translated to Vulkan. A Mac does this in 10-15 minutes. The phone can do it alone, but it takes about an hour. ### With a Mac

已知限制

非官方且实验性，仅在一台手机上测试；部分游戏存在图形问题，如纹理闪烁、黑屏；手机发热和帧率下降可能发生。

查看 README 依据

the Mac, iPhone and iPad with Metal. > [!NOTE] > Unofficial and experimental, tested on one phone. Not affiliated with Nintendo, nxnative or Eden: please don't send > them bug reports about this. Not related to [nx2android](https://github.com/shirai91/nx2android) either: Banana > Native is its own codebase, ported from nxnative, and not a fork of that project. Most of the code was written with > an AI coding assistant (Claude) and tested by hand. Releases are only published on this page. ## Games | Title ID | Version | Status | |---|---|---| | `040074A01BF12000` | update 458752 | Works |

- **Warning, `0400C3F00006E000` is a work in progress** and shows black pixels: after a race, going back to the character selection screen can turn the 3D scene dark or black (the menus and the race HUD still draw). Free roam alone is not affected. Being fixed. - `040074A01BF12000`: some texture glitches during fights in some caves. - `0400C3F00006E000` has more problems: trees flicker, ground textures are sometimes missing, and memory is tight on 16 GB. It heats the phone a lot. - The first visit to an area stutters while its shaders and pipelines are built; later visits are smoother.