一、客户端根目录与资源分工
传奇客户端根目录常见结构：Mir.exe/Game.exe、mir.dat、ip.dat、Data、Map、Resources、Sound、LoginGate配置等。服务端只下发坐标、动作指令、逻辑状态，所有可见画面（人物、怪物、装备、地图砖、技能光效、UI）都由客户端本地文件渲染。Data管老版散文件素材（WIL/WIX/WZL/WIS），Resources管GOM/GEE系PAK补丁包，Map管地图结构，Sound管WAV/MP3音效。
二、WIL/WIX/WZL文件本质
WIL是二进制图像库，内部顺序存多帧256色（后期WZL支持更高色深）BMP小图，文件头含魔数0x57494C、图片数量、调色板偏移、帧数据偏移，靠X/Y偏移做动画吱位。WIX是同名词索引文件，头标“#INDXv1.0-WEMADEEntertainmentinc.”，记录每张图在WIL里的起始位置与长度，客户端先查WIX再读WIL，缺WIX会定位失败出红问号。WZL是后期压缩版图像库，体积更小，13周年后客户端主力格式，和WIL互斥同名只读优先序靠前的。WIS多为补充特效库（连击、翅膀、武器发光）。
三、Data目录核心WIL/WIX对照表与实际场景
客户端\Data下常见文件对及用途：
•Hum.wil/Hum.wix：男女人物基疮作（站、走、攻、施法、死亡），换衣服外观首改这里
-HumEffect.wil：翅膀、发光衣物叠加层，合击版、单职翅膀补丁挂此
•Hum2.wil/Hum3.wil：后期服饰阶段（虎啸—辉煌—热血等）动作库
•Items.wil/Items.wix：背包内全部物品图标（金创药到屠龙），新增装备必扩此库序号
-DnItems.wil：物品掉地后的地面显示图
•StateItem.wil：装备栏内穿戴发光、镶嵌特效
•Weapon.wil/Weapon2.wis/Weapon3.wil：武器静态、挥动、连击光效
-Mon1.wil～Mon35.wil：怪物动作分库，Mon1大刀/雪人，Mon3骷髅/沃玛小怪，Mon6僵尸，Mon12赤月，Mon18神兽/月灵，新增怪物按序号落库并在服务端MonGen绑定
-Magic.wil～Magic10.wil：技能释放光效；Magicon1/2.wil：技能栏图标
•Npc.wil/Npc2.wil：NPC立绘与动作，Merchant.txt里Appr编号对应到此
-Objects.wil～Objects18.wil：大地图建筑、树、墙、地砖拼接物
•Tiles.wil/SmTiles2.wil：基础地图块底图
•Effect.wil/Effect_ex.wil/StateEffect.wil：城门碎裂、烟花、沙城特效、经络光环
-Hair.wil/Hair2.wil：发型、斗笠动态
•PrgUse.wil～PrgUse3.wil/UI1.wil～UI3.wil/NewopUI.pak：技能条、血条、背包框、商城面板，改界面必动
-ChrSel.wil：选人界面动画
•MMap.wil：小地图缩略图
四、PAK文件结构与加载逻辑
PAK是GOM/GEE引擎配套工具打的加密归档包，内部可塞PNG（32位真彩）、音效、文本、WIL/WZL提取件，支持密码（AES类或引擎自定义），默认放客户端\Resources\Data。总索引是客户端\Resources\Pak.txt，每行格式：
data\NewUI.pakgameofmir
Resources\
或简写NewUI.pak123456
三段分别是相对Resources的路径、密码、挂载根。密码错=整包不加载，对应界面/地图全黑。GEE另用ResInfo.txt记包内资源虚拟路径，!Setup.txt开DynamicLoad=1做按需动态载；若同目录WIL与PAK并存，PAK优先级高于WIL。
五、Resources目录标准布局
客户端根\Resources
├─Pak.txt（总加载表，必存在）
├─Data\（Items.pak、Hum.pak、Magic.pak、NewopUI.pak等）
├─Map\（新版真彩地图砖包Map0.pak等）
├─Sound\（音效pak，可选）
└─CustomData\（自定义补丁子目录，登录器配置改根时同步）
老10周年客户端无Resources，直接把WIL丢Data；13周年+/GOM/GEE必须走Resources+Pak.txt，否则登录器不认。
六、Map目录与地图文件
Map\.map记录宽高、格子阻挡、物件层、光照、单位坐标。进入地图时服务端下发地图号，客户端找本地001.map（比奇）、3.map（盟重）、015.map（沙城）等解析拼块；本地缺=黑屏/踩虚空，文件损=地块撕裂。新真彩地图常改为从Resources\Map\.pak读砖，需在Pak.txt挂包且服务端MapInfo.txt地图号一致。
七、服务端联动绑定场景
•新装备：StdItems.txt写Idx→客户端Items.wil序号；StateItem.wil加发光帧；DnItems.wil加地面图
•新怪物：MonGen.txt刷怪→MonXX.wil提供站走攻死帧，方向帧错=滑步/倒退
-新NPC：Merchant.txtAppr值→Npc.wil图片序号；特效NPC在M2“WIL资源”注册自定义包序号（建议1001+避系统1-1000）
•新技能：Magic.wil光效帧+Magicon.wil图标，Skill.txt绑定特效序号
-新地图：MapInfo.txt地图号→Map\号.map或Resources\Map\包内路径
八、覆盖安装与排错实况
补丁包解压后应是Data、Map、Resources并列覆盖到客户端根，禁止套娃成Data\Data。登录器必须放客户端根目录运行，右键快捷方式“打开文件所在位置”核对。现象对照：红问号=WIL缺帧/WIX错；黑屏地图=Map或Resources\Map包未挂；界面老样式=NewopUI.pak密码错或未进Pak.txt；装备隐形=Items.wil序号未扩或Idx错；闪退=周年客户端不匹配（10周年的WIL硬塞13周年）。多客户端共存时只看登录器指向根目录那一份。
九、常用编辑工具链
WIL编辑器（看帧、导BMP、改调色板）、GOM_Pak/GEE_Pak编辑器（打包PAK、设密码、转WIL）、HeroMirror、C3导入器、Notepad++改Pak.txt/ResInfo.txt、Hedit看文件头。改完同一资源记得清客户端Cache（部分引擎在登录器目录生成tmp），否则仍读旧帧。
传奇客户端根目录常见结构：Mir.exe/Game.exe、mir.dat、ip.dat、Data、Map、Resources、Sound、LoginGate配置等。服务端只下发坐标、动作指令、逻辑状态，所有可见画面（人物、怪物、装备、地图砖、技能光效、UI）都由客户端本地文件渲染。Data管老版散文件素材（WIL/WIX/WZL/WIS），Resources管GOM/GEE系PAK补丁包，Map管地图结构，Sound管WAV/MP3音效。
二、WIL/WIX/WZL文件本质
WIL是二进制图像库，内部顺序存多帧256色（后期WZL支持更高色深）BMP小图，文件头含魔数0x57494C、图片数量、调色板偏移、帧数据偏移，靠X/Y偏移做动画吱位。WIX是同名词索引文件，头标“#INDXv1.0-WEMADEEntertainmentinc.”，记录每张图在WIL里的起始位置与长度，客户端先查WIX再读WIL，缺WIX会定位失败出红问号。WZL是后期压缩版图像库，体积更小，13周年后客户端主力格式，和WIL互斥同名只读优先序靠前的。WIS多为补充特效库（连击、翅膀、武器发光）。
三、Data目录核心WIL/WIX对照表与实际场景
客户端\Data下常见文件对及用途：
•Hum.wil/Hum.wix：男女人物基疮作（站、走、攻、施法、死亡），换衣服外观首改这里
-HumEffect.wil：翅膀、发光衣物叠加层，合击版、单职翅膀补丁挂此
•Hum2.wil/Hum3.wil：后期服饰阶段（虎啸—辉煌—热血等）动作库
•Items.wil/Items.wix：背包内全部物品图标（金创药到屠龙），新增装备必扩此库序号
-DnItems.wil：物品掉地后的地面显示图
•StateItem.wil：装备栏内穿戴发光、镶嵌特效
•Weapon.wil/Weapon2.wis/Weapon3.wil：武器静态、挥动、连击光效
-Mon1.wil～Mon35.wil：怪物动作分库，Mon1大刀/雪人，Mon3骷髅/沃玛小怪，Mon6僵尸，Mon12赤月，Mon18神兽/月灵，新增怪物按序号落库并在服务端MonGen绑定
-Magic.wil～Magic10.wil：技能释放光效；Magicon1/2.wil：技能栏图标
•Npc.wil/Npc2.wil：NPC立绘与动作，Merchant.txt里Appr编号对应到此
-Objects.wil～Objects18.wil：大地图建筑、树、墙、地砖拼接物
•Tiles.wil/SmTiles2.wil：基础地图块底图
•Effect.wil/Effect_ex.wil/StateEffect.wil：城门碎裂、烟花、沙城特效、经络光环
-Hair.wil/Hair2.wil：发型、斗笠动态
•PrgUse.wil～PrgUse3.wil/UI1.wil～UI3.wil/NewopUI.pak：技能条、血条、背包框、商城面板，改界面必动
-ChrSel.wil：选人界面动画
•MMap.wil：小地图缩略图
四、PAK文件结构与加载逻辑
PAK是GOM/GEE引擎配套工具打的加密归档包，内部可塞PNG（32位真彩）、音效、文本、WIL/WZL提取件，支持密码（AES类或引擎自定义），默认放客户端\Resources\Data。总索引是客户端\Resources\Pak.txt，每行格式：
data\NewUI.pakgameofmir
Resources\
或简写NewUI.pak123456
三段分别是相对Resources的路径、密码、挂载根。密码错=整包不加载，对应界面/地图全黑。GEE另用ResInfo.txt记包内资源虚拟路径，!Setup.txt开DynamicLoad=1做按需动态载；若同目录WIL与PAK并存，PAK优先级高于WIL。
五、Resources目录标准布局
客户端根\Resources
├─Pak.txt（总加载表，必存在）
├─Data\（Items.pak、Hum.pak、Magic.pak、NewopUI.pak等）
├─Map\（新版真彩地图砖包Map0.pak等）
├─Sound\（音效pak，可选）
└─CustomData\（自定义补丁子目录，登录器配置改根时同步）
老10周年客户端无Resources，直接把WIL丢Data；13周年+/GOM/GEE必须走Resources+Pak.txt，否则登录器不认。
六、Map目录与地图文件
Map\.map记录宽高、格子阻挡、物件层、光照、单位坐标。进入地图时服务端下发地图号，客户端找本地001.map（比奇）、3.map（盟重）、015.map（沙城）等解析拼块；本地缺=黑屏/踩虚空，文件损=地块撕裂。新真彩地图常改为从Resources\Map\.pak读砖，需在Pak.txt挂包且服务端MapInfo.txt地图号一致。
七、服务端联动绑定场景
•新装备：StdItems.txt写Idx→客户端Items.wil序号；StateItem.wil加发光帧；DnItems.wil加地面图
•新怪物：MonGen.txt刷怪→MonXX.wil提供站走攻死帧，方向帧错=滑步/倒退
-新NPC：Merchant.txtAppr值→Npc.wil图片序号；特效NPC在M2“WIL资源”注册自定义包序号（建议1001+避系统1-1000）
•新技能：Magic.wil光效帧+Magicon.wil图标，Skill.txt绑定特效序号
-新地图：MapInfo.txt地图号→Map\号.map或Resources\Map\包内路径
八、覆盖安装与排错实况
补丁包解压后应是Data、Map、Resources并列覆盖到客户端根，禁止套娃成Data\Data。登录器必须放客户端根目录运行，右键快捷方式“打开文件所在位置”核对。现象对照：红问号=WIL缺帧/WIX错；黑屏地图=Map或Resources\Map包未挂；界面老样式=NewopUI.pak密码错或未进Pak.txt；装备隐形=Items.wil序号未扩或Idx错；闪退=周年客户端不匹配（10周年的WIL硬塞13周年）。多客户端共存时只看登录器指向根目录那一份。
九、常用编辑工具链
WIL编辑器（看帧、导BMP、改调色板）、GOM_Pak/GEE_Pak编辑器（打包PAK、设密码、转WIL）、HeroMirror、C3导入器、Notepad++改Pak.txt/ResInfo.txt、Hedit看文件头。改完同一资源记得清客户端Cache（部分引擎在登录器目录生成tmp），否则仍读旧帧。