企业官网建设流程全解析

冒险岛 WZ 编辑器终极指南：Harepacker-resurrected 完整上手教程

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

Harepacker-resurrected 是冒险岛（MapleStory）的一站式 WZ 文件与地图编辑器：改资源、做地图、跑实时预览，这三件最常干的事，一个仓库全包，不用再到处拼凑零散工具。

游戏文件为什么难改，它是怎么解的

冒险岛客户端的资源都打包在 WZ 归档里：角色外观、技能特效、地图图层、NPC 对话，全都在里面。你想换一张贴图、搭一张自己的副本图，先得对付这些二进制归档和版本差异的加密，这是大多数人卡住的地方。

这个仓库把三个工具放在了一起：

• HaRepacker：WZ/IMG 文件编辑器，资源替换、动画编辑、打包/解包都归它
• HaCreator：地图编辑器，跳板、瓦片、传送门、NPC、任务，都能在可视化界面里摆
• MapSimulator：实时地图模拟器，建完的地图不用启动游戏客户端，原地就能走一遍

想弄清底层格式，仓库自带文档：docs/wz-format/README.md 讲清了 WZ/IMG 的结构、加密方式，以及从 Beta 版一路到 v220+ 的格式时间线。

十分钟把编辑器跑起来

先备齐环境：Windows 10/11（1607 及以上）、Visual Studio 2022（要装"使用 C++ 的桌面开发"工作负载）、Git（拉取依赖子模块用）。运行时还需要 .NET 8.0 及以上运行时。

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

打开MapleHaSuite.sln，等 Visual Studio 还原包，把 HaRepacker 或 HaCreator 选为启动项目，按 F5。

第一次动手：换掉一个角色外观

第一次不必上难度，改一张装备贴图就够。

1. 在 HaRepacker 里加载你的 WZ 文件，资源以树形结构展开
2. 沿角色相关目录找到目标装备
3. 替换图片或就地修改属性
4. 保存，写回 WZ

WZ 归档还支持整包解包成 IMG 目录、编辑后再打包回去，HaRepacker/ 里就是这个打包/解包流程的源码所在。

搭一张能走的地图

切到 HaCreator，事情就有趣了。

摆跳板定地形、铺瓦片和视差背景、加传送门连通地图、放 NPC 和怪物——每个部件都有独立面板配置。改完之后直接在 MapSimulator 里预览：走一遍地图，验证跳板高度、传送门出口对不对，不用反复重启客户端。

任务这块有专门的编辑器：条件、奖励、NPC 对话都能配，保存前可以预览对话效果。

数据来源默认读游戏 WZ 文件；也有IMG 文件系统模式——资源解包成本地 IMG 目录后，不需要装客户端，素材还能直接进 Git 管版本。设计细节见 docs/hacreator-harepacker-architecture/README.md。

三个进阶玩法

素材热交换。IMG 模式下，你在资源管理器里直接增删改文件，编辑器检测到变化后自动刷新界面，全程不重启。完整机制在 img-hot-swap.md。

让 AI 帮你画地图。HaCreator 内置了基于 OpenAI 兼容接口的地图编辑：你用自然语言描述场景，它生成地图修改并自动应用，一整轮 AI 操作合并成一次可撤销。底层通过 MCP 暴露了 34 个地图工具，架构文档在 AI-OpenAI-Compatible-MCP-Architecture.md。

老素材 AI 放大。仓库自带 Real-ESRGAN 模块，低分辨率的老素材可以智能放大，大屏幕上不再糊。源码在 RealESRGAN_AI_Upscale/。

下一步，按这个顺序来

1. 构建项目，跑起 HaRepacker，打开一个 WZ 预览任意一张素材
2. 在 HaCreator 摆几块跳板和传送门，用 MapSimulator 走一遍验证连通
3. 切到 IMG 文件系统模式，体验热交换下的实时编辑
4. 想深入底层，读 docs/wz-format/README.md 和架构文档

改资源、建地图、实时验证——开头说的三件事，现在全在你手上了。

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