传奇客户端WIL与PAK文件全目录指南：Data/Map/Sound结构及排错手册

客户端根目录固定划分：主程序 Mir.exe / Game.exe 读 mir.dat 或登录器生成的配置（列表地址、网关端口、分辨率、版本号）；Data 目录装图形资源（.wil .wix .wzl .pak .txt）；Map 目录装 .map 地形文件；Sound / Wav 目录装 .wav 音效；Resources 目录（GOM/GEE）装分层补丁 Data/Map 子目录；Config 目录装 ServerList.txt、UIConfig.ini 等。

一、Data目录 WIL/WIX 原生文件对照
.wil 是二进制图库相册，存256色多帧BMP序列；.wix 是同名索引表，记录每帧偏移与长度；客户端先查 .wix 再读 .wil，缺 wix 会读不到图或错帧。核心配对清单：
- Hum.wil / Hum2.wil / Hum3.wil + .wix：男/女/裸身基础角色衣服动作帧
• Weapon.wil / Weapon2.wis / Weapon3.wil：手持武器静止与挥砍动作

- Items.wil + .wix：背包（F9）物品图标，金创药到屠龙全部来源
• StateItem.wil / StateItem.pak：装备栏（F10）内观静态图与发光

• DnItems.wil / DnItems.pak：地面掉落物小图

- Mon1.wil～Mon35.wil、mon-kulou.wil：怪物站立/行走/攻击/死亡方向帧
• Magic.wil、Magic2.wil～Magic6.wil：雷电术、火墙、治愈等技能光效

- Effect.wil、petaleffect.wil、stateeffect.wil：破碎、花瓣、落花、经络通用特效
• Npc.wil～Npc2.wil：NPC立绘与动作

• Objects.wil～Objects18.wil：大地图建筑、树木、墙体拼接图

- Tiles.wil / Tiles2.wil、SmTiles.pak / SmTiles2.wil：地砖、水面波纹
• mmap.wil / mmap.pak / mmap10.pak：小地图缩略图

- Hair.wil / Hair.pak：发型动作
• Helmet.pak、S-Shield.pak、L-Horse.pak、l-HumHorse.pak：头盔、盾牌、坐骑、乘骑姿态

- Prguse.wil / Prguse2.wil / Prguse3.wil：下方技能条、按钮、登录选服图
• Ifont.wil：界面字体样式表

• Face.pak：聊天表情符号

二、PAK文件体系与引擎差异
PAK是加密压缩资源容器，支持密码，启动期由登录器释放或动态加载，优先级高于同名 WIL（V8/GEE均如此）。
存放路径：原生补丁直接进 客户端根\Data\；GOM/GEE分层补丁进 根\Resources\Data\ 并在 Pak.txt / ResInfo.txt 注册序号与密码。
常见 PAK 清单：
• NewopUI.pak / NewopUI2.pak：主界面血条、技能栏、雷达、背包、交易框、登录窗（GEE默认空密或 GEEM2，GOM默认 gameofmir）

- Prguse.pak / Prguse2.pak：服务器选择、面板底图
• Hum.pak、Weapon.pak、Items.pak、StateItem.pak、DnItems.pak、Npc.pak、Objects1~7.pak、SmTiles.pak、mmap.pak、Hair.pak、Helmet.pak、S-Shield.pak、L-Horse.pak、Face.pak、Effect-1~19.pak：对应上述 WIL 的打包替代版

- Maps.pak：部分版本地图纹理整包
NewopUI.pak 内部关键索引：00170血条背景、00171人物血条、00172高亮、00173内功、00174 NPC、00175怪物、00176大刀弓手、00177蓝血条、00240~00245雷达标记、00390~00441十三周年界面、00732~00748登录窗、01370~01375 1024界面

三、Map目录与地图联动
独立 .map 文件放 客户端根\Map\ 且必须同名覆盖；服务端 Mir200\Map 也要放一份，否则服务端认得、客户端黑屏。
地图号在 Mir200\Envir\MapInfo.txt 定义，MiniMap.txt 绑 mmap 索引；地形贴图来自 Tiles/Objects/SmTiles，缺则黑地或深水；小地图缺则雷达空白。

四、Sound/Wav目录
.wav 技能、攻击、环境、系统提示音；放 根\Sound\ 或 根\Wav\，部分引擎打包进 Sound.pak 置于 Data；缺文件不崩但静音。

五、GEE/GOM专属结构差异
GEE：特征 GeeEngine.dll、Data\Gee.wzl，地图 .map 单独加密，ResInfo.txt 记 PAK 内路径，!Setup.txt 开 DynamicLoad=1 动态载；Pak.txt 路径必须写成客户端绝对路径，密码与 UpdateServer 一致。
GOM：GomEngine.dll、Data\GomData.pak，Pak.txt 格式 “文件名 密码”，AES-256 + Store模式，禁 Deflate；Resources\Data 为默认分层根。
BLUE/HERO：主要吃裸 WIL/WIX，不强制 PAK，StdMode/Looks 直接指 WIL 帧号。

六、DB Looks 与文件帧号对应规则
装备 DB 里 Looks 值 = 目标 WIL/PAK 内图片序号（从0计）；Shape 决定槽位；StdMode 决定类型（如66/67衣服、68/69武器、75~89时装）。
例：Looks=120 且 StdMode=66 → 穿男时装衣服时去 Hum 系 WIL 第120帧取图；Looks 越界 → 红问号/布衣兜底。
怪物 DB Monster.db 的 Appr 值 → MonXX.wil 分段偏移；魔法 Magic.db 的 Effect 值 → Magic.wil 帧段。

七、常见故障与定位表
• 装备红问号/布衣兜底：Looks 超帧、WIL缺、StdMode错、PAK密码不对

• 进图纯黑能走：.map 未进客户端Map、服务端Map缺失、Tiles/Objects未覆盖

- 界面按钮错位/血条消失：NewopUI.pak 损坏、密码错、01370~01375 1024资源缺失
• 雷达空白：mmap.wil/mmap.pak 未载、MiniMap.txt 未绑

- 技能无光效：Magic.wil 缺帧、Effect-N.pak 密码错或未注册
• 怪物透明/只剩影子：对应 MonXX.wil 缺失或 wix 长度不符

• 覆盖后登录器闪退：PAK密码与配置器不一致、Pak.txt路径非绝对、Resources层级错

- 音效全无：Sound目录名错（Wav/Sound混用）、Sound.pak未释放
• 同目录 WIL 与 PAK 打架：PAK 优先，旧 WIL 改帧被盖，需改 Pak.txt 顺序或删冗余 PAK

八、编辑与打包工具链
WIL编辑器（改帧、导BMP、看偏移）、PAK编辑器（GEE_Pak / GOM Pak工具，设密码、写索引）、Map编辑器（改阻挡/物件层）、TotalCommander+插件（批量转 PAK↔WIL/WIS）。改完必须让 DB Looks、MapInfo、Pak.txt、ResInfo.txt 四处序号三方对齐，否则表现层必错。