Harepacker-resurrected 项目使用教程

1. 项目目录结构及介绍

Harepacker-resurrected 是一个用于 MapleStory 游戏文件的 wz 文件和地图编辑器的集合。项目的目录结构如下：

Harepacker-resurrected/
├── HaCreator/
├── HaRepacker/
├── HaSharedLibrary/
├── MapleLib/
├── MonoGame Font Builder/
├── RealESRGAN_AI_Upscale/
├── UnitTest_WzFile/
├── libapng/
├── spine-runtimes/
├── spine-runtimes-2.1.25/
├── squish-1.11/
├── .gitattributes
├── .gitignore
├── .gitmodules
├── LICENSE
├── MapleHaSuite.sln
├── README.md
├── index.html
└── release.py

目录介绍

• HaCreator/: MapleStory 关卡编辑器。
• HaRepacker/: MapleStory wz 文件编辑器。
• HaSharedLibrary/: HaRepacker 和 HaCreator 之间共享的库，主要用于 GUI。
• MapleLib/: MapleStory 文件处理库。
• MonoGame Font Builder/: MonoGame 字体构建工具。
• RealESRGAN_AI_Upscale/: AI 2D 图像放大工具。
• UnitTest_WzFile/: 用于跨版本测试 wz 文件的单元测试。
• libapng/: 用于处理 APNG 文件的库（目前未使用）。
• spine-runtimes/: 2D 动画库。
• spine-runtimes-2.1.25/: 2D 动画库的特定版本。
• squish-1.11/: 图像压缩库。
• .gitattributes: Git 属性配置文件。
• .gitignore: Git 忽略文件配置。
• .gitmodules: Git 子模块配置。
• LICENSE: 项目许可证文件。
• MapleHaSuite.sln: 项目解决方案文件。
• README.md: 项目介绍和使用说明。
• index.html: 项目主页文件。
• release.py: 发布脚本文件。

2. 项目启动文件介绍

项目的启动文件主要是 MapleHaSuite.sln，这是一个 Visual Studio 解决方案文件。通过打开这个文件，你可以启动整个项目并开始编辑和构建。

启动步骤

1. 安装 Microsoft Visual Studio 2022（需要 Windows .NET 桌面构建环境和 Nuget）。
2. 克隆项目仓库：

   git clone https://github.com/lastbattle/Harepacker-resurrected.git
   

3. 初始化并更新子模块：

   git submodule init
   git submodule update
   

4. 打开 MapleHaSuite.sln 文件，启动 Visual Studio 并加载项目。
5. 构建并运行项目。

3. 项目配置文件介绍

项目的配置文件主要包括 .gitignore、.gitattributes 和 .gitmodules。

.gitignore

这个文件用于指定 Git 应该忽略的文件和目录，避免将不必要的文件提交到版本控制中。

.gitattributes

这个文件用于定义 Git 在处理文件时的行为，例如文件的换行符处理、文件的合并策略等。

.gitmodules

这个文件用于管理项目的子模块。它指定了项目中使用的子模块的 URL 和路径。

其他配置文件

• LICENSE: 项目许可证文件，定义了项目的开源许可证。
• README.md: 项目介绍和使用说明，通常包含项目的安装和使用步骤。
• release.py: 发布脚本文件，用于自动化项目的发布过程。

通过这些配置文件，你可以更好地管理和定制项目的行为和结构。