nxnative 是一个很特别的项目：它不是模拟器，而是把Switch游戏本身的代码直接在Apple芯片上执行，将Switch的NVN图形API层转译为Metal，打包成IPA给iPhone、iPad、Mac侧载运行。项目本身不含任何游戏资源，需要自备NSP/NSZ/XCI游戏文件与prod.keys密钥。
底层站在大量成熟开源项目之上：复用d2r-mobile的原生执行框架、Ryujinx着色器翻译管线、Atmosphère内核同步语义参考、yuzu Maxwell指令、LibHac解析NSP、SPIRV-Cross转Metal着色器等一堆组件，整合出这套NVN-on-Metal宿主层，替代Switch的Horizon系统。
硬件门槛
- iPhone：iPhone 15 Pro及更新（A17 Pro），iOS/iPadOS 26+
- iPad：M1及更新iPad原因：Switch纹理采用BC压缩格式，旧款苹果芯片硬件不支持解码，无法运行。
打包IPA流程（Mac环境，需要Xcode+Homebrew）
- 拉取仓库、安装依赖：xcodegen、zstd、spirv-cross、glslang、dotnet-sdk、lz4、capstone等；
- 准备游戏包：基础NSP + 更新DLC，支持NSZ/XCZ压缩包，脚本自动解压；
- 执行打包脚本，传入游戏目录与keys文件；首次构建30–60分钟，后续增量约10分钟，磁盘预留至少NSP大小×2 +10GB；
- 输出IPA，使用AltStore / Sideloadly / LiveContainer侧载；建议开启
increased-memory-limit权限，否则大游戏容易因内存限制闪退。
社区也有图形化打包工具 NX2Apple（独立fork），不用敲命令行。
游玩特性
- 内置设置面板：渲染比例、底座/手持模式、帧率目标、性能HUD、语言选择；打包时可预设语言，也可在启动页切换；
- 触控方案：2D/3D两种触控布局，支持外接手柄，连接后自动隐藏触控层；支持Switch风格震动，映射到苹果设备触觉引擎；
- 体感：摇晃iPhone可以模拟Switch手柄体感输入（例如《超级马里奥奥德赛》扔帽子）；
- 存档：保存在Files应用对应App目录下的
save/文件夹；重装侧载工具时记得复制存档和着色器缓存文件； - 卡顿说明：首次进入新场景会即时编译着色器，短暂卡顿属于正常现象，后续会缓存复用。
已知限制
- 不支持amiibo、Switch联网在线功能；
- 部分游戏存在画面、音频bug：例如火纹Engage切后台后静音、火纹风花雪月地面贴图瑕疵、马里奥银河点线特效渲染异常；
- 不是全游戏兼容，仓库给出了一批验证可玩清单，未测试游戏打包后大概率无法启动；版本绑定，60fps补丁只适配指定游戏版本。
