查看“︁工程参考/配置文件/Public/EquipVisual.txt”︁的源代码

{{DISPLAYTITLE:<span style="font-size:24px;line-height:1.4;overflow-wrap:anywhere;">工程参考/配置文件/Public/EquipVisual.txt</span>}}
__NOTOC__
<div class="config-file-reference" style="max-width:1200px;margin:0 auto;line-height:1.8;color:#29343a;font-family:Arial,'Microsoft YaHei',sans-serif;letter-spacing:0;overflow-wrap:anywhere;">
[[首页|首页]] · [[工程参考/配置文件索引|配置文件索引]] · [[工程参考/配置文件修改约定|修改约定]]

EquipVisual.txt 按装备基础表的外观编号，列出最多十个可选择的外形。第一列用来找列表，第 2..11 列才是候选外形；Lua 函数的选择参数又是 0..9 的位置序号。这三类数字不能混用。

[[#文件位置与生效|位置与生效]] · [[#文件格式|文件格式]] · [[#字段详解|字段详解]] · [[#常用修改实例|修改实例]]

== 文件位置与生效 ==
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="width:24%;text-align:left;background:#edf3f2;padding:8px;" | 项目
! scope="col" style="width:76%;text-align:left;background:#edf3f2;padding:8px;" | 说明
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 运行文件
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">../Public/Config/EquipVisual.txt</code>，相对于 Server 工作目录；客户端另有同名资源。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 读取程序
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | Server 游戏进程与 Game.exe 客户端资源
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 生效方法
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 正常保存并停服后更新各 Server 的表，重启 Server；同步客户端同名资源后重启 Game.exe。当前检索范围未发现本表可用的单独重载入口。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 样本格式
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GB18030-compatible</code>，<code style="white-space:normal;overflow-wrap:anywhere;">CRLF</code>。保留原编码；源码读取器不会自动把中文转为 UTF-8。
|}

固定 12 列 INT，至少一行。Server 按第一列二分查找，文件必须数值递增且唯一；加载器不替你排序。

=== 两端各改哪里 ===
Server 读取 ../Public/Config 中的文件，路径相对于它的工作目录。玩家电脑按 Client/Bin/FairyResources.cfg 的 [General] 更新同名资源：FileSystem=*../Data/Config 对应 Client/Data/Config 中的散文件，AxpFileSystem=../Data/Config.axp 对应资源包内成员。保留现有打包与编码方式。源码 resources 里的文件是样本，修改样本不会自动部署到两端。

== 文件格式 ==
首行是类型行：<code style="white-space:normal;overflow-wrap:anywhere;">INT	INT	INT	INT	INT	INT	INT	INT	INT	INT	INT	INT</code>；第二行是列名行，程序跳过其内容；从第三行开始读取数据。各列用真实 Tab 分隔，保留首列、空列及行尾，不用空格代替。数据行行首 # 表示注释，分号不是此表的注释规则。首列为空的行被跳过；不足的尾列补为空值，多余列不参与本页字段读取。空整数和非数字经 atoi 可能成为 0，空字符串仍为空，不把解析成功当作业务合法。第一列须唯一，重复会触发读取器错误。

== 字段详解 ==
列号从 1 开始，源码列下标从 0 开始。

{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="width:34%;text-align:left;background:#edf3f2;padding:8px;" | 字段与类型
! scope="col" style="width:42%;text-align:left;background:#edf3f2;padding:8px;" | 含义与修改要点
! scope="col" style="width:24%;text-align:left;background:#edf3f2;padding:8px;" | 缺项或特殊值
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 1 列</code><br>INT：装备外形ID，列表查询键
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 对应 EquipBase.txt 中的 Visual 字段；不是 EquipBase 第一列物品编号。Server 从装备模板的 m_Visual 查本表，客户端也从装备模板的 nVisualID 查本表；不以物品当前变形后的外观再次选表。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 保留与基础表对应的既有编号。客户端当前外观界面拒绝基础 Visual 小于 10000 的装备；只在这里新增一行不会自动开放界面或添加模型。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 2 列</code><br>INT：ID_1，第 1 个候选
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端 LuaFnChangeVisual 的第 5 个参数为 0 时取本列；客户端外观列表的“可变外形1”对应它。该值是外观资源号，不是物品模板号或背包格。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | -1 表示该候选不可用，客户端不列出，服务端返回 -5。0/空值不等于禁用；其他负数也不被同样拒绝。只保留已验证可用的既有外观或 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 3 列</code><br>INT：ID_2，第 2 个候选
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端 LuaFnChangeVisual 的第 5 个参数为 1 时取本列；客户端外观列表的“可变外形2”对应它。该值是外观资源号，不是物品模板号或背包格。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | -1 表示该候选不可用，客户端不列出，服务端返回 -5。0/空值不等于禁用；其他负数也不被同样拒绝。只保留已验证可用的既有外观或 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 4 列</code><br>INT：ID_3，第 3 个候选
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端 LuaFnChangeVisual 的第 5 个参数为 2 时取本列；客户端外观列表的“可变外形3”对应它。该值是外观资源号，不是物品模板号或背包格。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | -1 表示该候选不可用，客户端不列出，服务端返回 -5。0/空值不等于禁用；其他负数也不被同样拒绝。只保留已验证可用的既有外观或 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 5 列</code><br>INT：ID_4，第 4 个候选
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端 LuaFnChangeVisual 的第 5 个参数为 3 时取本列；客户端外观列表的“可变外形4”对应它。该值是外观资源号，不是物品模板号或背包格。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | -1 表示该候选不可用，客户端不列出，服务端返回 -5。0/空值不等于禁用；其他负数也不被同样拒绝。只保留已验证可用的既有外观或 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 6 列</code><br>INT：ID_5，第 5 个候选
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端 LuaFnChangeVisual 的第 5 个参数为 4 时取本列；客户端外观列表的“可变外形5”对应它。该值是外观资源号，不是物品模板号或背包格。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | -1 表示该候选不可用，客户端不列出，服务端返回 -5。0/空值不等于禁用；其他负数也不被同样拒绝。只保留已验证可用的既有外观或 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 7 列</code><br>INT：ID_6，第 6 个候选
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端 LuaFnChangeVisual 的第 5 个参数为 5 时取本列；客户端外观列表的“可变外形6”对应它。该值是外观资源号，不是物品模板号或背包格。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | -1 表示该候选不可用，客户端不列出，服务端返回 -5。0/空值不等于禁用；其他负数也不被同样拒绝。只保留已验证可用的既有外观或 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 8 列</code><br>INT：ID_7，第 7 个候选
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端 LuaFnChangeVisual 的第 5 个参数为 6 时取本列；客户端外观列表的“可变外形7”对应它。该值是外观资源号，不是物品模板号或背包格。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | -1 表示该候选不可用，客户端不列出，服务端返回 -5。0/空值不等于禁用；其他负数也不被同样拒绝。只保留已验证可用的既有外观或 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 9 列</code><br>INT：ID_8，第 8 个候选
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端 LuaFnChangeVisual 的第 5 个参数为 7 时取本列；客户端外观列表的“可变外形8”对应它。该值是外观资源号，不是物品模板号或背包格。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | -1 表示该候选不可用，客户端不列出，服务端返回 -5。0/空值不等于禁用；其他负数也不被同样拒绝。只保留已验证可用的既有外观或 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 10 列</code><br>INT：ID_9，第 9 个候选
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端 LuaFnChangeVisual 的第 5 个参数为 8 时取本列；客户端外观列表的“可变外形9”对应它。该值是外观资源号，不是物品模板号或背包格。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | -1 表示该候选不可用，客户端不列出，服务端返回 -5。0/空值不等于禁用；其他负数也不被同样拒绝。只保留已验证可用的既有外观或 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 11 列</code><br>INT：ID_10，第 10 个候选
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端 LuaFnChangeVisual 的第 5 个参数为 9 时取本列；客户端外观列表的“可变外形10”对应它。该值是外观资源号，不是物品模板号或背包格。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | -1 表示该候选不可用，客户端不列出，服务端返回 -5。0/空值不等于禁用；其他负数也不被同样拒绝。只保留已验证可用的既有外观或 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 12 列</code><br>INT：Item_ID
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 样本为 30900004（变形符）。Server 保存到名为 nCost 的成员，客户端保存为 nItemID；当前检索未发现外观业务读取这两个成员来决定消耗。名称 nCost 不说明单位为金币。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 保留原值。当前客户端与服务端业务脚本分别固定检查 30900004，改本列不能单独替换材料，也不能改变金币费用。
|}

== 常用修改实例 ==
示例为局部教学片段，先备份原运行文件，再修改对应行并保留其余配置。教学值不是程序默认值。 以下代码块保留真实 Tab；本地示例文件保留原样本编码、中文表头与 CRLF。网页文字使用浏览器编码显示，不表示运行文件应改存 UTF-8。

=== 关闭既有外观列表的第十个候选 ===
修改前：
<pre style="white-space:pre-wrap;overflow-wrap:anywhere;font-size:13px;line-height:1.7;padding:12px;background:#f5f7f8;border:1px solid #dbe3e6;">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</pre>

修改后：
<pre style="white-space:pre-wrap;overflow-wrap:anywhere;font-size:13px;line-height:1.7;padding:12px;background:#f5f7f8;border:1px solid #dbe3e6;">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</pre>

在原表第一列找到 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 金；暗器有效等级与客户端显示可能不同，参见 [[Lua接口/服务端/GetBagItemLevel|GetBagItemLevel]]。

[[Lua接口/服务端/LuaFnChangeVisual|LuaFnChangeVisual]] 本身只检查两个格的基本可用状态并修改外观，不核对材料是否为 30900004，不扣钱、不删材料，也不按第 12 列执行消耗。脚本扣款和删除结果没有组成可回滚事务；不能将本函数当作完整收费服务直接开放。材料删除调用删除整个选中格，不应放入一整组用于验证。

=== 已有物品 ===
表格控制候选列表；物品当前外观另行保存。禁用某个候选只影响之后的选择，不批量恢复旧物品。成功后重登、穿脱和其他玩家看到的模型仍需要实测。

== 关联与依据 ==
[[工程参考/配置文件/Public/EquipExtraAttr.txt|Public/EquipExtraAttr.txt]] · [[工程参考/配置文件/Public/CommonItem.txt|Public/CommonItem.txt]]

[[工程参考/配置文件索引|其他配置及整理状态]] · [[工程参考/服务端外网设置|服务端外网设置]] · [[Lua接口/服务端函数索引|Lua 接口索引]]

* <code style="white-space:normal;overflow-wrap:anywhere;">Common/DataBase/TLBB_DBC.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Common/DataBase/TLBB_DBC.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Common/ServerBase/FileDef.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Common/GameStruct_Item.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Common/GameStruct.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Common/GameDefine_Item.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Item/ItemTable.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Item/ItemTable.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Item/ItemOperator.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Item/ItemContainer.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Script/LuaFnTbl_Ability.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Script/LuaFnRegister.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Client/Client/Game/DBC/GMDataBase.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Client/Client/Common/TDDBC_Struct.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Client/Client/Game/Interface/GMGameInterface_Script_LifeAbility.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Client/Client/Render/ResourceProvider.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Client/Client/Render/RenderSystem.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Client/Client/Core/Core/FairySystem.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Client/Bin/FairyResources.cfg</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Client/Bin/FairyResources正式服.cfg</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Data/Script.dat</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Data/Script/event/equip/equip_changevisual.lua</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Client/Data/Interface/EquipChange/EquipChange.lua</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/EquipBase.txt</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Script/LuaFnTbl_Attr.h</code>：实际加载、解析、字段使用或示例关联依据

原始 DBC、加载查询及 Lua 外观变更在隔离夹具核对；示例保留样本编码和 Tab/CRLF。客户端列表与既有收费脚本经源码核对。未启动游戏、创建真实库存或实测模型。
</div>
[[Category:工程参考]]