超级马里奥64 DSi端口：开源项目搭建与配置指南

超级马里奥64 DSi端口：开源项目搭建与配置指南

sm64 A port of Super Mario 64 for the DSi 项目地址: https://gitcode.com/gh_mirrors/sm64/sm64

项目概述

本指南旨在帮助开发者和爱好者快速理解和搭建来源于 Hydr8gon/sm64 的超级马里奥64 NSi端口。该项目是对原N64游戏的解编译移植，并非DS版的重制，特别适配了DSi的硬件特性，包括更高的CPU速度和更大的RAM，故不支持标准DS模型。

1. 项目目录结构及介绍

下面是Hydr8gon/sm64的主要目录结构和关键文件说明：

• assets: 存放从合法的SM64 ROM中提取的游戏资产。
• bin: 编译后的中间文件或可执行文件存放处。
• src: 核心源代码，包含游戏逻辑和主要功能实现。
• include: 头文件集合，定义API接口和数据类型。
• lib: 库文件或者辅助工具集。
• levels: 关卡相关的代码或数据。
• sounds: 游戏音效和音乐资源。
• toolstools: 工具脚本，用于构建准备、测试或其他自动化任务。
• Doxyfile, Makefile: 文档生成和构建系统配置文件。
• README.md: 项目简介和快速入门指南。

2. 项目启动文件介绍

主构建文件：Makefile

• 作用：项目的核心构建脚本，负责编译整个项目，包括设置编译选项、链接库和目标文件生成等。
• 使用场景：在Linux环境下的终端中运行 make 或者在配置好的环境中使用 make -j$(nproc) 来并行编译加快过程。

Docker构建脚本：build_docker.bat（Windows）与 build_docker.sh（macOS/Linux）

• 作用：为跨平台兼容设计，通过Docker容器化环境来简化编译流程，确保一致的构建环境。
• 使用方法：将原版美版ROM改名为baserom.us.z64并置于项目根目录下，之后执行对应的脚本即可自动进行构建。

3. 项目配置文件介绍

关键配置文件：

• Makefile：

  • 配置项：包含了编译器选项、库路径、编译目标等。
  • 自定义：可以根据需要调整编译参数，如优化级别 -O2, 指定特定的编译器等。

• Doxyfile：

  • 作用：用于生成项目文档，通过Doxygen工具解析注释生成API文档。
  • 自定义：可以调整文档的输出格式、包含或排除的文件等。

对于特定的配置需求，如游戏设置或运行时配置，由于这是一个游戏端口项目，这些通常嵌入在源码中的特定配置宏或外部数据文件中，而不是独立的配置文件。因此，在实际操作中，可能需要直接修改源代码或查找相关常量定义以进行定制。

请注意，进行项目构建前需确保已满足所有依赖条件，并遵循版权法律，使用合法获取的游戏资产。此指导文档提供了一种进入这个开源世界的入口点，详细的构建步骤和配置理解还需参考项目仓库的最新文档和更新说明。

sm64 A port of Super Mario 64 for the DSi 项目地址: https://gitcode.com/gh_mirrors/sm64/sm64