drakolordx7/switch2-recomp

项目介绍

Pokopia Recomp 是一个静态重编译项目，把 Switch 2 版《Pokémon Pokopia》转换成 Windows 原生程序。它不是模拟器路线，而是在用户电脑上提前把游戏代码编译成本地产物再直接运行。项目基于 nxrecomp 构建，并使用了 Ryujinx、yuzu、Eden、Mesa 等上游项目的运行时与图形代码 仓库。目标用户是已经拥有游戏本体、希望在 PC 上游玩的人。

代码分为共享运行时和单游戏目录：本作相关代码位于 recomp/games/pkp/ 与 runtime/games/pkp/，其余部分与其他重编译项目共用 README 第 27–33 行。

快速使用

1. 确认系统为 Windows 10 或 11 64 位，显卡支持 Vulkan 1.3，内存 16 GB 运行要求。
2. 自备游戏本体 2.0.1a 版本，形式为已解包文件夹，或 NSP/XCI 文件加对应的 keys README 第 1–8 行。
3. 从 发布页 获取最新构建，解压后运行 PokopiaLauncher.exe。
4. 在启动器中选择游戏转储目录（或 NSP/XCI 文件与 key 文件），点击 Set up。程序会在本机编译游戏，约 7 分钟，随后构建着色器缓存，约 1 到 2 小时；过程中可以暂停，之后再继续 使用步骤。
5. 点击 Play 开始游戏。游戏内按 F1 打开设置，中键切换 Joy-Con 2 鼠标模式，用于摆放物品。

遇到问题可在仓库提交 issue，并附上出问题那次会话的 pkp.log、显卡型号和 Windows 版本 问题反馈。

从源码构建

构建需要 Visual Studio 2022 Build Tools 或更新版本、LLVM、CMake、Ninja、Python 3.13、.NET 8 SDK、带 libvpx:x64-windows-static 的 vcpkg，以及 Rust 和 Node.js。把游戏的 exefs 文件复制到 game\dump\exefs\，在 Developer Command Prompt 中运行 recomp\scripts\build_game.cmd pkp，再执行 pwsh -File game-build\scripts\build.ps1。着色器相关工具见 tools/shaders，Tauri 启动器在 launcher\ 下通过 npm install 与 npm run tauri build 构建 README 第 27–33 行。运行时测试用 pwsh -File runtime\scripts\build.ps1 -Test。

使用约束

• 必须自备合法取得的《Pokémon Pokopia》2.0.1a 本体及 keys，项目不提供游戏数据。
• 启动器和构建流程仅支持 Windows，Vulkan 1.3 要求使较老的显卡无法使用。
• 首次设置耗时长：编译加着色器缓存接近两小时，好在可以中断续做。
• 项目以 GPL-3.0 发布，随附的第三方组件保留各自许可证 README 第 34–40 行。

HotRepo 点评

该仓库于 2026-11-05 进入 C++ 新项目榜，在一小时窗口内新增 4 个 Star，累计 395 Star、33 Fork。目前只有这一段很短的观察记录，能说明的只是早期关注度；真正影响使用的问题——发布包与仓库源码是否对应、重编译运行时在不同显卡上的稳定性——均无法由现有数据得出。