热血传奇客户端各补丁文件说明：Data/Map/Wav/Resources/Wil/Wzx详解

热血传奇客户端补丁本质是把服务端新增的地图、装备、怪物、技能、音效、界面资源同步到本机，让客户端读得出图、听得到声、进得了图。补丁不进客户端对应目录，表现就是黑屏、稻草人、装备变木剑布衣、技能空图标、地图纯黑、无声。下面按目录和文件格式拆开讲，路径均指热血传奇客户端根目录（如 D:\Legend176）。

一、Data 目录（核心图形资源库）
Data 是补丁里权重最高的文件夹，存全部可视资源，格式主要是 .wil、.wzl、.pak、少量 .dat。同名覆盖、新名追加，引擎按索引号读取。
• Tiles.wil ~ Tiles255.wil：地图大地砖（96×64），地面底层纹理，缺了地图地面变纯黑或深水色。

- SmTiles.wil ~ SmTiles255.wil：地图小地砖（48×32），地面细节层，草皮波纹碎石。
• Objects.wil ~ Objects18.wil：地图建筑遮挡层，房屋、树干、栅栏、石门，带Y轴遮挡逻辑，人物进屋会被挡。

- Mon1.wil ~ Mon35+.wil：怪物站立/行走/攻击/死亡帧，新增怪必须带对应 MonXX.wil，否则透明或变稻草人。
• Hum.wil / Hum2.wil / Hum3.wil：角色穿各套装的动作帧（跑、站、攻、施法）。

- Hair.wil / Helmet.wil：发型、头盔外观。
• Weapon.wil / Weapon2.wil / Weapon3.wil / WeaponEffect.wil：武器手持动作与发光特效。

- Items.wil / Items1.wil：背包物品图标。
• StateItem.wil / StateItem1.wil：F10装备栏穿戴静态图、发光效果。

• DnItems.wil：物品掉地外观。

- Magic.wil / Magic2.wil / MagIcon.wil：技能释放光效、技能栏缩略图。
• Effect.wil / StateEffect.wil / PetalEffect.wil：沙城门碎裂、挖矿、花瓣、元宝特效。

- Npc.wil / Npc1.wil / Npc2.wil：NPC立绘与动作。
• ChrSel.wil：角色选择界面图。

• Prguse.wil / Prguse2.wil / Prguse3.wil / Ui1.wil：登录界面、按钮、血条、对话框、面板。

- Mmap.wil / Mmap1.wil：小地图底图。
• GuildBaseGuildMark.wil：行会徽章图库。

• 新版客户端常见 .wzl 实为 .wil 的压缩封装（Zlib），登录器读 wzl 不读 wil，老端反之，混用就读不到图。

二、Map 目录（地图数据与黑屏根因）
存 .map 文件，定义地图编号、宽高、瓦片索引、障碍、可走区域、出生点。服务端 MapInfo.txt 里注册的地图编号（如 0=比奇 3=盟重 11=苍月）必须在本机 Map 目录有对应 0.map / 3.map / 11.map，缺文件直接黑屏能走没纹理，编号对不上进图卡死。
地图补丁通常打包：Map\xxx.map + Data\TilesXX.wil + Data\ObjectsXX.wil 三者一起给，只塞 map 不塞贴图照样黑。

三、Wav 目录（音效与背景乐）
全部 .wav：技能声、怪物叫、NPC 语音、走路、挖矿、背景音乐。删掉 Wav 进游戏静音（仅剩挖矿声，那部分是运行时注入的）。新技能爆炸音、新怪吼叫、专属地图 BGM 都走这目录，同名覆盖即可。

四、Resources 目录（新版/微端/高清资源）
盛大后期客户端和 GOM/GEE 微端常用，存分包资源：Resources\Data、Resources\Map、Resources\Texture、Resources\Sound，结构等同上面三类但走异步加载。微端登录器按列表从服务端拉缺失块写进 Resources，手动补丁也按同样子目录平铺覆盖，别套双层。

五、根目录关键文件
• Mir.dat / Mir.exe：客户端主程序或校验文件，部分服定制登录器会替换 Mir.exe 集成多线、记忆账号。

• LoginGate.ini / ServerList.txt / Config.ini：指向 127.0.0.1 或公网 IP+端口，列表文件写错进不了服。

- !Data\StdItems.ini / Magic.ini / Monster.ini：物品名、属性、图标索引、技能参数、怪物显示名，改了服务端必须同步本机，否则背包装备名乱码、技能空图标。
• Key.lic / Pak 密码文件：GOM/GEE 加密补丁解码钥匙，没放根目录 Data 全黑。

六、补丁分类与放置速查
1. 装备/武器/时装/技能特效补丁 → 解到 Data 覆盖（Items/StateItem/Weapon/Magic 系列）
2. 新怪物补丁 → Data 覆盖 MonXX.wil + 可能加 ObjectsXX.wil（场景伴生）
3. 新地图补丁 → Map 放 .map + Data 放 Tiles/Objects/SmTiles 对应编号
4. 音效补丁 → Wav 覆盖
5. UI/登录界面补丁 → Data 覆盖 Prguse/ChrSel/Ui 系列
6. 微端/高清版 → Resources 对应子目录平铺
7. 数据表/列表 → 根目录或 !Data、Envir 客户端侧配置

七、常见显示异常归位
• 进图纯黑能走 → Map 缺 .map 或 Data 缺 Tiles/Objects

- 怪透明/稻草人 → MonXX.wil 没进 Data、Appr 索引错、登录器未加载 wzl
• 装备变木剑布衣 → Items/StateItem/Weapon.wil 没覆盖或 StdItems.ini 图标索引对不上

- 技能空图标 → Magic.wil / MagIcon.wil 缺失或 Magic.ini 未同步
• 无声 → Wav 目录没覆盖

• 小地图偏移 → Mmap.wil 缺或 DiamonMap.txt 未改

- 解压后还黑 → 补丁套了双层 Data\Data、Map\Map，必须平铺到客户端根 Data/Map

安装铁律：关客户端 → 备份原 Data/Map/Wav → 补丁按目录合并覆盖 → 确认无中文双层嵌套 → 启登录器进对应版本服。Data 里原厂 wil 尽量别手删，删了基础地图人物全崩。新版 wzl 与老 wil 不互通，登录器读哪种就用哪种补丁。