MacNativeGames

MacNativeGames:《王国之泪》Mac 项目、设备要求与证据

面向 Apple 芯片 Mac 的《王国之泪》实验项目,已有作者本机游玩报告。先分清源码状态、可下载发布包和测试边界,再判断是否适合尝试。

本文目录 · 跳到所需章节

目前实际有什么?

MacNativeGames 是面向《塞尔达传说 王国之泪》的实验性 Mac 源码项目,目前只支持 Mac。作者公告直接链接到 ly05010419/MacNativeGames。作者报告已在本机构建 Mac App 并进行游玩。2026 年 10 月 18 日核查时,GitHub Releases 为空:作者本机的成品 App 并不是已公开提供下载的正式发布包。

当前源码检查点为 f5cc151,于 10 月 18 日 21:06 UTC 核查。下方较早的性能记录仍固定到原始 41e1e0c 快照。SwitchToAny 尚未构建或运行游戏。这里提供项目参考,不提供游戏下载或安装教程。

iPhone 和 iPad 仍是未来计划。README 对未来 iPhone 机型的推荐,不代表已有可用 iOS 构建、明确发布日期或手机性能结果。本次核查所记录的游玩路线仅限 Mac。

面向哪些 Mac 和游戏版本?

固定版本 README 要求 Apple 芯片 Mac、macOS 26 或更高版本,并建议至少 16 GB 内存;图形层使用 Metal 4。作者列出的本机测试设备为 MacBook Air M4 和 Mac mini M4,这并非覆盖全部 Apple 芯片 Mac 的兼容性验证表。

macOS 27 启动修正现已合并。PR #11 于 19:49:39 UTC 合并为 dcd7d16。README 现明确列入 macOS 27,最低要求仍为 macOS 26+。joevans 所述检查仍仅为 M4 Pro/48 GB/macOS 27.0.1/游戏 1.0.0,到首个渲染帧,没有 macOS 26 复测、长局或存档测试。先前报告不证明所有 macOS 27 设备都会失败,修正合并也不等于逐系统版本验收。

不要把地址空间回退当作降低内存要求的方法。8 GiB 下限针对虚拟 alias 预留空间,不是物理内存。此 main 快照中,显式 TOTK_ALIAS_GIB 值低于 8 可能失败,较大的请求也可能缩小;另提的 a396e2d 覆盖参数后续修正未进入此 main 快照,本文不建议修改该覆盖参数。19:05 检查点保留之前未合并的历史状态。

文档列出三种精确游戏版本配置:

  • 1.0.0:游戏本体
  • 1.1.2:本体加对应的独立累计更新
  • 1.4.3:本体加对应的独立累计更新

存在配置,表示项目具备对应版本的代码与校验规则,不代表各版本性能相同、完整流程已验证,或任意更新都能运行。其他版本与 DLC 不在文档支持范围内。仓库不提供游戏内容,构建仍依赖另外准备的游戏输入与密钥。

它如何运行游戏?

技术说明将实现分为三层:

  1. ARM64 代码:大部分游戏指令直接在 Apple 芯片执行。提前进行的静态改写,替换需要在 macOS 上特殊处理的指令与平台寄存器访问。
  2. Horizon 服务:宿主实现游戏使用的 Switch 系统服务,包括内存、文件、输入和音频。
  3. NVN 图形:通过 Metal 4 实现游戏的图形命令。Maxwell 着色器先由 Ryujinx 着色器翻译器转为 SPIR-V,再由 SPIRV-Cross 转为 Metal Shading Language,随后由 Metal 编译并缓存。

构建仍需准备对应版本的着色器种子,首帧前仍须完成启动预热。已合并的 PR #16 让构建脚本在可选 Xcode Metal 工具链存在时自动将启动 MSL 预编译为随包 Metal 库,不需要额外启用开关。运行时只加载与本地 MSL 哈希准确匹配的库;工具链缺失、个别编译失败或库加载失败时,仍回退到运行时编译。

新计时报告测的是着色器预热,不是整个 App 启动时间或帧率。贡献者 RVZO6 报告 M4 Pro/macOS 27.0.1/TOTK 1.4.3/8,290 个着色器:新路径预热从 291 降至 17.8 秒,移动 App 后从 274 降至 6.6 秒;着色器库从零预编译步骤耗时 2 分 22 秒、体积增加 131 MB。仅比对标题画面,未测试其后游玩,不能据此推算其他设备或证明探索无卡顿。新遇到的绑定状态变体仍可能边玩边编译;另一项并行运行时预热 PR #13 在核查时仍开放。

