https://www.waylee.net/index.php?action=history&feed=atom&title=%E5%B7%A5%E7%A8%8B%E5%8F%82%E8%80%83%2F%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%2FPublic%2FEquipVisual.txt
工程参考/配置文件/Public/EquipVisual.txt - 版本历史
2026-09-10T12:16:53Z
本wiki上该页面的版本历史
MediaWiki 1.46.0
https://www.waylee.net/index.php?title=%E5%B7%A5%E7%A8%8B%E5%8F%82%E8%80%83/%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6/Public/EquipVisual.txt&diff=1281&oldid=prev
雪舞：维护配置文件知识库：完整字段、读取范围、手工修改实例与核对状态
2026-09-09T16:41:07Z
<p>维护配置文件知识库：完整字段、读取范围、手工修改实例与核对状态</p>
<p><b>新页面</b></p><div>{{DISPLAYTITLE:<span style="font-size:24px;line-height:1.4;overflow-wrap:anywhere;">工程参考/配置文件/Public/EquipVisual.txt</span>}}<br />
__NOTOC__<br />
<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;"><br />
[[首页|首页]] · [[工程参考/配置文件索引|配置文件索引]] · [[工程参考/配置文件修改约定|修改约定]]<br />
<br />
EquipVisual.txt 按装备基础表的外观编号，列出最多十个可选择的外形。第一列用来找列表，第 2..11 列才是候选外形；Lua 函数的选择参数又是 0..9 的位置序号。这三类数字不能混用。<br />
<br />
[[#文件位置与生效|位置与生效]] · [[#文件格式|文件格式]] · [[#字段详解|字段详解]] · [[#常用修改实例|修改实例]]<br />
<br />
== 文件位置与生效 ==<br />
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"<br />
! scope="col" style="width:24%;text-align:left;background:#edf3f2;padding:8px;" | 项目<br />
! scope="col" style="width:76%;text-align:left;background:#edf3f2;padding:8px;" | 说明<br />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 运行文件<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">../Public/Config/EquipVisual.txt</code>，相对于 Server 工作目录；客户端另有同名资源。<br />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 读取程序<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | Server 游戏进程与 Game.exe 客户端资源<br />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 生效方法<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 正常保存并停服后更新各 Server 的表，重启 Server；同步客户端同名资源后重启 Game.exe。当前检索范围未发现本表可用的单独重载入口。<br />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 样本格式<br />
| 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。<br />
|}<br />
<br />
固定 12 列 INT，至少一行。Server 按第一列二分查找，文件必须数值递增且唯一；加载器不替你排序。<br />
<br />
=== 两端各改哪里 ===<br />
Server 读取 ../Public/Config 中的文件，路径相对于它的工作目录。玩家电脑按 Client/Bin/FairyResources.cfg 的 [General] 更新同名资源：FileSystem=*../Data/Config 对应 Client/Data/Config 中的散文件，AxpFileSystem=../Data/Config.axp 对应资源包内成员。保留现有打包与编码方式。源码 resources 里的文件是样本，修改样本不会自动部署到两端。<br />
<br />
== 文件格式 ==<br />
首行是类型行：<code style="white-space:normal;overflow-wrap:anywhere;">INT INT INT INT INT INT INT INT INT INT INT INT</code>；第二行是列名行，程序跳过其内容；从第三行开始读取数据。各列用真实 Tab 分隔，保留首列、空列及行尾，不用空格代替。数据行行首 # 表示注释，分号不是此表的注释规则。首列为空的行被跳过；不足的尾列补为空值，多余列不参与本页字段读取。空整数和非数字经 atoi 可能成为 0，空字符串仍为空，不把解析成功当作业务合法。第一列须唯一，重复会触发读取器错误。<br />
<br />
== 字段详解 ==<br />
列号从 1 开始，源码列下标从 0 开始。<br />
<br />
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"<br />
! scope="col" style="width:34%;text-align:left;background:#edf3f2;padding:8px;" | 字段与类型<br />
! scope="col" style="width:42%;text-align:left;background:#edf3f2;padding:8px;" | 含义与修改要点<br />
! scope="col" style="width:24%;text-align:left;background:#edf3f2;padding:8px;" | 缺项或特殊值<br />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 1 列</code><br>INT：装备外形ID，列表查询键<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 对应 EquipBase.txt 中的 Visual 字段；不是 EquipBase 第一列物品编号。Server 从装备模板的 m_Visual 查本表，客户端也从装备模板的 nVisualID 查本表；不以物品当前变形后的外观再次选表。<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 保留与基础表对应的既有编号。客户端当前外观界面拒绝基础 Visual 小于 10000 的装备；只在这里新增一行不会自动开放界面或添加模型。<br />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 2 列</code><br>INT：ID_1，第 1 个候选<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端 LuaFnChangeVisual 的第 5 个参数为 0 时取本列；客户端外观列表的“可变外形1”对应它。该值是外观资源号，不是物品模板号或背包格。<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | -1 表示该候选不可用，客户端不列出，服务端返回 -5。0/空值不等于禁用；其他负数也不被同样拒绝。只保留已验证可用的既有外观或 -1。<br />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 3 列</code><br>INT：ID_2，第 2 个候选<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端 LuaFnChangeVisual 的第 5 个参数为 1 时取本列；客户端外观列表的“可变外形2”对应它。该值是外观资源号，不是物品模板号或背包格。<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | -1 表示该候选不可用，客户端不列出，服务端返回 -5。0/空值不等于禁用；其他负数也不被同样拒绝。只保留已验证可用的既有外观或 -1。<br />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 4 列</code><br>INT：ID_3，第 3 个候选<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端 LuaFnChangeVisual 的第 5 个参数为 2 时取本列；客户端外观列表的“可变外形3”对应它。该值是外观资源号，不是物品模板号或背包格。<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | -1 表示该候选不可用，客户端不列出，服务端返回 -5。0/空值不等于禁用；其他负数也不被同样拒绝。只保留已验证可用的既有外观或 -1。<br />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 5 列</code><br>INT：ID_4，第 4 个候选<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端 LuaFnChangeVisual 的第 5 个参数为 3 时取本列；客户端外观列表的“可变外形4”对应它。该值是外观资源号，不是物品模板号或背包格。<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | -1 表示该候选不可用，客户端不列出，服务端返回 -5。0/空值不等于禁用；其他负数也不被同样拒绝。只保留已验证可用的既有外观或 -1。<br />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 6 列</code><br>INT：ID_5，第 5 个候选<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端 LuaFnChangeVisual 的第 5 个参数为 4 时取本列；客户端外观列表的“可变外形5”对应它。该值是外观资源号，不是物品模板号或背包格。<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | -1 表示该候选不可用，客户端不列出，服务端返回 -5。0/空值不等于禁用；其他负数也不被同样拒绝。只保留已验证可用的既有外观或 -1。<br />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 7 列</code><br>INT：ID_6，第 6 个候选<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端 LuaFnChangeVisual 的第 5 个参数为 5 时取本列；客户端外观列表的“可变外形6”对应它。该值是外观资源号，不是物品模板号或背包格。<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | -1 表示该候选不可用，客户端不列出，服务端返回 -5。0/空值不等于禁用；其他负数也不被同样拒绝。只保留已验证可用的既有外观或 -1。<br />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 8 列</code><br>INT：ID_7，第 7 个候选<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端 LuaFnChangeVisual 的第 5 个参数为 6 时取本列；客户端外观列表的“可变外形7”对应它。该值是外观资源号，不是物品模板号或背包格。<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | -1 表示该候选不可用，客户端不列出，服务端返回 -5。0/空值不等于禁用；其他负数也不被同样拒绝。只保留已验证可用的既有外观或 -1。<br />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 9 列</code><br>INT：ID_8，第 8 个候选<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端 LuaFnChangeVisual 的第 5 个参数为 7 时取本列；客户端外观列表的“可变外形8”对应它。该值是外观资源号，不是物品模板号或背包格。<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | -1 表示该候选不可用，客户端不列出，服务端返回 -5。0/空值不等于禁用；其他负数也不被同样拒绝。只保留已验证可用的既有外观或 -1。<br />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 10 列</code><br>INT：ID_9，第 9 个候选<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端 LuaFnChangeVisual 的第 5 个参数为 8 时取本列；客户端外观列表的“可变外形9”对应它。该值是外观资源号，不是物品模板号或背包格。<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | -1 表示该候选不可用，客户端不列出，服务端返回 -5。0/空值不等于禁用；其他负数也不被同样拒绝。只保留已验证可用的既有外观或 -1。<br />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 11 列</code><br>INT：ID_10，第 10 个候选<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端 LuaFnChangeVisual 的第 5 个参数为 9 时取本列；客户端外观列表的“可变外形10”对应它。该值是外观资源号，不是物品模板号或背包格。<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | -1 表示该候选不可用，客户端不列出，服务端返回 -5。0/空值不等于禁用；其他负数也不被同样拒绝。只保留已验证可用的既有外观或 -1。<br />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 12 列</code><br>INT：Item_ID<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 样本为 30900004（变形符）。Server 保存到名为 nCost 的成员，客户端保存为 nItemID；当前检索未发现外观业务读取这两个成员来决定消耗。名称 nCost 不说明单位为金币。<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 保留原值。当前客户端与服务端业务脚本分别固定检查 30900004，改本列不能单独替换材料，也不能改变金币费用。<br />
|}<br />
<br />
== 常用修改实例 ==<br />
示例为局部教学片段，先备份原运行文件，再修改对应行并保留其余配置。教学值不是程序默认值。 以下代码块保留真实 Tab；本地示例文件保留原样本编码、中文表头与 CRLF。网页文字使用浏览器编码显示，不表示运行文件应改存 UTF-8。<br />
<br />
=== 关闭既有外观列表的第十个候选 ===<br />
修改前：<br />
<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<br />
装备外形ID ID_1 ID_2 ID_3 ID_4 ID_5 ID_6 ID_7 ID_8 ID_9 ID_10 Item_ID<br />
10001 2 3 4 5 6 7 8 9 10 11 30900004</pre><br />
<br />
修改后：<br />
<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<br />
装备外形ID ID_1 ID_2 ID_3 ID_4 ID_5 ID_6 ID_7 ID_8 ID_9 ID_10 Item_ID<br />
10001 2 3 4 5 6 7 8 9 10 -1 30900004</pre><br />
<br />
在原表第一列找到 10001，只把第 11 列 ID_10 从 11 改为 -1。保留 ID_1..ID_9 的 2..10、末列 30900004、全部其他行和表头。当前 EquipBase 样本中 10443901“变形测试衣”的 Visual 为 10001，适合作为隔离验证用的已有模板；物品编号 10443901 不能写进本表第一列。同步两端后，外观界面应保留前九个候选、隐藏第十个；服务端选择序号 9 应返回 -5。此修改不创建装备或资源，不改变已经保存为外观 11 的旧物品。三行示例不能覆盖整表。<br />
<br />
== 验证与排查 ==<br />
检查 InitItemVisualTable() Ok!、12 列及第一列递增唯一；确认示例只改第 11 列。使用基础 Visual=10001 的隔离测试装备，检查候选列表和前九项预览，确认第十项隐藏；验证服务端拒绝已禁用序号、重登后既有外观保持。恢复时停服还原两端表并重启；恢复候选列表不会把已变形的物品改回原外观。新增模型、性别和装备部位的兼容性需要另行实测。<br />
<br />
=== 选择序号与资源编号 ===<br />
第一列 10001 查出一行，选择序号 0 读取 ID_1=2，序号 9 读取 ID_10。服务端写入前反复对大于 1000 的值减 1000，例如 1001 变为 1、2000 变为 1000；1000 本身不变。这不是普通的取模公式。客户端列表返回的是原候选值，不能据这种归一化规则随意拼造新资源编号。<br />
<br />
=== 材料和金币由谁处理 ===<br />
现有客户端 EquipChange.lua 固定接受变形符 30900004，并显示装备等级*20000 的费用。Server 的 Script.dat 将脚本 809264 映射到 event/equip/equip_changevisual.lua：脚本检查材料模板与现金，费用取 GetBagItemLevel 的结果*20000，调用 LuaFnChangeVisual 成功后再调用扣钱和删除材料格。以铜为单位，20000 铜=2 金；暗器有效等级与客户端显示可能不同，参见 [[Lua接口/服务端/GetBagItemLevel|GetBagItemLevel]]。<br />
<br />
[[Lua接口/服务端/LuaFnChangeVisual|LuaFnChangeVisual]] 本身只检查两个格的基本可用状态并修改外观，不核对材料是否为 30900004，不扣钱、不删材料，也不按第 12 列执行消耗。脚本扣款和删除结果没有组成可回滚事务；不能将本函数当作完整收费服务直接开放。材料删除调用删除整个选中格，不应放入一整组用于验证。<br />
<br />
=== 已有物品 ===<br />
表格控制候选列表；物品当前外观另行保存。禁用某个候选只影响之后的选择，不批量恢复旧物品。成功后重登、穿脱和其他玩家看到的模型仍需要实测。<br />
<br />
== 关联与依据 ==<br />
[[工程参考/配置文件/Public/EquipExtraAttr.txt|Public/EquipExtraAttr.txt]] · [[工程参考/配置文件/Public/CommonItem.txt|Public/CommonItem.txt]]<br />
<br />
[[工程参考/配置文件索引|其他配置及整理状态]] · [[工程参考/服务端外网设置|服务端外网设置]] · [[Lua接口/服务端函数索引|Lua 接口索引]]<br />
<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">Common/DataBase/TLBB_DBC.cpp</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">Common/DataBase/TLBB_DBC.h</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">Common/ServerBase/FileDef.h</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">Common/GameStruct_Item.h</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">Common/GameStruct.cpp</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">Common/GameDefine_Item.h</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Item/ItemTable.cpp</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Item/ItemTable.h</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Item/ItemOperator.cpp</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Item/ItemContainer.cpp</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Script/LuaFnTbl_Ability.h</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Script/LuaFnRegister.cpp</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">Client/Client/Game/DBC/GMDataBase.cpp</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">Client/Client/Common/TDDBC_Struct.h</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">Client/Client/Game/Interface/GMGameInterface_Script_LifeAbility.cpp</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">Client/Client/Render/ResourceProvider.cpp</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">Client/Client/Render/RenderSystem.cpp</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">Client/Client/Core/Core/FairySystem.cpp</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Client/Bin/FairyResources.cfg</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Client/Bin/FairyResources正式服.cfg</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Data/Script.dat</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Data/Script/event/equip/equip_changevisual.lua</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Client/Data/Interface/EquipChange/EquipChange.lua</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/EquipBase.txt</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Script/LuaFnTbl_Attr.h</code>：实际加载、解析、字段使用或示例关联依据<br />
<br />
原始 DBC、加载查询及 Lua 外观变更在隔离夹具核对；示例保留样本编码和 Tab/CRLF。客户端列表与既有收费脚本经源码核对。未启动游戏、创建真实库存或实测模型。<br />
</div><br />
[[Category:工程参考]]</div>
雪舞