xFractals/pokopia-native

项目介绍

这个工具把用户自己导出的《Pokémon Pokopia》（Switch 2，标题 0400A3A01EE4C000，更新 v327680）转换成两个原生应用：Mac 应用和未签名的 iPhone IPA。它不是模拟器外壳：游戏自身的 ARM64 代码会被改写以通过 Apple 内核检查，Switch OS 服务被模拟，NVN2 图形调用被翻译到 Metal。Switch 2 的着色器在构建时被降级到较旧的指令集，再由 Apple 的 Metal 工具链编译。

仓库声称不包含任何游戏内容。提取和生成的游戏数据都放在导出目录旁的构建文件夹里，工具会检查导出文件的版本和 build ID。仓库里只有数字、哈希和补丁配方。

快速使用

前置条件包括 Apple 芯片 Mac（M1 或更新）、约 20 GB 可用磁盘、带命令行工具和 Metal 工具链的 Xcode 27、Python 3.12、.NET 10 运行时、xcodegen，以及合法获得的对应版本游戏导出。完整清单和导出目录结构见 README 的依赖说明。

命令行构建流程如下：

git clone https://github.com/xFractals/pokopia-native.git
cd pokopia-native
python3.12 nxs2.py setup
python3.12 nxs2.py build "/path/to/your/dump folder" --mac-app --ipa

setup 会拉取固定版本的 nxnative 宿主、应用 Switch 2 补丁并构建着色器降级工具。build 依次提取导出、改写代码模块、编译宿主、降级并编译着色器，最后把产物写到 <dump 目录>_native/out/。首次构建据称约一小时，主要是着色器编译；之后重建只需几分钟。Mac 应用未公证，需要右键后选择打开。IPA 需要付费 Apple Developer Program 团队才能获得 Extended Virtual Addressing 权限，详见 iPhone 签名说明。

图形界面 Pokopia Native Builder.app 提供同样的流程，包含 Setup、选择目录和 Build 按钮。

使用约束

• 平台限制： 构建必须使用 Apple 芯片 Mac。Windows 只能构建 IPA，而且 README 明确说目前画面几乎不渲染，尚不可用。
• 游戏版本： 只支持更新 v327680，其他版本会被拒绝，因为补丁配方和着色器表只针对该版本。
• iPhone 签名： 没有付费开发者团队时，应用能安装但启动时会因无法预留游戏所需内存地址空间而失败，文档未给出可用变通方案。
• 运行时着色器： 游戏运行时会自行生成约 140 个着色器，无法预先编译。缺失时只会跳过对应效果而不会崩溃；用 nxs2.py refresh 翻译录制到的着色器并重建。
• 发热与内存： README 称手机在 30 fps 下约六分钟后进入 iOS 的 serious 热状态，建议调低 DM_RENDER_SCALE。内存低于近期 Pro 机型的手机可能吃力。
• 法律： 项目声明不做解密、不提供密钥，并要求用户不要分享导出文件、构建产物、IPA 或着色器录制。除 ampere-lower/（来自 Eden-NS2，GPL-3.0-or-later）外，其余为 MIT；详见法律声明。

HotRepo 点评

该项目在 2026-11-03 进入 HotRepo 的 C++ 新项目榜，约 19 小时内新增 102 个 Star 和 9 个 Fork，对一个小众的粉丝移植工具而言早期增速明显。考虑到门槛很窄——特定游戏更新、Apple 芯片、iPhone 端还需付费开发者账号——这个关注度不算低。README 自述移植在几周内借助大量 AI 辅助完成，且 Windows 渲染仍不可用，因此更适合把它看作早期可运行的原理验证，而非成熟跨平台工具。着色器降级和相机控制部分写得具体，但实际受众基本限于已经拥有游戏和对应硬件的用户。