Harepacker-resurrected：从 0 开始编辑 MapleStory WZ 文件并搭建自己的地图-开发者社区

Harepacker-resurrected：从 0 开始编辑 MapleStory WZ 文件并搭建自己的地图

【免费下载链接】Harepacker-resurrectedAll in one .wz file/map editor for MapleStory game files项目地址: https://gitcode.com/gh_mirrors/ha/Harepacker-resurrected

你想替换一个技能特效，或者重做一张地图，但游戏资源都压在 .wz 文件里，你不知道怎么打开。Harepacker-resurrected 是 MapleStory 的 WZ 文件与地图编辑器：HaRepacker 改资源，HaCreator 搭地图，MapSimulator 做实时预览，三个工具在同一个解决方案里。

10 分钟跑通第一个任务

安装 Visual Studio 2022，勾选“使用 C++ 的桌面开发”工作负载，系统用 Windows 10/11（1607 及以上）。
克隆项目并拉取子模块：

git clone https://gitcode.com/gh_mirrors/ha/Harepacker-resurrected cd Harepacker-resurrected git submodule update --init --recursive

用 VS 打开项目根目录的 MapleHaSuite.sln，把 HaRepacker 或 HaCreator 设为启动项目，按 F5 编译运行。
启动后在初始化窗口里指定客户端的 .wz 文件所在目录，或一个已解包的 .img 目录。
完成标志：资源树里能展开某个 .wz，点到一个图片节点，右侧出现它的预览图，说明整个链路已经通了。

WZ 文件编辑器能解决哪几类问题

换一张装备贴图或技能特效：在 HaRepacker 打开对应 WZ，定位到节点替换图片，保存回写文件。
给私服做一张新地图：在 HaCreator 里摆放落脚台、地砖、NPC 和传送门，再用 MapSimulator 跑一个角色验证能不能走通。
手上没有客户端或版本对不上：切到 IMG 文件系统模式，直接加载解包出来的 .img 目录，编辑和游戏版本解耦。
老素材分辨率太低：用内置的 Real-ESRGAN 组件放大后再放回去。

进阶玩法：热交换、AI 地图编辑与图片放大

IMG 热交换：编辑器加载 IMG 文件系统模式后，你在资源管理器里直接新增、修改或删除 .img 文件，列表和界面会自动刷新，不用重启程序。反复改贴图验证效果时，这个流程比重新加载快得多。

AI 辅助地图编辑：HaCreator 内置了 AI 地图编辑窗口，接入任意 OpenAI 兼容接口后，可以用自然语言下达布局和调整指令。项目还附带 WzImg-MCP-Server 子模块，把它发布后可在 Codex 里配置成 MCP 工具，让 AI 直接读取 IMG 数据。

AI 图片放大：RealESRGAN_AI_Upscale 目录里是 ncnn-vulkan 版 Real-ESRGAN 和 C# 封装，把低分辨率图片丢进去就能得到放大结果，适合处理经典老贴图。

常见坑与问答

clone 之后解决方案编译不过

多半是子模块没拉全，Spine-Runtime、MapleLib、WzImg-MCP-Server 都在 submodule 里。在项目根目录重新执行 git submodule update --init --recursive，再恢复一次 NuGet 包。还报错的话，确认 VS2022 装了 C++ 桌面开发工作负载，libapng 这部分依赖是 C++ 代码。