传奇自定义职业素材扩展读取规则详解

摘要：详解传奇自定义职业素材分段扩展读取规则，包含衣服、盾牌、发型、斗笠的外观配置逻辑，说明JPK/WZL文件读取优先级与新老版本兼容配置方法。…

一、自定义职业素材基础读取规则

传奇服务端自定义职业素材采用分段式文件读取逻辑，按固定数量区间拆分素材文件，数字序号依次递增，序号前禁止补0，该规则适用于所有职业外观类素材调用。

素材文件分段分配标准：

第一个文件：承载0-99号素材，共计100件

第二个文件：承载100-149号素材，共计50件

第三个文件：承载150-199号素材，共计50件

后续文件均按照每次递增50个素材编号的规则顺延拆分

二、职业衣服素材读取实例说明

职业衣服素材遵循上述分段读取规则，同时设置双格式优先读取机制，优先加载JPK格式文件，文件缺失时自动兼容WZL格式文件，具体路径与区间对应关系如下：

1. 素材区间0-99（100件）：主路径Resources\Graphics\Human\humcj.JPK，文件不存在时，自动读取备用路径data\humcj.Wzl

2. 素材区间100-149（50件）：主路径Resources\Graphics\Human\humcj2.JPK，文件不存在时，自动读取备用路径data\humcj2.Wzl

3. 素材区间150-199（50件）：主路径Resources\Graphics\Human\humcj3.JPK，文件不存在时，自动读取备用路径data\humcj3.Wzl

所有衣服素材文件序号按规则递增，严禁在数字序号前添加前缀0，避免服务端读取失效。

三、多类型职业素材扩展适配规则

3.1 职业盾牌外观扩展规则

自定义职业盾牌外观新增双重算法支持，包含Shape外观算法、Anicount外观特效算法，整体沿用前文素材分段扩展读取规则，无需单独配置读取逻辑，直接适配分段文件调用机制。

3.2 职业发型ID读取规则

职业发型ID全面兼容素材扩展读取规则，采用差异化调用逻辑：通用配置包中填写发型包名时，自动执行分段扩展读取规则；未填写发型包名时，保留原版盛大默认顺序读取，兼顾新老版本兼容性。

3.3 职业斗笠外观扩展规则

自定义职业斗笠外观支持Shape外观算法，调用逻辑与发型素材保持一致：通用包填入斗笠包名后，启用分段扩展读取规则；无包名配置时，沿用老版盛大读取顺序，降低版本迁移配置成本。

四、配置核心注意事项

1. 所有素材文件递增序号必须为纯数字，禁止前置补0，防止路径识别错误

2. JPK为优先读取格式，仅主文件缺失时才会触发WZL备用文件读取

3. 发型、斗笠、盾牌素材无需单独编写读取脚本，启用扩展规则仅需在通用包填写对应包名即可

4. 分段素材固定遵循100件、50件、50件的初始区间规则，后续区间统一按50件递增