热血传奇客户端WIL与PAK文件目录分布及各自作用详细拆解

一、客户端根目录资源总览
标准传奇客户端（十周年 / 十三周年 / 十八周年等）解压后核心目录：
• Data\：原始 WIL / WIX / WZL 图形库（人物、怪物、物品、技能、UI）

- Resources\：GOM / GEE 等引擎自定义 PAK 补丁根目录（含 Pak.txt 总索引）
• Map\：地图逻辑文件 .map（地形、阻挡、物件层）

• Graphics\：分桶素材目录，常见 Graphics\Human\（衣服）、Graphics\Weapon\（武器）单文件 WIL

- Wav\：音效与背景乐 .wav
• minimap\ / ui\ / books\：小地图、界面、说明书等附属资源

服务端只下发“坐标 + 索引号”，客户端按索引去上述目录取图，取不到就红问号 / 透明 / 黑屏。

二、WIL / WIX / WZL 是什么
• .wil：老版二进制图库相册，顺序存 256 色小图（动作帧、图标、特效帧）

• .wix：对应 wil 的索引表，记录每帧偏移与长度，客户端先查 wix 再读 wil 数据

- .wzl：新版压缩图库，体积更小，内容等同 wil，老客户端优先读 wil/wix，缺失时回退 wzl
• .pak：GOM 系引擎加密压缩资源容器，需密码，由 Resources\Pak.txt 声明路径与密码后加载

读取优先级（GOM 系）：Resources\Data\XXX.pak → Data\XXX.wil → Data\XXX.wzl

三、Data 目录核心 WIL 文件与作用对照
文件名 作用 缺失表现
Hum.wil / Hum2.wil / Hum3.wil 男/女/裸身角色衣服动作（站、走、攻、施法） 人物透明、默认布衣、动作卡顿
HumEffect.wil / HumEffect2.wil 翅膀、光环、脚印等身上动态特效 翅膀不显、特效层空
Weapon.wil / Weapon2.wil / Weapon3.wil 武器手持动作与外观（对应 DB Shape 字段） 手持空手、木剑替代
Items.wil 背包 F9 物品图标 物品红问号
StateItem.wil 装备栏 F10 内观大图 穿装备无内观
DnItems.wil 地面掉落物显示图 地上装备透明
Mon1.wil ~ Mon18.wil 各序号段怪物站立/行走/攻击/死亡帧 怪物红问号或默认骷髅
Magic.wil / Magic2~6.wil 火球、雷电、冰咆哮、合击、四级技能光效 放技能无特效
Effect.wil 城门破碎、爆炸、动态门、通用动画 沙城破门无动画
Npc.wil / Npc10.wil 老兵、商人、传送员等 NPC 立绘 NPC 透明方块
Objects.wil / Objects1~7.wil 大地图建筑、城墙、树木、地物 地图建筑空块
Tiles.wil / SmTiles.wil 大地砖、水面波纹、地表纹理 地图花屏、深水黑块
mmap.wil / mmap10.wil 右上角小地图缩略图 小地图全黑
Prguse.wil / Prguse2.wil 底栏按钮、对话框、血条框、选服界面 UI 错位、面板空白
NewopUI.pak / NewopUI.wzl 新登录器基础 UI 框架 登录界面崩、按钮消失
ChrSel.wil / ChrSel.pak 角色选择界面背景与预览 选人界面花屏
MagIcon.wil 技能栏 F11 小图标 技能格空白
Hair.wil 男女发型分层图 头顶缺发
Face.pak / Helmet.pak / L-Horse.pak / S-Shield.pak 表情、头盔、坐骑、盾牌动作 对应部件不显


四、Resources 目录与 PAK 加载机制（GOM / GEE）
客户端根建 Resources\
└─ Data\（NewUI.pak、Hum.pak、Weapon.pak、Items.pak、StateItem.pak、DnItems.pak、Magic.pak、Effect.pak 等）
└─ Map\（覆盖或追加 .map）
└─ Wav\（覆盖音效）

Resources\Pak.txt 每行格式：
相对路径密码
基准目录
例：Data\NewUI.pakgameofmir
Resources\
含义：登录器去 [客户端根]\Resources\Data\NewUI.pak 取包，解包密码 gameofmir

物品 Looks 编号分段规则：
• 0–9999 → Data\Items.wzl / StateItem.wzl / DnItems.wzl

- 10000–19999 → Resources\Data\Items.pak / StateItem.pak / DnItems.pak（同序号三段一一对应）

衣服 Shape 分段：
- 0–11 → Data\Hum.wzl；12–23 → Hum2.wzl；24–99 → Hum3.wzl；100+ → Resources\Data\Hum.pak

武器 Shape 分段：
- 0–37 → Data\Weapon.wil/wzl；38–58 → Weapon2；59–99 → Weapon3；100+ → Resources\Data\Weapon.pak

单文件模式：
Graphics\Human\Shape值.wil（衣服）、Graphics\Weapon\Shape值.wil（武器），DB 里 Shape 从 1000 起算，文件名必须相等

五、Map 目录与地图素材关系
Map\ 内 0.map / 0122.map / 0150.map 等只存网格、阻挡、光线、物件坐标；
实际贴图仍引 Tiles.wil / Objects.wil / SmTiles.wil。
服务端 Mir200\Envir\MapInfo.txt 里地图号必须与 Map\ 文件名一致，否则进图黑屏但能走
GOM 自定义地图放 Resources\Map\ 同名覆盖，或 Map\ 直接追加新号。

六、Wav 目录
Wav\ 存 .wav：攻击、施法、升级、拾取、怪物叫、NPC 语音、背景乐。
自定义音效放 Resources\Wav\ 同名覆盖，Pak.txt 不必单列 wav 若走默认回退规则

七、常见显示异常定位表
• 背包图标红问号 → Items.wil / Resources\Data\Items.pak 缺 Looks 索引

• 穿上衣服透明 → Hum.wil 段或 Hum.pak Shape 不匹配 DB

- 怪物变骷髅 → MonX.wil 缺对应序号，或 DB Monster.txt 外观码越界
• 放技能无光 → Magic.wil / Magic2~6.wil 缺特效帧

• 进沙城黑块 → Objects.wil / Tiles.wil 缺建筑帧，或 Map\0150.map 不匹配

- 登录器报“文件不存在” → Pak.txt 路径≠物理路径，或 Resources 目录名被改
• PAK 密码错 → 登录器配置器读 Pak.txt 状态列显红，需同步服务端登录器文件夹内密码

- UI 按钮消失 → NewopUI.pak 没进 Data\ 或 Resources\Data\，Prguse.wil 被误删

八、编辑与替换注意
• WIL/WZL 用 WIL 编辑器（Legend Mira Editor / GOM 包内工具）导出导入 BMP，不能直接改扩展名

- PAK 用 GOM 登录器生成器内 PAK 打包页，设密码后写进 Pak.txt
• 脚本文件 ANSI 存盘；图片索引从 0 起算，DB 里 Looks/Shape/Appr 与补丁帧位一一对应

- 同名 WIL 直接覆盖，PAK 靠 Pak.txt 挂载，不要混把 pak 塞进 Data\ 又不写索引，加载器不认

WIL 是原始图库本体，WIX 是它的目录，WZL 是压缩替代，PAK 是 GOM 系加密补丁容器；Data\ 管原始资源，Resources\Data\ 管自定义加密包，Map\ 管逻辑、Graphics\ 管分桶单品，路径、密码、索引号三者对齐，客户端画面才完整。