最新源码还有哪些变化?

  • 特定图形修正:已合并 PR #3 处理神庙传送台黑纹理及 D16 相关技能矩形异常。贡献者 A/B 检查仅针对 M4 Pro/TOTK 1.4.3 上的传送台和倒转乾坤,两边均关闭启动预热并使用同一本地地址布局修正;不是性能基准或全流程测试。
  • 英文启动器:已合并 PR #12 在非中文 Mac 上选择英文界面,不新增 iPhone 或 iPad 构建。
  • Command-Q:已合并 PR #14 接入现有等待保存的关闭流程,超时为 15 秒。贡献者报告六项独立 AppKit 测试,未做完整游戏启动测试,不能保证存档安全。

性能数据究竟证明了什么?

较早 41e1e0c 的1.4.3 测试记录报告,在 15 个有效场景点按平均整帧耗时换算,约为 83.9–110.2 fps。每点都先热身,再固定镜头采样 30 秒;设备为 Apple M4、16 GiB、macOS 26.5.2,窗口 drawable 为 1280×720,默认游戏画布为 1920×1080。

这些条件不可省略。它们是短时间、已预热场景的平均值,不是持续探索基准,也不是不同游戏版本的公平对比。某点首次转镜头出现 902.4 ms 长帧,另一次测试记录了伴随编译的 936.2 ms 长帧。平均帧率会掩盖这种接近一秒、肉眼明显可见的停顿。

记录并未验证稳定 1440p 游玩。其中「原生 2K」模式将合成画布和 UI 改为 2560×1440,3D 场景仍由游戏自己的渲染缩放控制。验证 4K 输出纹理,也不等于验证了物理 4K 显示器上的表现。记录中实际使用的物理显示器为 1080p/60 Hz。

哪些部分尚未完成?

较早 41e1e0c 记录报告已验证场景加载、移动与跳跃、菜单与地图、保存重读、死亡重试、神庙进出。记录覆盖 17 个有效环境和新游戏开场,尚未完成完整序章或全流程通关。

  • 长时间运行:较早构建运行约三小时;最终记录的构建运行 30 分 31.68 秒后,由真实用户输入触发监测停止。它们是不同构建的独立运行,不能合并计算;最终构建原定 75 分钟的目标尚未完成。
  • 内存:较长测试中观察到增长。配置复用改善了一种图形资源增长模式,但记录没有证明所有长局内存增长均已解决。
  • 音频:README 报告已修复流式音乐/对白读取问题,并在 1.0.0 开场验证;其他版本与场景仍待核查,最终 1.4.3 测试中仍有音频欠载记录。
  • 图形与时序:首次着色器编译卡顿、部分诊断信息、更广泛的动画/物理检查,以及补帧质量仍有待处理。在线功能和 amiibo 不受支持。

较新的启动与界面改动,并未证明上述长局、音频或游玩限制已经解决。

它与 D2R Mobile、nxnative 有什么关系?

致谢部分说明,D2R Mobile提供了 NSO 改写、Horizon 宿主及 NVN-on-Metal 的基础工作;nxnative提供了一键打包和通用票据导入的思路。MacNativeGames 是独立仓库,当前目标是 Mac 上的《王国之泪》。另一个项目的发布或 iPhone 游玩结果,不能直接用于证明它的状态。

项目的 MIT 许可适用于该许可覆盖的源码;依赖代码保留各自许可,并在第三方声明中列出。这些声明不授予任天堂游戏内容的使用许可,也不能证明获取、使用或重新分发游戏文件与密钥已获得法律许可。作者声明仓库不含游戏内容,且与任天堂无关联。

其他项目的当前结果,请分别看 nxnative 的 Apple 平台报告与 D2R Mobile 当前状态。本站证据方法说明源码声明、作者游玩报告和独立实测之间的区别。

结论有范围,来源有版本。

以下区分源码核查、维护者报告与社区报告,本站没有执行游戏或真机测试。展开查看每条记录的限制与原始来源。

社区报告macOS 27 启动回退已合并;覆盖参数后续修正未入 main源码已合并;贡献者仅做有限启动检查

PR #11 于 19:49:39 UTC 合并为 dcd7d16;README 明列 macOS 27,仍要求 macOS 26+、建议 16 GB。贡献者报告 M4 Pro/48 GB/macOS 27.0.1/TOTK 1.0.0 到达首个渲染帧。

