《马力欧赛车 世界》(Nintendo Switch 2)的重编译版本,可在 Linux 和 Windows 上原生运行。
发布 · 帮助 Wiki · Discord · 更新日志 · 参与贡献 · 来源 · 路线图 · 性能 · 问题 · 讨论 · 存档
English · 简体中文 · Español · العربية · हिन्दी · Português (Brasil) · Português (Portugal) · Deutsch
将《马力欧赛车 世界》(*Mario Kart World*,Nintendo Switch 2,1.0.0 和 1.8.0 版)静态重编译为 Linux 和 Windows 上的原生 PC 程序。你需要自己的游戏副本,并从你自己的主机中导出:本仓库及其发布版本中不包含任何游戏内容。 **这是重编译,不是模拟器。** 游戏的 AArch64 代码会被预先翻译成 C,再针对 PC 的 CPU(x86-64,或 Linux 上的 AArch64)编译; 没有 CPU 解释器,也没有 JIT。GPU 同样不是模拟的:Switch 2 的图形 API NVN2 在 API 层面基于 Vulkan 重新实现,游戏的 SM86 着色器会被预先翻译成 SPIR-V。任天堂 SDK 的函数(`nn::*`)按名称替换为我们自己的代码。 ## 状态 尚处早期,但进展很快。截至 2026/11/12: - 它可以启动、播放开场视频、浏览菜单并进行比赛,支持 Linux 和 Windows(x86-64),以及 AArch64 上的 Linux(有独立的 AppImage;已在搭载 Adreno 740 的掌机上测试)。 - 启动界面会在你的电脑上用你的副本完成游戏设置(生成并编译 C 代码、翻译着色器、预热管线缓存),并管理所有设置:显示、 画质、操作、修改项(hacks)。 - 高端 GPU 上比赛可达 60 fps,中端 GPU 上为 30 fps;参见[性能](#performance)。 - 已知问题:部分菜单(模式、角色和车辆选择)仍需完善,赛车的阴影偶尔会丢失一帧,视频中部分音频会中断,在某些 AMD 驱动上 GPU 可能卡死。没有在线游戏。 ## 路线图 主要的待办工作,按优先顺序;详情见 [docs/project/roadmap.md](../../docs/project/roadmap.md)。 - **比赛 60 fps。** 目前比赛的每一帧是串行的:游戏完成它的帧(约 3 ms\*),然后 Vulkan 后端录制游戏的大批提交 (约 19 ms\*),然后 GPU 执行(约 10 ms\*),之后下一帧才开始。 录制处于关键路径上,因此工作重点是用更少的 CPU 完成录制:只在变化时设置动态状态、跨帧的绘制缓存、并行录制,以及更快的 游戏线程。 - **与主机一致的画面**:着色器翻译器的最后几个错误、赛车阴影、push constants、Vulkan 验证零错误。 - **所有菜单**都与主机对照检查:接下来是模式、角色和车辆选择。 - **不再出现 GPU 卡死**、更少的显存占用,然后是无卡顿的加载,以及面向非滚动更新发行版的 Linux 包。 - **1.8.0 与 1.0.0 持平**:它的超宽屏比例、阴影贴图尺寸和固定随机种子 ([#19](https://github.com/adriadam10/mkw-recomp/issues/19))。 \* 测量于 2026/11/09,我们的测试机:Radeon 660M APU(Ryzen 5 7535HS),Linux,720p 内部分辨率。 ## 性能 实测的帧时间及其所用版本见 [docs/project/performance.md](../../docs/project/performance.md)。要添加你的机器,请提交一份 [性能报告](https://github.com/adriadam10/mkw-recomp/issues/new?template=performance.yml):它会以报告中的版本加入表格。这些时间是 游戏自身的帧:插帧会显示更多帧,但不会缩短它们。16.7 ms 即 60 fps;帧率设为自动(与主机相同)时,达不到 60 会降到 30 fps,而超过 33.3 ms 的帧会让比赛慢于实时。 | 日期 | GPU | 内部分辨率 | 比赛 fps | 比赛帧时间 | |---|---|---|---|---| | 2026/11/11 | RX 7900 XTX (Windows) | 2160p | 60 | 16.7 ms | | 2026/11/11 | RX 9070 XT (Linux, RADV) | 720p 至 2160p | 60 | 16.7 ms | | 2026/11/10 | RTX 3060 (Windows) | 1080p | ~48 | ~21 ms | | 2026/11/11 | RTX 3050 Laptop (Windows) | 720p | ~37 | 26.7 ms | | 2026/11/09 | Radeon 660M (Linux, RADV) | 720p | 30-32 | 31-33 ms | | 2026/11/11 | GTX 1650 SUPER (Windows) | 1080p | ~24 | ~41 ms | | 2026/11/09 | GTX 1050 Ti (Windows) | 1080p | 22-24 | 42-45 ms | ## 如何游玩   1. 从你的 Switch 2 导出《马力欧赛车 世界》1.0.0 或 1.8.0(`exefs/` 和 `romfs/`,已解密;1.8.0 需将更新合并进本体的 RomFS),或将同一导出打包成单个 `.nup` 或 `.nx` 文件。 2. 从[发布](https://github.com/adriadam10/mkw-recomp/releases)下载适合你系统的启动器:Linux 下载 `.AppImage`(ARM 上用 `-aarch64`;默认游戏文件夹是 `~/.local/share/mkw-recomp`;需要 glibc 2.31 或更新:Debian 11、Ubuntu 20.04、SteamOS 及之后的版本),Windows 下载 `.zip` 并解压到一个文件夹。两者都需要约 30 GB 可用空间。 3. 运行 AppImage(先 `chmod +x`)或 `mkw.exe`,打开**游戏文件**,可选用**选择游戏文件夹**指定游戏的安装位置(或一个已有的 安装),再指向你的导出(**选择文件夹**或**选择 .nup 或 .nx 文件**),然后点击**开始设置**。启动器会记住安装文件夹;编译好的 游戏、设置生成的文件、存档、设置和缓存都放在那里。换选另一个文件夹不会移动已有的文件。 第一次设置需要一些时间(它会编译整个游戏,并下载 NVIDIA 的 `nvdisasm` 和 `ptxas`,Linux 上 84 MB、Windows 上 126 MB, 用于在你的机器上描述着色器编码);之后点击**开始游戏**。 4. 有新版本时,启动界面会提示(**更新到 vX**):它会下载、校验、替换程序,并只重新设置有变化的部分。 **设置 → 菜单 → 检查更新** 可以关闭此检查。 要求:支持 AVX2 的 x86-64 CPU(或 Linux 上支持 ARMv8.2 的 AArch64:LSE、FP16、RCpc、DotProd、CRC32),支持 Vulkan 1.3 的 GPU(推荐 `VK_EXT_mesh_shader`;没有它时,task 和 mesh 着色器会以 compute 方式运行),建议 16 GB 内存。在 Linux 的 Docker 或 Podman 容器中,需要在其 seccomp 配置中允许 `userfaultfd`(Docker 默认拒绝):否则移植版无法得知游戏的哪部分内存发生了变化, 运行速度会慢好几倍。 ## 额外功能 超出主机的部分,全部可选,默认关闭(或与主机相同): - **显示**:高于或低于主机的内部分辨率、21:9、32:9 和 48:9(比赛时两侧显示更多)、AMD FSR 1 缩放、HDR 屏幕上的 HDR、垂直同步、 mailbox 或 immediate 呈现模式。 - **插帧**:在游戏的帧之间生成额外的帧(30 fps 的比赛以 60 显示,或在 240 Hz 屏幕上以 240 显示)。更流畅,但不更快:画面 最多晚一帧,快速运动和小地图可能出现拖影。 - **画质**:纹理过滤和纹理质量、细节距离和阴影质量,可高于或低于主机。 - **声音**:5.1 环绕声。 - **操作**:所有按键和按钮都可重新绑定,鼠标控制视角,任天堂、Xbox 或 PlayStation 按钮图标,体感转向,振动强度;本地多人 游戏,每人一个手柄。Switch 2 的手柄(Pro 手柄、Joy-Con、GameCube 手柄)可通过蓝牙使用,在 Linux 上也可通过 USB;在 Windows 上,USB 需要一次性的驱动步骤,见下文。 - **修改项(hacks)**:加速(按住或切换 F2)、跳过视频、全部解锁、每次相同的随机性、直接进入计时赛或自由漫游。 - **语言**:菜单支持 20 种语言;游戏本身另外支持加泰罗尼亚语、加利西亚语和巴斯克语。 - **游戏文件**:选择安装文件夹;导出可以是文件夹,也可以是单个 `.nup` 或 `.nx` 文件,原地使用;可从启动界面更新。 - **性能叠加层**(FPS,或完整的 CPU、GPU 和内存信息),以及一键获取系统信息用于错误报告。 ### 在 Windows 上通过 USB 使用 Switch 2 手柄 这些手柄只有在收到发往其第二个 USB 接口的命令后才会启动,而 Windows 没有给该接口安装应用程序可用的驱动。每个手柄只需用 [Zadig](https://zadig.akeo.ie/) 做一次: 1. 用 USB-C 线连接手柄,打开 Zadig。 2. **Options → List All Devices**,然后选择手柄的 **Interface 1**(USB ID:Pro 手柄为 `057E` 和 `2069`,右/左 Joy-Con 为 `2066`/`2067`,GameCube 手柄为 `2073`)。不要选 Interface 0:那是手柄的正常输入接口,替换它会让所有其他程序都看不到手柄。 3. 驱动选 **WinUSB**,然后 **Replace Driver**(或 **Install Driver**)。 以这些 USB ID 出现的虚拟手柄(Switch2Connect 的 USB/IP 模式)也适用同样的步骤。要撤销,在设备管理器中卸载该接口的设备,并 勾选“删除驱动程序”。 ## 模组 启动界面的**模组**页面会按照模组发布时的样子安装它们,并在两个标签页中列出: - **在 GameBanana 上查找**:[GameBanana](https://gamebanana.com/games/22152) 上的《马力欧赛车 世界》模组,可浏览或搜索, 显示每个模组的作者、许可证、截图和说明。**安装**会从 GameBanana 下载文件,仅在你要求时进行。 - **已安装**:你的模组,每个都有开关;**导入 zip / 导入文件夹** 可导入你已有的模组(`.zip`、`.rar` 或 `.7z`,其中任意 位置包含 `romfs/` 和/或 `exefs/`,也包括 `atmosphere/contents/` 结构)。 替换游戏文件的模组(`romfs/`:皮肤、纹理、文本、赛道)会在下次启动时生效。修改游戏代码的模组(`exefs/` 中的 `.ips` 或 `.pchtxt` 补丁,例如 200cc 或 30 FPS)会被编入游戏代码:开启或关闭其中一个会在游戏前重新编译(需要几分钟)。修改同一个 档案的两个模组会逐个文件合并,若两者修改了同一个文件,页面会询问以哪个为准。页面会对替换游戏画质设置或着色器的模组给出 提醒,因为移植版以自己的方式处理这些内容。 模组由其他人制作,本项目不对其进行测试:一个模组可能导致游戏崩溃或损坏你的存档。安装前请阅读模组页面,备份你的存档,并将 模组的问题反馈给其作者;在这里报告错误时,请说明启用了哪些模组(日志中会列出),或先在不启用它们的情况下再试一次。 ## 从源代码构建 Linux,需要 `uv`、`clang`、`lld`、`ninja`、SDL3、Opus、libvpx、zstd、xxHash、Vulkan 头文件和 VMA 3.4.0(详见 [tools/build/README.md](../../tools/build/README.md))。把你的导出放在 `game/`(`game/exefs`、`game/romfs`),或设置 `MKW_GAME=