一、WZL与WIL格式核心关联：算法通用前提
最新传奇客户端中，WZL格式本质是WIL格式的索引优化版，二者Shape值算法通用，仅文件存储结构有差异——WZL为索引与数据分离存储，WIL为单一数据文件，客户端读取时会自动适配对应算法。需明确：传统“除以1200”仅为早期武器基础算法，不适用于全品类及扩展素材，以下为适配WZL格式的完整算法。
计算前需准备工具：WIL/WZL编辑器（用于查看素材图片编号、分组及存储路径）、客户端Data文件夹（提取对应WZL文件，如Weapon.wzl、Hum.wzl）、物品数据库（核对Shape值与素材匹配关系）。
二、武器WZL格式Shape值算法（分基础与扩展素材）
1. 基础武器素材（Weapon系列WZL文件）
核心文件为Weapon.wzl、Weapon2.wzl、Weapon3.wzl，存储常规武器素材，按固定分组规则计算，无需除以1200。
算法规则：单文件内按50个Shape值为一组划分，每组对应一组武器动作素材（含攻击、站立、跑动等帧图）。具体分组：Weapon.wzl对应Shape值0-49，Weapon2.wzl对应50-74，Weapon3.wzl对应75-99。例如：Weapon.wzl中第3个武器素材，Shape值为2（从0开始计数）；Weapon2.wzl中第10个素材，Shape值为50+9=59。
补充说明：每组素材帧图数量无强制限制，无需按固定帧数折算，仅需按素材在文件内的排列顺序对应Shape值，通过编辑器查看素材排序即可精准定位。
2. 扩展武器素材（独立命名WZL文件）
新增自定义武器时，按“单武器单WZL文件”配置，存储路径为客户端\Graphics\Weapon\，Shape值从1000开始递增，算法直接关联文件名。
算法规则：WZL文件名与数据库Shape值完全一致，无需额外计算。例如：自定义武器素材文件命名为1001.wzl，对应数据库中Shape值设为1001；1020.wzl则对应Shape值1020，依次类推。该方式适用于所有引擎，无需区分分组，直接读取文件名匹配。
三、衣服WZL格式Shape值算法（含角色与扩展类）
1. 基础角色衣服（Hum系列WZL文件）
核心文件为Hum.wzl、Hum2.wzl、Hum3.wzl、Hum4.wzl，按分段规则计算，不同引擎略有差异，以主流HERO、3K引擎为例。
通用算法：Hum.wzl对应Shape值0-24，Hum2.wzl对应25-49，Hum4.wzl对应75-99；3K引擎中Hum3.wzl对应50-74，其他引擎Hum3.wzl从80开始计数。例如：3K引擎下Hum3.wzl第5个素材，Shape值为50+4=54；通用引擎下Hum3.wzl第1个素材，Shape值为80。
2. 扩展衣服素材（独立命名WZL文件）
存储路径为客户端\Graphics\Human\，同样采用“文件名对应Shape值”规则，与扩展武器逻辑一致。Shape值从1000开始，文件名与Shape值完全匹配。例如：扩展衣服素材1015.wzl，数据库中Shape值设为1015，支持男女角色通用素材，无需额外区分性别编号。
四、首饰WZL格式Shape值算法（外观与内观区分）
首饰无独立外观Shape值（不显示在人物模型上），仅需计算内观值（背包、地面、属性面板显示），对应Items系列WZL文件，内观值对应数据库Looks值，算法与Shape值逻辑互通。
1. 基础首饰素材（Items.wzl）
算法规则：按素材在Items.wzl中的图片编号直接对应Looks值，无分组限制。例如：Items.wzl中第30个首饰图片，数据库Looks值设为30，同时需确保地面显示（DnItems.wzl）、属性面板显示（StateItem.wzl）的图片编号一致，三者同步匹配Looks值。
2. 扩展首饰素材（ItemsX.wzl系列）
当首饰素材超出基础文件存储上限时，使用Items1.wzl、Items2.wzl等扩展文件，算法为“基础值+文件序号×10000”。例如：Items1.wzl中第5个首饰图片，Looks值=10000+4=10004；Items2.wzl中第12个图片，Looks值=20000+11=20011。首饰无Shape值需求，仅需按此规则配置Looks值即可正常显示。
五、引擎适配与实操注意事项
1. 引擎差异适配：HERO、3K引擎算法通用，GOM引擎扩展素材Shape值起始编号不变，仅需确保WZL文件路径正确，避免读取失败。部分引擎支持自定义起始编号，需在引擎配置文件中调整基础参数。
2. 素材排序核对：计算前必须用编辑器打开WZL文件，按素材实际排列顺序计数（从0开始），避免因素材删除、插入导致编号错位，引发Shape值匹配异常。
3. 内观外观区分：武器、衣服需配置Shape值（外观）与Looks值（内观），首饰仅需配置Looks值，无需设置Shape值，避免混淆参数导致显示异常。
4. 索引文件同步：WZL格式需确保索引文件完整，若缺失对应.wix文件（索引表），需重新生成或从完整客户端拷贝，否则无法读取素材及计算对应编号。
六、常见问题排查（算法适配异常解决）
1. 素材不显示：优先核对WZL文件路径是否正确，扩展素材需放在对应Graphics子文件夹；其次检查Shape值/ Looks值与文件名、素材编号是否一致，排除计数偏差。
2. 显示错乱：多为同一Shape值对应多个素材，或扩展素材与基础素材编号重叠，需调整扩展素材起始编号（避开0-99基础区间），确保编号唯一。
3. 引擎不兼容：部分旧引擎对扩展素材Shape值起始编号有限制，可将自定义素材文件名改为100以内，替换基础素材文件对应位置，按基础算法重新配置。
