工程参考/配置文件/Public/EquipVisual.txt
EquipVisual.txt 按装备基础表的外观编号，列出最多十个可选择的外形。第一列用来找列表，第 2..11 列才是候选外形；Lua 函数的选择参数又是 0..9 的位置序号。这三类数字不能混用。
文件位置与生效
| 项目 | 说明 |
|---|---|
| 运行文件 | ../Public/Config/EquipVisual.txt，相对于 Server 工作目录；客户端另有同名资源。
|
| 读取程序 | Server 游戏进程与 Game.exe 客户端资源 |
| 生效方法 | 正常保存并停服后更新各 Server 的表，重启 Server；同步客户端同名资源后重启 Game.exe。当前检索范围未发现本表可用的单独重载入口。 |
| 样本格式 | GB18030-compatible，CRLF。保留原编码；源码读取器不会自动把中文转为 UTF-8。
|
固定 12 列 INT，至少一行。Server 按第一列二分查找，文件必须数值递增且唯一；加载器不替你排序。
两端各改哪里
Server 读取 ../Public/Config 中的文件，路径相对于它的工作目录。玩家电脑按 Client/Bin/FairyResources.cfg 的 [General] 更新同名资源：FileSystem=*../Data/Config 对应 Client/Data/Config 中的散文件，AxpFileSystem=../Data/Config.axp 对应资源包内成员。保留现有打包与编码方式。源码 resources 里的文件是样本，修改样本不会自动部署到两端。
文件格式
首行是类型行：INT INT INT INT INT INT INT INT INT INT INT INT；第二行是列名行，程序跳过其内容；从第三行开始读取数据。各列用真实 Tab 分隔，保留首列、空列及行尾，不用空格代替。数据行行首 # 表示注释，分号不是此表的注释规则。首列为空的行被跳过；不足的尾列补为空值，多余列不参与本页字段读取。空整数和非数字经 atoi 可能成为 0，空字符串仍为空，不把解析成功当作业务合法。第一列须唯一，重复会触发读取器错误。
字段详解
列号从 1 开始，源码列下标从 0 开始。
| 字段与类型 | 含义与修改要点 | 缺项或特殊值 |
|---|---|---|
第 1 列INT：装备外形ID，列表查询键 |
对应 EquipBase.txt 中的 Visual 字段；不是 EquipBase 第一列物品编号。Server 从装备模板的 m_Visual 查本表，客户端也从装备模板的 nVisualID 查本表；不以物品当前变形后的外观再次选表。 | 保留与基础表对应的既有编号。客户端当前外观界面拒绝基础 Visual 小于 10000 的装备；只在这里新增一行不会自动开放界面或添加模型。 |
第 2 列INT：ID_1，第 1 个候选 |
服务端 LuaFnChangeVisual 的第 5 个参数为 0 时取本列；客户端外观列表的“可变外形1”对应它。该值是外观资源号，不是物品模板号或背包格。 | -1 表示该候选不可用，客户端不列出，服务端返回 -5。0/空值不等于禁用；其他负数也不被同样拒绝。只保留已验证可用的既有外观或 -1。 |
第 3 列INT：ID_2，第 2 个候选 |
服务端 LuaFnChangeVisual 的第 5 个参数为 1 时取本列；客户端外观列表的“可变外形2”对应它。该值是外观资源号，不是物品模板号或背包格。 | -1 表示该候选不可用，客户端不列出，服务端返回 -5。0/空值不等于禁用；其他负数也不被同样拒绝。只保留已验证可用的既有外观或 -1。 |
第 4 列INT：ID_3，第 3 个候选 |
服务端 LuaFnChangeVisual 的第 5 个参数为 2 时取本列；客户端外观列表的“可变外形3”对应它。该值是外观资源号，不是物品模板号或背包格。 | -1 表示该候选不可用，客户端不列出，服务端返回 -5。0/空值不等于禁用；其他负数也不被同样拒绝。只保留已验证可用的既有外观或 -1。 |
第 5 列INT：ID_4，第 4 个候选 |
服务端 LuaFnChangeVisual 的第 5 个参数为 3 时取本列；客户端外观列表的“可变外形4”对应它。该值是外观资源号，不是物品模板号或背包格。 | -1 表示该候选不可用，客户端不列出，服务端返回 -5。0/空值不等于禁用；其他负数也不被同样拒绝。只保留已验证可用的既有外观或 -1。 |
第 6 列INT：ID_5，第 5 个候选 |
服务端 LuaFnChangeVisual 的第 5 个参数为 4 时取本列；客户端外观列表的“可变外形5”对应它。该值是外观资源号，不是物品模板号或背包格。 | -1 表示该候选不可用，客户端不列出，服务端返回 -5。0/空值不等于禁用；其他负数也不被同样拒绝。只保留已验证可用的既有外观或 -1。 |
第 7 列INT：ID_6，第 6 个候选 |
服务端 LuaFnChangeVisual 的第 5 个参数为 5 时取本列；客户端外观列表的“可变外形6”对应它。该值是外观资源号，不是物品模板号或背包格。 | -1 表示该候选不可用，客户端不列出，服务端返回 -5。0/空值不等于禁用；其他负数也不被同样拒绝。只保留已验证可用的既有外观或 -1。 |
第 8 列INT：ID_7，第 7 个候选 |
服务端 LuaFnChangeVisual 的第 5 个参数为 6 时取本列；客户端外观列表的“可变外形7”对应它。该值是外观资源号，不是物品模板号或背包格。 | -1 表示该候选不可用，客户端不列出，服务端返回 -5。0/空值不等于禁用；其他负数也不被同样拒绝。只保留已验证可用的既有外观或 -1。 |
第 9 列INT：ID_8，第 8 个候选 |
服务端 LuaFnChangeVisual 的第 5 个参数为 7 时取本列；客户端外观列表的“可变外形8”对应它。该值是外观资源号，不是物品模板号或背包格。 | -1 表示该候选不可用，客户端不列出，服务端返回 -5。0/空值不等于禁用；其他负数也不被同样拒绝。只保留已验证可用的既有外观或 -1。 |
第 10 列INT：ID_9，第 9 个候选 |
服务端 LuaFnChangeVisual 的第 5 个参数为 8 时取本列；客户端外观列表的“可变外形9”对应它。该值是外观资源号，不是物品模板号或背包格。 | -1 表示该候选不可用，客户端不列出，服务端返回 -5。0/空值不等于禁用；其他负数也不被同样拒绝。只保留已验证可用的既有外观或 -1。 |
第 11 列INT：ID_10，第 10 个候选 |
服务端 LuaFnChangeVisual 的第 5 个参数为 9 时取本列；客户端外观列表的“可变外形10”对应它。该值是外观资源号，不是物品模板号或背包格。 | -1 表示该候选不可用，客户端不列出，服务端返回 -5。0/空值不等于禁用；其他负数也不被同样拒绝。只保留已验证可用的既有外观或 -1。 |
第 12 列INT：Item_ID |
样本为 30900004（变形符）。Server 保存到名为 nCost 的成员，客户端保存为 nItemID；当前检索未发现外观业务读取这两个成员来决定消耗。名称 nCost 不说明单位为金币。 | 保留原值。当前客户端与服务端业务脚本分别固定检查 30900004，改本列不能单独替换材料，也不能改变金币费用。 |
常用修改实例
示例为局部教学片段，先备份原运行文件，再修改对应行并保留其余配置。教学值不是程序默认值。 以下代码块保留真实 Tab；本地示例文件保留原样本编码、中文表头与 CRLF。网页文字使用浏览器编码显示，不表示运行文件应改存 UTF-8。
关闭既有外观列表的第十个候选
修改前：
INT INT INT INT INT INT INT INT INT INT INT INT 装备外形ID ID_1 ID_2 ID_3 ID_4 ID_5 ID_6 ID_7 ID_8 ID_9 ID_10 Item_ID 10001 2 3 4 5 6 7 8 9 10 11 30900004
修改后：
INT INT INT INT INT INT INT INT INT INT INT INT 装备外形ID ID_1 ID_2 ID_3 ID_4 ID_5 ID_6 ID_7 ID_8 ID_9 ID_10 Item_ID 10001 2 3 4 5 6 7 8 9 10 -1 30900004
在原表第一列找到 10001，只把第 11 列 ID_10 从 11 改为 -1。保留 ID_1..ID_9 的 2..10、末列 30900004、全部其他行和表头。当前 EquipBase 样本中 10443901“变形测试衣”的 Visual 为 10001，适合作为隔离验证用的已有模板；物品编号 10443901 不能写进本表第一列。同步两端后，外观界面应保留前九个候选、隐藏第十个；服务端选择序号 9 应返回 -5。此修改不创建装备或资源，不改变已经保存为外观 11 的旧物品。三行示例不能覆盖整表。
验证与排查
检查 InitItemVisualTable() Ok!、12 列及第一列递增唯一；确认示例只改第 11 列。使用基础 Visual=10001 的隔离测试装备，检查候选列表和前九项预览，确认第十项隐藏；验证服务端拒绝已禁用序号、重登后既有外观保持。恢复时停服还原两端表并重启；恢复候选列表不会把已变形的物品改回原外观。新增模型、性别和装备部位的兼容性需要另行实测。
选择序号与资源编号
第一列 10001 查出一行，选择序号 0 读取 ID_1=2，序号 9 读取 ID_10。服务端写入前反复对大于 1000 的值减 1000，例如 1001 变为 1、2000 变为 1000；1000 本身不变。这不是普通的取模公式。客户端列表返回的是原候选值，不能据这种归一化规则随意拼造新资源编号。
材料和金币由谁处理
现有客户端 EquipChange.lua 固定接受变形符 30900004，并显示装备等级*20000 的费用。Server 的 Script.dat 将脚本 809264 映射到 event/equip/equip_changevisual.lua：脚本检查材料模板与现金，费用取 GetBagItemLevel 的结果*20000，调用 LuaFnChangeVisual 成功后再调用扣钱和删除材料格。以铜为单位，20000 铜=2 金；暗器有效等级与客户端显示可能不同，参见 GetBagItemLevel。
LuaFnChangeVisual 本身只检查两个格的基本可用状态并修改外观，不核对材料是否为 30900004，不扣钱、不删材料，也不按第 12 列执行消耗。脚本扣款和删除结果没有组成可回滚事务；不能将本函数当作完整收费服务直接开放。材料删除调用删除整个选中格，不应放入一整组用于验证。
已有物品
表格控制候选列表；物品当前外观另行保存。禁用某个候选只影响之后的选择，不批量恢复旧物品。成功后重登、穿脱和其他玩家看到的模型仍需要实测。
关联与依据
Public/EquipExtraAttr.txt · Public/CommonItem.txt
其他配置及整理状态 · 服务端外网设置 · Lua 接口索引
Common/DataBase/TLBB_DBC.cpp：实际加载、解析、字段使用或示例关联依据Common/DataBase/TLBB_DBC.h：实际加载、解析、字段使用或示例关联依据Common/ServerBase/FileDef.h：实际加载、解析、字段使用或示例关联依据Common/GameStruct_Item.h：实际加载、解析、字段使用或示例关联依据Common/GameStruct.cpp：实际加载、解析、字段使用或示例关联依据Common/GameDefine_Item.h：实际加载、解析、字段使用或示例关联依据Server/Server/GameServer/Server/Item/ItemTable.cpp：实际加载、解析、字段使用或示例关联依据Server/Server/GameServer/Server/Item/ItemTable.h：实际加载、解析、字段使用或示例关联依据Server/Server/GameServer/Server/Item/ItemOperator.cpp：实际加载、解析、字段使用或示例关联依据Server/Server/GameServer/Server/Item/ItemContainer.cpp：实际加载、解析、字段使用或示例关联依据Server/Server/GameServer/Server/Script/LuaFnTbl_Ability.h：实际加载、解析、字段使用或示例关联依据Server/Server/GameServer/Server/Script/LuaFnRegister.cpp：实际加载、解析、字段使用或示例关联依据Client/Client/Game/DBC/GMDataBase.cpp：实际加载、解析、字段使用或示例关联依据Client/Client/Common/TDDBC_Struct.h：实际加载、解析、字段使用或示例关联依据Client/Client/Game/Interface/GMGameInterface_Script_LifeAbility.cpp：实际加载、解析、字段使用或示例关联依据Client/Client/Render/ResourceProvider.cpp：实际加载、解析、字段使用或示例关联依据Client/Client/Render/RenderSystem.cpp：实际加载、解析、字段使用或示例关联依据Client/Client/Core/Core/FairySystem.cpp：实际加载、解析、字段使用或示例关联依据resources/Client/Bin/FairyResources.cfg：实际加载、解析、字段使用或示例关联依据resources/Client/Bin/FairyResources正式服.cfg：实际加载、解析、字段使用或示例关联依据resources/Public/Data/Script.dat：实际加载、解析、字段使用或示例关联依据resources/Public/Data/Script/event/equip/equip_changevisual.lua：实际加载、解析、字段使用或示例关联依据resources/Client/Data/Interface/EquipChange/EquipChange.lua：实际加载、解析、字段使用或示例关联依据resources/Public/Config/EquipBase.txt：实际加载、解析、字段使用或示例关联依据Server/Server/GameServer/Server/Script/LuaFnTbl_Attr.h：实际加载、解析、字段使用或示例关联依据
原始 DBC、加载查询及 Lua 外观变更在隔离夹具核对；示例保留样本编码和 Tab/CRLF。客户端列表与既有收费脚本经源码核对。未启动游戏、创建真实库存或实测模型。
