Zelda3 项目下载及安装教程

1. 项目介绍

Zelda3 是一个基于 C 语言的逆向工程项目，旨在重新实现《塞尔达传说：众神的三角力量》（Zelda 3 - A Link to the Past）。该项目包含了大约 70-80k 行代码，重新实现了原版游戏的所有部分，并且游戏可以从头玩到尾。为了提取游戏资源（如关卡、图像等），你需要一份原版 ROM。一旦资源提取完成，ROM 就不再需要了。该项目使用了 LakeSnes 的 PPU 和 DSP 实现，并进行了大量的速度优化。此外，它还可以配置为与原始机器代码并行运行，以验证 C 实现的正确性。

2. 项目下载位置

项目代码托管在 GitHub 上，可以通过以下命令进行克隆：

git clone https://github.com/snesrev/zelda3.git

3. 项目安装环境配置

3.1 Windows 环境配置

3.1.1 安装 Python 及依赖库

1. 下载并安装 Python，确保勾选“Add to PATH”选项。
2. 打开命令提示符，输入以下命令安装所需的 Python 库：

python -m pip install --upgrade pip pillow pyyaml

3.1.2 安装 TCC（Tiny C Compiler）

1. 下载 TCC 并解压到项目根目录下的 third_party 文件夹。
2. 下载 SDL2 并解压到项目根目录下的 third_party 文件夹。

3.2 Linux/MacOS 环境配置

3.2.1 安装 Python 及依赖库

1. 打开终端，确保已安装 pip：

python3 -m ensurepip

2. 克隆项目并进入项目目录：

git clone https://github.com/snesrev/zelda3.git
cd zelda3

3. 安装所需的 Python 库：

python3 -m pip install -r requirements.txt

3.2.2 安装 SDL2

• Ubuntu/Debian:

sudo apt install libsdl2-dev

• Fedora Linux:

sudo dnf install SDL2-devel

• Arch Linux:

sudo pacman -S sdl2

• MacOS:

brew install sdl2

4. 项目安装方式

4.1 Windows 安装

4.1.1 使用 TCC 编译

1. 将美国区域的 ROM 文件命名为 zelda3.sfc 并放置在项目根目录。
2. 双击 extract_assets.bat 脚本，生成 zelda3_assets.dat 文件。
3. 双击 run_with_tcc.bat 脚本，生成 zelda3.exe 文件。
4. 使用 zelda3.ini 文件进行配置。

4.1.2 使用 Visual Studio 编译

1. 按照步骤 1-4 进行操作。
2. 双击 Zelda3.sln 文件打开 Visual Studio。
3. 安装“Desktop development with C++”工作负载（如果尚未安装）。
4. 将顶部下拉菜单中的“debug”更改为“release”。
5. 选择“Build > Build Zelda3”以在 /bin/release 子文件夹中生成 zelda3.exe。
6. 使用 zelda3.ini 文件进行配置。

4.2 Linux/MacOS 安装

1. 将美国区域的 ROM 文件命名为 zelda3.sfc 并放置在项目根目录。
2. 编译项目：

make

3. 使用 zelda3.ini 文件进行配置。

5. 项目处理脚本

5.1 extract_assets.bat

该脚本用于提取游戏资源，生成 zelda3_assets.dat 文件。

5.2 run_with_tcc.bat

该脚本用于使用 TCC 编译项目，生成 zelda3.exe 文件。

5.3 make

在 Linux/MacOS 环境下，使用 make 命令编译项目。

5.4 zelda3.ini

该配置文件用于设置游戏参数，如按键映射、窗口大小等。

通过以上步骤，你可以成功下载并安装 Zelda3 项目，开始体验这款经典的重新实现游戏。