自定义内容
给物品配置光柱
面向需要给物品增加自定义光柱效果的读者，说明怎样配置素材映射、填写物品字段，并完成客户端更新与结果验证。
给物品增加光柱时，通常要同时处理素材映射、物品字段和客户端资源更新。
如果光柱素材已经准备好，但还不确定先改哪一部分，可按下面的顺序完成配置。
配置前先确认什么
- 光柱素材文件先准备好
~cui.txt和目标物品的item表记录先确认可以修改- 客户端实际使用的资源目录先确认可以同步更新
第一步：在 ~cui.txt 中配置素材映射
物品光柱不是直接在物品表里写资源路径，而是先通过 ~cui.txt 建立映射编号。
光柱素材通常放在 ~gz.wzl 这类资源文件中，先把它按编号登记到 ~cui.txt：
~cui.txt
1 ./data/~gz.wzl
这里先确认两件事：
- 前面的编号是后续物品表要引用的起始索引
- 后面的文件路径必须能在客户端实际读取到
需要先看完整格式时，可参考 ~cui.txt。
第二步：在 item 表中填写字段
完成素材映射后，再到 item 表处理对应物品。
这里至少要关注三个字段：
| 字段 | 用途 |
|---|---|
FrameStart | 光柱资源的开始索引 |
FrameCount | 光柱图片数量 |
AuroraImgID | 光柱素材 ID，对应 ~cui.txt 中定义的素材编号 |
填写时可直接按下面的方式理解：
FrameStart对应~cui.txt中准备给这组光柱使用的起始编号（光柱起始图片号）FrameCount表示这组光柱一共要使用多少张图片AuroraImgID对应~cui.txt中登记的那条素材映射 ID
如果这里填错，常见结果通常有三种：
- 光柱完全不显示
- 光柱只显示一部分
- 光柱显示错位，实际读到了别的资源
第三步：更新客户端资源
只改配置不更新资源，通常不会得到正确结果。
如果你的光柱素材是通过 lui.pkg 维护的，更新后还要确认客户端实际使用的 data 目录已经同步到最新版本；否则即使 ~cui.txt 和 item 表都写对了，客户端也可能仍然读到旧资源。
排查时应优先检查这一点，不要先判断成字段失效。
最后怎么验证
第一次验证时，先看下面 4 个结果：
- 目标物品是否真的出现了光柱
- 光柱帧数是否完整，没有缺帧或只显示部分图片
- 光柱资源是否对得上当前物品，没有串到别的资源
- 更新后的客户端是否真的已经加载到新资源
只要这 4 项里有一项不成立，就先回查映射编号、图片数量和客户端资源同步。
跑不通时先查哪里
如果光柱完全不显示，优先检查：
~cui.txt是否已经加入对应映射记录FrameStart是否引用了正确的起始编号- 客户端是否真的拿到了新资源文件
如果光柱显示不完整，优先检查：
FrameCount是否和实际图片数量一致- 起始编号之后的资源是否连续可用
如果光柱显示错位，优先检查：
FrameStart是否指向了别的素材区间- 同一段编号是否已经被其他素材占用