xFractals/pokopia-native

选用指南

AI 根据 README 整理 · 2026/11/3 03:36:37

使用方式

通过图形窗口或命令行使用，需要指定自己的游戏 dump 文件夹，最终生成可直接运行的 Mac 应用和 iPhone IPA。

查看 README 依据

IPA installs over USB. Your Apple ID has to be signed into Xcode once and your phone registered on the team (Xcode does that itself when the phone is plugged in). The details are in [docs/IPHONE.md](docs/IPHONE.md). Memory on the phone itself matters too. The game uses a lot of it. I run it on an iPhone19,4 on iOS 27.2. If your phone has less memory than the recent Pro models, expect trouble. ## How to build There is a window and there is a command line; they do the same thing. **The window.** Clone or download the repository, then double-click **Pokopia Native Builder.app** on the Mac

(**Pokopia Native Builder.cmd** on Windows). Press **Setup** once, choose your dump folder, tick what you want, press **Build**. The stages scroll by in the window with the elapsed time; **Refresh shaders** is the refresh step explained further down, **Open build folder** shows the outputs. If the app will not open, it tells you what to install (Python 3.12 with Tk: `brew install python@3.12 python-tk@3.12`). **The command line.** ```bash git clone https://github.com/xFractals/pokopia-native.git cd pokopia-native python3.12 nxs2.py setup

部署要求

需要 Apple 芯片的 Mac（M1 或更新）、约 20GB 磁盘空间、Xcode 27、Python 3.12+ 和 .NET 10 运行时。iPhone 构建需要付费的 Apple Developer 账号。

查看 README 依据

Mac compiling 3,800 shaders. After that, rebuilds take a couple of minutes. ## What you need - A **Mac with Apple silicon** (M1 or newer) and roughly 20 GB of free disk. The game's code is arm64, so an Intel Mac cannot run it. The Mac does the building for the iPhone too; there is no way around having one. - **Xcode 27** installed, with its command line tools and the Metal toolchain (Xcode → Settings → Components). For the iPhone build you also need the iOS platform from that same screen, and `xcodegen` (`brew install xcodegen`).

- **Python 3.12 or newer**: `brew install python@3.12`, then `python3.12 -m pip install "capstone>=5,<6" lz4 fonttools`. - The **.NET 10 runtime** (the shader translator is .NET): `brew install --cask dotnet-sdk`. - **Your dump.** The game's files as your dumping tool wrote them, with the update: ``` <your folder>/updates/327680/exefs/ main main.npdm rtld sdk subsdk0 <your folder>/updates/327680/romfs/ LD_C0_R.BIN LI_C0_R.IDX motor_asset_re/ movie_asset/ ```

## The Apple developer thing (iPhone only, read this) Pokopia is a big game. It reserves 11 GB of memory address space and actually uses several GB of it. To let an iPhone app do that, the app has to carry two Apple entitlements: **Increased Memory Limit** and **Extended Virtual Addressing**. Apple only grants the second one when the app is signed by a **paid Apple Developer Program** team (the 99 a year one). An app signed with a free Apple ID, through AltStore, Sideloadly and the like, installs fine and then stops at start-up when the game cannot reserve its memory.

已知限制

工具仅支持特定版本的《宝可梦传说 Z-A》（v327680），其他版本无法构建。iPhone 上需要付费开发者账号签名，免费账号会导致应用启动时因内存问题停止。

查看 README 依据

A folder that holds `exefs/` and `romfs/` directly works too. The base game alone is not enough: the tool is made for update **v327680** of Pokémon Pokopia (title `0400A3A01EE4C000`) and checks the build IDs. Another version will not build, because the patch recipe and the shader tables are for this one. - For the **iPhone**: see the next section. - **No Mac?** A Windows PC builds the iPhone app alone: [docs/WINDOWS.md](docs/WINDOWS.md). `python3.12 nxs2.py doctor` (or the window's **Check tools** button) checks all of this and tells you how to get whatever is missing.

## The Apple developer thing (iPhone only, read this) Pokopia is a big game. It reserves 11 GB of memory address space and actually uses several GB of it. To let an iPhone app do that, the app has to carry two Apple entitlements: **Increased Memory Limit** and **Extended Virtual Addressing**. Apple only grants the second one when the app is signed by a **paid Apple Developer Program** team (the 99 a year one). An app signed with a free Apple ID, through AltStore, Sideloadly and the like, installs fine and then stops at start-up when the game cannot reserve its memory.