# PaperBoat：基于反编译成果的 Paper Mario 原生移植

> 以 pmret 和 Paper Mario DX 项目为基础，将 Paper Mario 反编译源码编译为基于 libultraship 的原生美版应用。Torch 把使用者自己的 ROM 转换为本地素材归档，移植另加入多种渲染后端、增强功能和归档式模组。桌面版已有正式发布；Android、iOS 和网页构建则在开发分支中有文档说明。

- 类型：案例
- 目标：游戏
- 类别：独立重建案例
- 关联：独立重建项目
- 来源复核于：2026-10-18
- 收录于：2026-10-18
- 原始资源：<https://github.com/HarbourMasters/PaperBoat>
- 一手来源：<https://github.com/HarbourMasters/PaperBoat/blob/d98b4b630f0674548067f59019fffef6885766e8/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/paperboat-paper-mario-port-case/>
- 记录 JSON：<https://awesomerea.org/resources/paperboat-paper-mario-port-case/record.json>
- 英文版：[English](https://awesomerea.org/resources/paperboat-paper-mario-port-case/index.md)

## 使用条件与局限

- **前提条件：**需使用者自备美版 Paper Mario ROM，且 SHA-1 与 README 所列一致；config.yml 仅包含该哈希的配方，README 声明不包含受版权保护的素材。Torch 在使用者的电脑或设备上生成 pm64.o2r 游戏归档，该归档从不随应用分发。
- **前提条件：**源码构建需 Torch 与 libultraship 子模块、CMake 3.24+、Ninja 及 C99／C++20 编译器。Windows 使用 Visual Studio 2022 的 clang-cl，普通 MSVC cl.exe 不支持这些 C99 反编译源码。渲染后端为 DirectX 11、OpenGL 和 Metal。文档还说明 Android arm64-v8a、iOS 16.3+ 和 Emscripten 构建，这些平台禁用脚本与原生模组。
- **范围：**所审 develop 快照晚于 1.0.3 版（2026-10-11），该版本提供 Windows、Linux 和 macOS 安装包。CMake 以 VERSION_US 编译反编译项目的游戏 C 源码，并用移植代码替换 N64 启动层和大部分系统层。这是有意加入增强与修复的原生移植，不是生成一致 ROM 的构建，也不是静态重编译。
- **测试证据：**CI 工作流构建 Linux、Windows、macOS、iOS、Android 和网页产物，并检查打包内容；平台指南称 CI 从不接触 ROM，且其提到的桌面检查脚本在所审源码树中并不存在。夜间构建标明仅供试玩，可能出现错误和崩溃。项目未报告游戏行为等价或性能结果。
- **许可：**仓库附有 CC0-1.0 文本，但 GitHub 未识别出所致谢的 pmret 和 Paper Mario DX 仓库的许可证，子模块也另有条款；因此不把该 CC0 文件视为对继承代码或游戏内容的授权。README 说明在 HarbourMasters 政策范围内接受 AI 辅助的拉取请求。

## 一手来源

1. <https://github.com/HarbourMasters/PaperBoat/blob/d98b4b630f0674548067f59019fffef6885766e8/README.md>
2. <https://github.com/HarbourMasters/PaperBoat/blob/d98b4b630f0674548067f59019fffef6885766e8/docs/BUILDING.md>
3. <https://github.com/HarbourMasters/PaperBoat/blob/d98b4b630f0674548067f59019fffef6885766e8/docs/android-ios-web.md>
4. <https://github.com/HarbourMasters/PaperBoat/blob/d98b4b630f0674548067f59019fffef6885766e8/CMakeLists.txt>
5. <https://github.com/HarbourMasters/PaperBoat/blob/d98b4b630f0674548067f59019fffef6885766e8/config.yml>
6. <https://github.com/HarbourMasters/PaperBoat/blob/d98b4b630f0674548067f59019fffef6885766e8/.gitmodules>
7. <https://github.com/HarbourMasters/PaperBoat/blob/d98b4b630f0674548067f59019fffef6885766e8/.github/workflows/build.yml>
8. <https://github.com/HarbourMasters/PaperBoat/blob/d98b4b630f0674548067f59019fffef6885766e8/LICENSE>
9. <https://github.com/HarbourMasters/PaperBoat/releases/tag/1.0.3>

## 同分区更多条目：游戏

- [Pokémon Platinum PC Port：基于 pret 反编译的原生移植](https://awesomerea.org/zh/resources/pokemon-platinum-pc-port-case/index.md) · 案例
- [Salamander UEFI：《沙罗曼蛇》的反汇编驱动 UEFI 移植](https://awesomerea.org/zh/resources/salamander-uefi-case/index.md) · 案例
- [Ship of Harkinian：基于反编译源码的《时之笛》原生移植](https://awesomerea.org/zh/resources/ship-of-harkinian-oot-port-case/index.md) · 案例
- [sm64ex：基于反编译成果的 Super Mario 64 增强版 PC 移植](https://awesomerea.org/zh/resources/sm64ex-pc-port-case/index.md) · 案例
- [SpaghettiKart：基于反编译源码的《马力欧卡丁车 64》原生移植](https://awesomerea.org/zh/resources/spaghettikart-mk64-port-case/index.md) · 案例
- [Starship：基于反编译的 Star Fox 64 PC 移植](https://awesomerea.org/zh/resources/starship-sf64-pc-port-case/index.md) · 案例

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。