边界:没有 macOS 26 复测、长局或存档测试。main 中 TOTK_ALIAS_GIB 低于 8 可能失败,较大请求也可能缩小;另提的 a396e2d 覆盖参数后续修正未进入此快照。8 GiB alias 下限指虚拟地址空间,并非降低物理内存要求。无本站运行测试或 GitHub Release。

项目版本
MacNativeGames f5cc151; no GitHub Release
来源修订号
f5cc1519c5c6aed8b21c20317a9cee15f3f6d746
核查日
2026-10-18
本站运行观察日
未执行
MacNativeGames merged PR #11; main f5cc151
社区报告可选 Metal 工具链支持打包启动着色器库构建优化已合并;报告只比对标题画面

已合并 PR #16 在可选 Xcode Metal 工具链存在时自动预编译启动 MSL;运行时仅接纳准确匹配本地 MSL 哈希的库,否则沿用运行时编译。RVZO6 报告 M4 Pro/macOS 27.0.1/TOTK 1.4.3/8,290 着色器:新路径预热 291→17.8 秒,移动 App 后 274→6.6 秒,体积增加 131 MB、着色器库预编译步骤耗时 2 分 22 秒。

边界:这些是预热耗时,不是整个 App 启动时间、帧率或跨设备估计;仅比对标题画面,未测试其后游玩。缺少工具链、编译失败或库加载失败仍回退运行时编译;种子准备和首帧前完整预热仍必须执行。并行预热 PR #13 仍开放、未合并,属于另一项改动。本站未运行测试。

项目版本
MacNativeGames f5cc151; no GitHub Release
来源修订号
f5cc1519c5c6aed8b21c20317a9cee15f3f6d746
核查日
2026-10-18
本站运行观察日
未执行
MacNativeGames merged PR #16 and contributor warm-up comparison
静态源码核查神庙/倒转乾坤修正、英文启动器与等待保存的 Command-Q特定图形与 Mac 界面修改已合并

main 包含 PR #3 纹理布局/D16 渲染修正、PR #12 非中文 Mac 上的英文启动界面,以及 PR #14 将 Command-Q 接入现有等待保存的关闭流程,超时为 15 秒。PR #3 贡献者 A/B 检查针对 M4 Pro/TOTK 1.4.3 的神庙传送台和倒转乾坤;PR #14 报告六项独立 AppKit 检查。

边界:渲染对比两边均关闭启动预热并使用同一本地地址布局修正,不是性能或全流程证据。Command-Q 未做完整游戏启动测试,不能保证存档安全;启动界面修改不新增 iOS 支持。长局内存增长、音频欠载与首次使用卡顿并未因此获证解决。本站未运行测试。

项目版本
MacNativeGames f5cc151; no GitHub Release
来源修订号
f5cc1519c5c6aed8b21c20317a9cee15f3f6d746
核查日
2026-10-18
本站运行观察日
未执行
MacNativeGames 41e1e0c…f5cc151 merged source comparison
维护者报告MacNativeGames:独立的 Mac《王国之泪》实验源码可用;作者有限 Mac 测试,本站未验收

固定源码记录 Apple 芯片、macOS 26+ 上的 TOTK 1.0.0/1.1.2/1.4.3,建议 16 GB。运行时源码与构建工具公开;11:08 核查时 GitHub Releases 为空。作者报告 M4 测试,包括预热后 15 个有效点的 30 秒固定镜头取样:drawable 1280×720、游戏画布 1920×1080,约 83.9–110.2 FPS。

边界:仅为作者报告,非本站构建或游玩测试。仍有约 900 ms 编译卡顿、内存增长、音频欠载及最终构建长局测试未完成;不是稳定帧率或 1440p 验收。iPhone/iPad 支持是未来计划,不是已有 iOS 构建。致谢 D2R 与 nxnative 不代表它们的官方发布;MIT 与第三方声明不授予游戏内容许可。

项目版本
TOTK source profiles 1.0.0 / 1.1.2 / 1.4.3; no GitHub Release
来源修订号
41e1e0caf43d58c4af3c478ca2d1bafd9dba7093
核查日
2026-10-18
本站运行观察日
未执行
MacNativeGames pinned v1.4.3 port notes
D2R 当前状态理解技术原理历史检查点与完整来源