Nycolazs/ACNHRecomp

ACNHRecomp 是一个粉丝项目，对《集合啦！动物森友会》做静态重编译：把游戏的 AArch64 Switch 机器码提前翻译成 C++，再针对本机编译，系统服务用原生方式重新实现，NVN 图形调用转译为 Vulkan。它面向的是拥有正版游戏、愿意自己动手构建的玩家，而不是想找现成下载的人。

实际做了什么

产物是本机原生代码，而不是模拟器：游戏指针就是宿主指针，三个游戏模块用 clang 编译。Maxwell GPU 着色器用 Ryujinx/Ryubing 的着色器翻译器离线转成 SPIR-V；运行时提供 Horizon 内核、系统服务、通过 SDL3 的输入、音频、宿主时钟和存档 How it works。

移植版加入了主机没有的 PC 便利功能：分辨率和宽高比选项（含超宽屏）、FSR 1 放大、键盘鼠标支持（鼠标充当触屏）、按键重映射、按手柄切换的按键图标、面向 JKSV、Checkpoint、yuzu 分支和 Ryujinx 的存档导入导出，以及游戏内设置界面 Features。游戏自带 14 种语言，另可加载社区巴西葡萄牙语翻译，但该翻译不随项目分发 Languages and mods。

需要你自备的东西

仓库不含任何游戏代码、资源、密钥或固件。你需要自建游戏文件夹，结构为 exefs/ 加 romfs/（含更新约 10.5 GB），可选 DLC 放在 aoc/。该文件夹由同作者的独立项目 ACNHRecomp-Importer 生成，只在该项目的 Discord 提供，不在本仓库中 Your game folder。安装脚本以链接方式引用该文件夹，而不复制它。

3.0.2/3.0.3 版本能获得全部修复；2.0.7 和 1.0.0 可以正常显示画面、声音和鼠标 Version notes。在 12 线程、30 GB 内存的机器上首次构建约需 1 到 2 小时，此前重编译约 8 分钟、着色器约 2 分钟；安装脚本会自行把部分工具链下载到 private/ Building from source。Linux x86-64 已测试；Apple Silicon 上的 macOS（MoltenVK）已测试；Windows 可通过安装脚本构建，但作者称未充分测试；Android 在骁龙 865 设备上测试过，且需要先在电脑上准备好游戏文件夹 Platforms。

当前状态与限制

所有状态测量都来自 Linux x86-64 的 Intel Iris Xe/Mesa GPU。启动、捏人、开场动画和岛上自由行走在 30 fps 下可运行；游戏第一次存档尚未在完整流程中验证，依赖前请先备份。联机功能（串门、Nook Link、梦境岛）不可用，部分鸟类村民头部可能出现黑块 Status。

把帧率设为 60 fps 会让整个游戏以两倍速度运行，因为逻辑每帧只推进一次；存在脚本化的修复方案，但它会单独安装第三方代码 Troubleshooting。存档操作有保护：每次导入或恢复前都会备份当前存档，导入先暂存再原子替换；导入后应重启游戏，以免旧岛覆盖新岛 Saves。项目采用 MIT 许可证，但只覆盖项目自身源码，不授予游戏本体的任何权利 License。