Harepacker-resurrected 项目使用教程

Harepacker-resurrected 是一个用于 MapleStory 游戏的全面 WZ 文件编辑器工具集，包含地图编辑器、WZ 文件编辑器等强大功能。

项目概述

Harepacker-resurrected 是一个社区驱动的 MapleStory 游戏工具集合，主要用于编辑游戏的 WZ 文件格式。该项目基于 .NET 8.0 构建，支持 Windows 操作系统。

项目结构介绍

项目包含三个主要组件：

HaCreator - MapleStory 地图编辑器

位于 HaCreator/ 目录下，专门用于创建和编辑 MapleStory 游戏地图。

HaRepacker - WZ 文件编辑器

位于 HaRepacker/ 目录下，是主要的 WZ 文件编辑工具，支持浏览、修改和保存 WZ 文件。

HaSharedLibrary - 共享库

位于 HaSharedLibrary/ 目录下，为 HaRepacker 和 HaCreator 提供共享的 GUI 组件和功能。

系统要求

• 操作系统: Windows 10/11 版本 1607+ 或 Windows Server 2016+
• 处理器架构: x64、ARM64、x86
• 内存: 推荐 8GB 及以上
• 显卡: DirectX 12，至少 2GB 显存
• .NET 版本: .NET 8.0

安装与构建

克隆项目

git clone https://gitcode.com/gh_mirrors/ha/Harepacker-resurrected.git
cd Harepacker-resurrected

构建要求

• Microsoft Visual Studio 2022（包含 C++ 桌面开发工作负载）
• Git 用于克隆项目和子模块

构建步骤

1. 使用 Visual Studio 2022 打开 MapleHaSuite.sln 解决方案文件
2. 恢复 NuGet 包：在包管理器控制台中运行 Update-Package
3. 选择目标平台（x64、x86 或 ARM64）
4. 构建解决方案

主要功能特性

WZ 文件编辑

• 完整的 WZ 文件浏览和编辑功能
• 支持多种 WZ 文件加密方式
• 批量编辑和处理功能

地图编辑

• 可视化地图编辑器
• 支持游戏关卡设计和布局
• 精灵动画预览功能

AI 图像增强

集成了 Real-ESRGAN AI 图像放大技术，支持 2D 图像智能放大和增强。

多语言支持

项目包含中文（简体和繁体）、韩文、日文等多语言资源文件。

使用指南

启动 HaRepacker

构建完成后，在 HaRepacker/bin 目录下找到生成的 HaRepackerResurrected.exe 可执行文件。

打开 WZ 文件

1. 启动程序后，点击"文件"菜单选择"打开"
2. 选择要编辑的 MapleStory WZ 文件
3. 浏览和编辑文件内容

编辑地图

1. 使用 HaCreator 组件打开或创建新地图
2. 使用工具栏中的工具进行地图设计和布局
3. 保存地图文件

配置文件说明

项目的用户设置和配置信息存储在程序运行目录的配置文件中，主要包括用户界面偏好、最近打开文件列表等设置。

注意事项

• 本项目是社区驱动项目，修复问题和添加新功能的速度可能较慢
• 编辑 WZ 文件前建议备份原始文件
• 某些功能可能需要特定的游戏客户端版本支持

许可证

本项目采用 MIT 许可证，允许自由使用、修改和分发。

技术支持

由于是社区项目，主要支持通过代码库的问题跟踪系统进行。建议在遇到问题时先查看已有的问题列表和文档。

项目持续开发中，欢迎有兴趣的开发者参与贡献。