架设传奇版本时，经常碰到补丁打进去但装备不显示、地图黑屏、怪物透明的问题，根本原因在于没搞清楚客户端、补丁和资源文件三者之间的调用关系。客户端是骨架，补丁是皮肤，资源文件是皮肤上的花纹，哪个环节没对应上，游戏画面就出不来。
**客户端版本决定引擎能读到什么**
传奇客户端从最初的1.76版本一直更新到后来的17周年、18周年版本，每个版本对资源文件的读取规则都不一样。GOM和GEE引擎建议用16周年或17周年的客户端，兼容性最好。客户端版本太低，读取不了高版本补丁里的PNG素材；版本太高，某些老旧引擎反而不认。
客户端的核心目录有这几个：
`Data`目录存放界面UI、装备、技能、怪物、NPC的基础素材。
`Map`目录存放所有地图文件，后缀是.map。
`Wav`目录存放游戏音效和背景音乐。
`Graphics`目录存放高清装备和武器外观。
客户端根目录下的`exe`文件是游戏主程序，登录器生成之后会调用这个主程序来加载资源。
**补丁的安装路径和优先级**
补丁本质上是客户端里没有的额外资源文件，通常由版本开发者制作。补丁的正确安装路径是直接解压到客户端根目录，让补丁文件夹和Data、Map这些文件夹平级。补丁文件夹的名字不固定，版本开发者可以自定义，但登录器配置器里设置的补读取目录必须和这个文件夹名字一致。
补丁的优先级高于客户端本身的资源。引擎读取一个素材的时候，会先去补丁文件夹里找，如果找不到，再去客户端的Data和Graphics文件夹里找。这个优先级顺序决定了补丁可以覆盖原版客户端里的任何素材，实现装备替换、界面美化这些功能。
补丁目录结构往往和客户端目录结构对应。比如补丁文件夹里有一个`Data`子目录，那这个`Data`里放的就是补丁素材；补丁文件夹里有一个`Graphics`子目录，那就对应客户端的`Graphics`文件夹。如果补丁文件夹里直接放`Items`、`Monsters`、`Weapon`这些子目录，那它们对应的是`Graphics`目录下的分类资源。
**WIL文件：老版本的核心资源格式**
WIL是传奇早期使用的资源文件格式，把大量图片打包进一个文件里，附带一个同名的.WIX索引文件记录每张图片的位置和大小。WIL文件的读取靠的是图片在文件里的序号，从0开始编号。比如某个装备的外观在Weapon.wil里的第1200张图到第1300张图，引擎通过索引号来调用。
WIL文件最大的限制是图片数量上限，一个WIL文件最多放65535张图，而且图片尺寸越大，文件体积膨胀得越快。老版本的WIL文件通常不压缩，文件体积很大，加载速度慢。
WIL文件存放在客户端的Data目录下。常见的WIL文件有这些：
`Items.wil`存放地上掉落的物品小图标。
`DnItems.wil`存放背包里的物品图标。
`StateItem.wil`存放装备栏里的物品图标。
`Weapon.wil`存放武器外观。
`Hum.wil`存放人物衣服外观。
`Monster.wil`存放怪物外观。
`Magic.wil`存放技能特效。
`Prguse.wil`存放游戏界面的UI素材。
`mmap.wil`存放小地图图片。
**WZL和WZX：压缩版WIL的变种**
WZL文件是WIL的压缩版本，把图片数据压缩后存储，体积比WIL小很多，读取速度也更快。WZL文件附带一个.WZX索引文件。引擎读取WZL文件时不需要解压全部数据，只读取当前需要的图片，内存占用更低。
GOM和GEE引擎都支持WZL格式，但老版本引擎可能不认。如果发现装备显示不出来，可以尝试把WZL转换成WIL格式再试。
**PAK文件：GOM引擎的自定义加密格式**
PAK是GOM引擎引入的加密资源格式，本质上是把图片素材打包后加了一层密码保护。每个PAK文件都有一个对应的密码，登录器配置器里需要正确填写密码才能读取里面的素材。
PAK文件最大的特点是支持密码读取，版本开发者可以给不同的PAK文件设不同密码，防止素材被轻易盗用。同时PAK文件内部结构比WIL更灵活，支持PNG格式的透明图片，可以做更精细的装备和界面效果。
PAK文件存放在客户端根目录下的自定义补丁文件夹里，目录结构通常是`补丁文件夹\Data\`或者`补丁文件夹\Graphics\Weapon\`。登录器配置器里有一个PAK密码设置界面，每一行对应一个PAK文件的路径和密码。配置正确时文件状态显示为蓝色，密码错误或路径不对时显示红色。
PAK文件读取失败的情况经常发生，原因是密码不匹配或者路径不对。版本开发者给的补丁包里通常会附带一个`pak.txt`文件，里面记录了所有PAK文件的密码。把这个文件导入登录器配置器就可以批量配置。如果手动配置，路径要写相对路径，不能写绝对路径。
**资源调用流程：从物品数据到画面显示**
整个资源调用的流程是这样的：
玩家在游戏里看到一件装备，引擎从数据库里读取这件装备的Looks值。这个值是一个数字编号，指向资源文件里的某一张或某一组图片。
引擎根据Looks值先去补丁文件夹里找对应的PAK文件，如果找到了就用PAK里的图片。
如果补丁文件夹里没有，引擎再去客户端Data目录下的WIL文件里找。
找到图片之后，引擎根据装备的位置（武器、衣服、头盔、戒指等）调用对应的资源类型，把图片渲染到角色身上或者背包里。
地图的调用流程类似：引擎从MapInfo.txt里读取地图编号，然后去Map目录下找对应的.map文件，地图文件的内部信息记录了需要加载哪些地面贴图和建筑贴图，引擎再去WIL或PAK文件里调取这些贴图渲染到屏幕上。
**常见资源缺失的原因和排查方法**
装备不显示成红色叉号或者空白，原因是Looks值对应的资源文件不存在或者读取失败。排查时先确认补丁是否已经解压到客户端根目录且文件夹名称正确，再打开登录器配置器检查PAK密码是否全部显示为蓝色，最后查看数据库里该物品的Looks值是否和补丁文件里的编号对应得上。
怪物透明或显示成稻草人，原因是Monster.wil或者自定义怪物PAK文件缺失。检查补丁文件夹里是否有怪物相关的PAK文件，密码是否正确，数据库里怪物的Appr值是否指向正确的图片组。
地图黑屏，原因是地图文件或者地面贴图缺失。把服务端MirServer\Mir200\Map文件夹里的所有.map文件复制到客户端的Map目录和补丁的Map目录里，如果还不行，检查地图补丁里的地面贴图PAK文件是否完整。
NPC不显示外观，原因是NPC.wil或者自定义NPC的PAK文件缺失。检查补丁文件夹里是否有NPC相关的资源，数据库里NPC的Appr值是否正确。
**WIL和PAK之间的转换与处理**
有些素材只有WIL格式，想转成PAK格式用，需要用专门的WIL编辑器导出图片再重新打包成PAK。反过来，如果引擎不认PAK，可以用PAK解压工具把图片提取出来，再用WIL打包工具打包成WIL。
转换过程中要注意图片坐标的问题。装备外观图在WIL和PAK里的坐标偏移量可能不一样，直接转换会导致装备穿在身上位置偏移。需要用素材编辑器调整坐标参数，让图片在角色身上的显示位置正常。
图库合并是另一个常用操作。版本里引用了多个WIL文件，可以把它们合并成一个大的PAK文件，减少文件数量，提高读取效率。合并时要注意图片索引不能重叠，否则会出现素材串号的问题。
**客户端版本决定引擎能读到什么**
传奇客户端从最初的1.76版本一直更新到后来的17周年、18周年版本，每个版本对资源文件的读取规则都不一样。GOM和GEE引擎建议用16周年或17周年的客户端，兼容性最好。客户端版本太低，读取不了高版本补丁里的PNG素材；版本太高，某些老旧引擎反而不认。
客户端的核心目录有这几个：
`Data`目录存放界面UI、装备、技能、怪物、NPC的基础素材。
`Map`目录存放所有地图文件，后缀是.map。
`Wav`目录存放游戏音效和背景音乐。
`Graphics`目录存放高清装备和武器外观。
客户端根目录下的`exe`文件是游戏主程序，登录器生成之后会调用这个主程序来加载资源。
**补丁的安装路径和优先级**
补丁本质上是客户端里没有的额外资源文件，通常由版本开发者制作。补丁的正确安装路径是直接解压到客户端根目录，让补丁文件夹和Data、Map这些文件夹平级。补丁文件夹的名字不固定，版本开发者可以自定义，但登录器配置器里设置的补读取目录必须和这个文件夹名字一致。
补丁的优先级高于客户端本身的资源。引擎读取一个素材的时候，会先去补丁文件夹里找，如果找不到，再去客户端的Data和Graphics文件夹里找。这个优先级顺序决定了补丁可以覆盖原版客户端里的任何素材，实现装备替换、界面美化这些功能。
补丁目录结构往往和客户端目录结构对应。比如补丁文件夹里有一个`Data`子目录，那这个`Data`里放的就是补丁素材；补丁文件夹里有一个`Graphics`子目录，那就对应客户端的`Graphics`文件夹。如果补丁文件夹里直接放`Items`、`Monsters`、`Weapon`这些子目录，那它们对应的是`Graphics`目录下的分类资源。
**WIL文件：老版本的核心资源格式**
WIL是传奇早期使用的资源文件格式，把大量图片打包进一个文件里，附带一个同名的.WIX索引文件记录每张图片的位置和大小。WIL文件的读取靠的是图片在文件里的序号，从0开始编号。比如某个装备的外观在Weapon.wil里的第1200张图到第1300张图，引擎通过索引号来调用。
WIL文件最大的限制是图片数量上限，一个WIL文件最多放65535张图，而且图片尺寸越大，文件体积膨胀得越快。老版本的WIL文件通常不压缩，文件体积很大，加载速度慢。
WIL文件存放在客户端的Data目录下。常见的WIL文件有这些：
`Items.wil`存放地上掉落的物品小图标。
`DnItems.wil`存放背包里的物品图标。
`StateItem.wil`存放装备栏里的物品图标。
`Weapon.wil`存放武器外观。
`Hum.wil`存放人物衣服外观。
`Monster.wil`存放怪物外观。
`Magic.wil`存放技能特效。
`Prguse.wil`存放游戏界面的UI素材。
`mmap.wil`存放小地图图片。
**WZL和WZX：压缩版WIL的变种**
WZL文件是WIL的压缩版本，把图片数据压缩后存储，体积比WIL小很多，读取速度也更快。WZL文件附带一个.WZX索引文件。引擎读取WZL文件时不需要解压全部数据，只读取当前需要的图片，内存占用更低。
GOM和GEE引擎都支持WZL格式，但老版本引擎可能不认。如果发现装备显示不出来，可以尝试把WZL转换成WIL格式再试。
**PAK文件：GOM引擎的自定义加密格式**
PAK是GOM引擎引入的加密资源格式，本质上是把图片素材打包后加了一层密码保护。每个PAK文件都有一个对应的密码，登录器配置器里需要正确填写密码才能读取里面的素材。
PAK文件最大的特点是支持密码读取，版本开发者可以给不同的PAK文件设不同密码，防止素材被轻易盗用。同时PAK文件内部结构比WIL更灵活，支持PNG格式的透明图片，可以做更精细的装备和界面效果。
PAK文件存放在客户端根目录下的自定义补丁文件夹里，目录结构通常是`补丁文件夹\Data\`或者`补丁文件夹\Graphics\Weapon\`。登录器配置器里有一个PAK密码设置界面，每一行对应一个PAK文件的路径和密码。配置正确时文件状态显示为蓝色，密码错误或路径不对时显示红色。
PAK文件读取失败的情况经常发生，原因是密码不匹配或者路径不对。版本开发者给的补丁包里通常会附带一个`pak.txt`文件，里面记录了所有PAK文件的密码。把这个文件导入登录器配置器就可以批量配置。如果手动配置，路径要写相对路径，不能写绝对路径。
**资源调用流程：从物品数据到画面显示**
整个资源调用的流程是这样的：
玩家在游戏里看到一件装备，引擎从数据库里读取这件装备的Looks值。这个值是一个数字编号，指向资源文件里的某一张或某一组图片。
引擎根据Looks值先去补丁文件夹里找对应的PAK文件，如果找到了就用PAK里的图片。
如果补丁文件夹里没有，引擎再去客户端Data目录下的WIL文件里找。
找到图片之后，引擎根据装备的位置（武器、衣服、头盔、戒指等）调用对应的资源类型，把图片渲染到角色身上或者背包里。
地图的调用流程类似：引擎从MapInfo.txt里读取地图编号，然后去Map目录下找对应的.map文件，地图文件的内部信息记录了需要加载哪些地面贴图和建筑贴图，引擎再去WIL或PAK文件里调取这些贴图渲染到屏幕上。
**常见资源缺失的原因和排查方法**
装备不显示成红色叉号或者空白，原因是Looks值对应的资源文件不存在或者读取失败。排查时先确认补丁是否已经解压到客户端根目录且文件夹名称正确，再打开登录器配置器检查PAK密码是否全部显示为蓝色，最后查看数据库里该物品的Looks值是否和补丁文件里的编号对应得上。
怪物透明或显示成稻草人，原因是Monster.wil或者自定义怪物PAK文件缺失。检查补丁文件夹里是否有怪物相关的PAK文件，密码是否正确，数据库里怪物的Appr值是否指向正确的图片组。
地图黑屏，原因是地图文件或者地面贴图缺失。把服务端MirServer\Mir200\Map文件夹里的所有.map文件复制到客户端的Map目录和补丁的Map目录里，如果还不行，检查地图补丁里的地面贴图PAK文件是否完整。
NPC不显示外观，原因是NPC.wil或者自定义NPC的PAK文件缺失。检查补丁文件夹里是否有NPC相关的资源，数据库里NPC的Appr值是否正确。
**WIL和PAK之间的转换与处理**
有些素材只有WIL格式，想转成PAK格式用，需要用专门的WIL编辑器导出图片再重新打包成PAK。反过来，如果引擎不认PAK，可以用PAK解压工具把图片提取出来，再用WIL打包工具打包成WIL。
转换过程中要注意图片坐标的问题。装备外观图在WIL和PAK里的坐标偏移量可能不一样，直接转换会导致装备穿在身上位置偏移。需要用素材编辑器调整坐标参数，让图片在角色身上的显示位置正常。
图库合并是另一个常用操作。版本里引用了多个WIL文件，可以把它们合并成一个大的PAK文件，减少文件数量，提高读取效率。合并时要注意图片索引不能重叠，否则会出现素材串号的问题。