案例

Ghostship:基于 libultraship 的 Super Mario 64 原生移植

将反编译风格的游戏源码编译到 libultraship 平台库上,把 Super Mario 64 构建为原生 PC、Switch 和 Android 程序。附带的提取工具会在首次启动或构建时,把使用者自备的美版或日版 ROM 转换为 O2R 存档。项目提供现代渲染器、配置菜单和模组存档加载,而不是生成一致的 ROM。

使用条件与局限

  • 所审阅的 develop 分支声明版本为 3.0.0,与最新的“Alfa”发行版一致。其 src 目录保留了 n64decomp/sm64 重建项目的 audio、engine、game、goddard 和 menu 结构,移植代码位于 src/port;抽查的两个源文件与 n64decomp 对应文件高度相近,只有移植相关改动。README 本身没有指明上游反编译项目,因此这一来源关系属于审阅观察。
  • 需自备 .z64 字节序的 Super Mario 64 ROM:README 只接受美版和日版,并列出两者的 SHA-1 值。PC 发行版会把 ROM 转换为 sm64.o2r;Switch 版复用在 PC 上生成的 O2R,Android 应用则先核对 ROM 哈希,再在设备上完成转换。项目不附带任何游戏数据。
  • 源码构建使用 CMake 及 libultraship、Torch 子模块:Windows 需 Visual Studio 2022(v143 工具集)、Python 3 和 CMake,Linux 需 GCC/Clang、Ninja、SDL2、libzip 及列出的其他库。渲染器包括 DirectX 11、OpenGL、Metal,以及驱动支持时的 Vulkan。构建指南仍写着其他 Harbour Masters 移植项目的 sf64.o2r 和 2s2h.elf,文件名需对照当前构建目标核实。
  • GitHub Actions 工作流构建 Windows、macOS、Linux、Switch 和网页版本。README 称 CI 构建仅供试玩,并提醒可能出现错误和崩溃。项目没有公布一致性、回归或与原硬件对比的结果,本合集也未构建或运行该移植。
  • 根目录 LICENSE.md 以 MIT(2026,Lywx)授权项目自有代码。子模块各有条款;源自任天堂代码的内容和 ROM 素材不受该许可覆盖,README 表示不支持盗版。所审来源未确立 REA 或编码智能体的参与。

关于此条目

类型
案例
类别
独立重建案例
关联
独立重建项目
目标
游戏

来源复核于

说明已依据一手来源复核;这不代表已运行验证、经过安全审计或确认兼容。

一手来源

  1. README.md GitHub · HarbourMasters/Ghostship · 修订 40eef13
  2. docs/building.md GitHub · HarbourMasters/Ghostship · 修订 40eef13
  3. CMakeLists.txt GitHub · HarbourMasters/Ghostship · 修订 40eef13
  4. .gitmodules GitHub · HarbourMasters/Ghostship · 修订 40eef13
  5. LICENSE.md GitHub · HarbourMasters/Ghostship · 修订 40eef13
  6. src GitHub · HarbourMasters/Ghostship · 修订 40eef13
  7. .github/workflows GitHub · HarbourMasters/Ghostship · 修订 40eef13
  8. https://github.com/HarbourMasters/Ghostship/releases/tag/3.0.0