一、cbohum 文件本质与分组规则
cbohum.wil / cbohum.wzl 存放的是人物穿着不同衣服释放连击、倚天辟地、骑马等扩展动作的资源，不是普通 hum.wil（普通 hum 每套模型 600 张，8 方向 × 各动作帧）。连击动作采用“分组制”：
- 官方基础规则：衣服类每 1 组 = 2000 张图片，不区分男女；武器类每 1 组 = 4000 张图片，区分男女（男 0–1999，女 2000–3999）。
• 文件命名延续：cbohum.wil（裸体–辉煌时段衣服）、cbohum3.wzl（主宰–热血时段衣服），编号 cbohum1、cbohum2…cbohum30 依次向后排，每组 2000 张。
- 引擎读取偏移公式（衣服）：起始帧 = (EXPAND3值 - 1) × 2000 ；若 EXPAND3=0 或留空，读官方 cbohumN.wzl 原组（0–1999）。
例：数据库衣服记录 Expand3=3 → 连击动作读 cbohumdiy.wzl 或 cbohum3.wzl 内第 4000–5999 张；Expand3=1 → 读 0–1999 张。
- 武器公式：起始帧 = (Expand3值 - 1) × 4000 ；男角色用 0–1999 偏移段，女角色用 2000–3999 偏移段；Expand3 范围 1–15。
二、组内连击 / 倚天辟地帧段划分
在任意一组 2000 张图内部，动作区段固定：
• 0–399 ：常规连击动作（8 方向排列，每方向约 50 帧，含起手、挥击、收招）
• 400–599 ：倚天辟地技能动作段（官方约定位置，DIY 补丁必须按此摆放，否则放技能时调用空白帧）
- 600–1999 ：预留（骑马、翅膀特效关联帧、其他扩展技能）
计算某职业某方向具体帧号：
方向序号（0=下、1=左下、2=左、3=左上、4=上、5=右上、6=右、7=右下，不同引擎可能镜像）
单方向帧数 = 50（以官方 cbohum 实测为准，部分版本 48 或 64）
目标帧 = 组起始帧 + 动作段起点 + 方向序号 × 单方向帧数 + 帧内序号
例：战士男、Expand3=2、倚天辟地、方向=右(6)、帧内第 3 张
组起始 = (2-1)×2000 = 2000
动作段起点 = 400
方向偏移 = 6×50 = 300
帧号 = 2000 + 400 + 300 + 3 = 2703 （在 cbohum2.wzl 中定位第 2703 张）
三、StdItem.DB / DBC 字段联动计算
• 衣服表字段 Expand3（或 ExpAnd3、EffectValue 视引擎而定）：决定调哪一组 cbohum。0 = 官方原版连击；1–30 = 对应 cbohumdiy / cbohum1～cbohum30。
- Shape 字段：决定普通 hum 模型组（每 1200 或 600 一张表切换男女），与普通站立走跑关联；cbohum 不参与 Shape 计算，只认 Expand3。
• 武器表 Expand3：1–15 对应 cboweapondiy.wzl 组号，连击挥武器动作同步切换；若武器要带发光特效，还需配套 cboweaponeffectdiy.wzl，帧偏移与武器组完全一致。
- 衣服特效文件 cboHumEffectdiy.wzl / cboHumEffectN.wzl：顺序与 cbohum 分组一一对应，翅膀、光效帧号 = 同组同偏移。
四、DIY 补丁导入时的实算流程
1. 用 Wil/Wzl 编辑器打开官方 cbohum.wzl，导出 0–1999 张作为模板结构。
2. 替换内部图片，保持 8 方向顺序、每方向帧数、400–599 倚天辟地段不变。
3. 存为新文件 cbohumdiy.wzl（或 cbohum19.wzl 之类）。
4. 数据库目标衣服 Expand3 设为对应序号（如存 diy 且引擎认 1=diy，则填 1）。
5. 引擎参数确认：M2 → 参数设置 → 连击/扩展动作 → 勾选“启用 cbo 系列补丁”，衣服分组上限填 30，武器填 15。
6. 客户端 Data 目录放入 cbohumdiy.wzl + cboHumEffectdiy.wzl，登录器资源列表勾选该 wzl。
五、常见算错导致显示异常的现象
• 放连击变另一件衣服：Expand3 写的组号和补丁文件实际组号不匹配，或 cbohum19.wzl 实际存的是 2000–3999 却当 0–1999 调。
- 倚天辟地黑屏/定帧：DIY 图里 400–599 段没按官方摆，引擎调到空帧。
• 男女反串：武器补丁没分男女偏移，女号读了男 0–1999 段。
• 骑马无动作：骑马帧在 600 之后，DIY 只做了 0–599，后续未补。
- 老引擎（非 GOM/GEE/HeroM2 新核）不认 Expand3：只能走官方 cbohum.wil 固定组，不能自定义分组，强行改库无效。
六、快速验算对照表
衣服 Expand3=0 → 官方 cbohum.wzl 0–1999
衣服 Expand3=1 → diy 组 0–1999 / cbohum1 组
衣服 Expand3=5 → 偏移 8000–9999
衣服 Expand3=30 → 偏移 58000–59999
武器 Expand3=1 → 男 0–1999 / 女 2000–3999（cboweapondiy.wzl）
武器 Expand3=15 → 偏移 56000–59999（男）、58000–61999（女）
倚天辟地固定段 = 每组内 400–599，不受 Expand3 影响，只受组起始偏移影响。
帧率与播放速度不在 cbohum 图内计算，由引擎 ActSerieHit 动作表控制（start、frame、skip、ftime），改图只改外观，不改出招节奏；要调动速度去改服务端动作配置，不在这里算。
