项目恢复（Project Restoration）：安装与使用指南

项目恢复（Project Restoration）：安装与使用指南

project-restorationA Majora's Mask 3D patch that restores some mechanics from the original game to get the best of both worlds项目地址:https://gitcode.com/gh_mirrors/pr/project-restoration

1. 项目目录结构及介绍

Project Restoration 是一个专为《塞尔达传说：姆吉拉的假面3D》设计的补丁，旨在恢复原始游戏中的某些机制，结合最佳的图形升级与生活质量改进。以下是其主要的目录结构及其说明：

• source/: 主要包含项目源代码。

  • game/: 实现了《姆吉拉的假面3D》已知部分的游戏内逻辑，含头文件和部分游戏功能的重新实现。
  • hooks/: 配置文件用于补丁和钩子（Magikoopa相关），以修改游戏行为。
  • loader/: 代码加载器，负责启动时的必要初始化和加载过程。
  • common/: 包含一些小型实用工具和函数，供项目各部分共用。

• build/: 构建输出目录，存放编译后的目标文件或中间结果。

• release/: 发布版本的存放区，包括生成的代码补丁和修改过的exheader文件。

• gitignore, license, readme.md: 标准的Git忽略文件、许可证和项目说明文档。

2. 项目启动文件介绍

在 Project Restoration 中，并没有直接的“启动文件”一说，因为它主要是作为一个需要被应用到游戏ROM上的补丁来工作的。然而，关键的执行流程由 make_release.sh 脚本控制，这可以视作是生成最终可应用于游戏的补丁的“启动点”。通过运行这个脚本，用户能够准备适用于不同游戏版本（如v100, v101, v110等）的补丁。

3. 项目的配置文件介绍

配置主要体现在 hooks/ 目录下，这里存储的是用于应用补丁和修改游戏行为的配置文件。这些配置文件并非传统意义上的XML或JSON配置，而是特定于Magikoopa工具的配置形式，用来定义如何修改游戏的内部工作方式。对于开发者或进阶用户来说，这是定制补丁行为的关键所在。

为了正确设置和应用补丁，你需要遵循以下基本步骤：

1. 将原始游戏的代码bin和exheader bin文件分别放置在对应的版本目录（v100, v101, v110）下，这些需要自行从游戏ExeFS中导出。
2. 确保你的系统环境路径中包含了git和Magikoopa工具。
3. 执行make_release.sh脚本生成补丁。

请注意，出于版权原因，项目本身不提供任何游戏二进制文件，且强烈建议合法拥有游戏后再进行补丁应用。

---

本指南基于Project Restoration的开源信息编写，确保在使用过程中遵守GPL-2.0许可证的相关规定。

project-restorationA Majora's Mask 3D patch that restores some mechanics from the original game to get the best of both worlds项目地址:https://gitcode.com/gh_mirrors/pr/project-restoration