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

{{DISPLAYTITLE:<span style="font-size:24px;line-height:1.4;overflow-wrap:anywhere;">工程参考/配置文件/Public/RecycleItemClass.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;">
[[首页|首页]] · [[工程参考/配置文件索引|配置文件索引]] · [[工程参考/配置文件修改约定|修改约定]]

本表定义收购物品窗口第一层分类，例如“铸造材料”“烹饪材料”。只想改按钮名称时，只改第二列描述，保留第一列ID。它不决定物品模板的材料类型，也不增加服务端收购资格。

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

== 文件位置与生效 ==
{| 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;" | Public/Config/RecycleItemClass.txt 是服务端发布目录中的样本；菜单修改在玩家电脑上客户端实际 General 资源中的同名文件，见下文路径说明。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 读取程序
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 客户端 General 资源数据库及玩家商店菜单；Server 同名加载函数未发现启动调用
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 生效方法
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 备份客户端实际加载的文件，退出 Game.exe 后修改并重新启动，打开玩家商店的收购物品选择窗口。当前检索范围未发现独立重载入口。仅改菜单名称无需重启 Server；只改 Public 样本不会更新客户端菜单。
|-
| 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。
|}

样本7行，ID依次为1..7：铸造材料、烹饪材料、制药材料、缝纫材料、工艺材料、打造图、其他。当前界面有10个大类按钮，按1..记录数量请求ID对应名称；ID必须保持从1开始连续且唯一。超过10行会超出既有按钮集合，不能仅靠增行扩容。

例如大类ID=1通过 RecycleItemType 的classID=1列出“矿石”等子类，再由 RecycleItem 的classID和typeID选出物品。名称不是关联键，同名按钮不合并分类。

== 文件格式 ==
首行是类型行：<code style="white-space:normal;overflow-wrap:anywhere;">INT	STRING</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;" | 大类编号，从1开始连续；对应RecycleItemType和RecycleItem的classID。不是物品ID、GUID或CommonItem材料大类号。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 保留既有编号。缺首列会跳过行，重复首列报错；0、负数、跳号不作为停用方式，可能出现空按钮或错误分类。删类需要核对两张关联表并重排所有引用，本页改名示例无需删行。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 2 列</code><br>STRING：描述$1$
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 大类按钮显示文本；$1$是原表头的一部分，保留表头。名称不参与物品筛选。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 没有自动补全名称的缺省值。空字符串会显示空名称，缺行尾字段可能读为空串；不要用Tab或换行嵌入名称，它们是文件结构。保留原编码，使用简短文字并实测按钮显示。
|}

== 常用修改实例 ==
示例为局部教学片段，先备份原运行文件，再修改对应行并保留其余配置。教学值不是程序默认值。 以下代码块保留真实 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	STRING
ID	描述$1$
1	铸造材料</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	STRING
ID	描述$1$
1	铸造</pre>

定位第一列ID=1的原行，只将第二列“铸造材料”改为“铸造”。保留ID=1、Tab、原表头、其余6行和文件编码；示例是单行定位片段，不可覆盖完整文件。本地示例保留样本中文字节及CRLF。无需改RecycleItemType或RecycleItem中的编号。重新启动客户端后，第一层按钮应显示“铸造”，原有矿石、锻石、铸铁子类和物品列表应保持一致；按钮外观需要实测。

== 验证与排查 ==
确认完整表仍为7行、ID为1..7，只有ID=1的描述变化。重启客户端查看大类名称，再点击该类检查子类与原有物品不变。名称未变先检查资源映射及包内副本；出现空按钮检查ID连续性、编码与Tab。不要根据Server没有本表加载日志判定客户端修改失败。

=== 客户端实际修改位置 ===
检查 Client/Bin/FairyResources.cfg 的 General 资源组。FileSystem=*../Data/Config 对应 Client/Data/Config 下的同名文件；AxpFileSystem=../Data/Config.axp 对应资源包内同名成员。以当前启用的映射为准，备份实际文件或资源包。不要只改源码的 resources/Public/Config 样本就期待玩家菜单变化。

=== 与服务端的关系 ===
Server 源码存在 InitRecycleItemClassTable 和 InitRecycleItemTypeTable，但在当前 Prj 检索范围仅找到声明和定义，未发现启动调用。已确认启动的是 RecycleItem.txt 第四列白名单加载。仅修改分类名称不会改变可收购物品、价格、数量、资金或已有订单。若部署使用不同程序，需重新核对加载入口。

未调用的服务端分类加载函数有额外约束：大类1..16行、子类1..64行，名称复制最多31字节；这些不是当前客户端界面的可用容量或名称上限，不应据此扩充菜单。客户端显示长度取决于字体和按钮宽度，需要实测。

本页不提供服务端Lua修改分类的接口；PlayerShop菜单方法属于客户端脚本。恢复时退出Game.exe，恢复本次修改的文件或资源包备份并重新启动；改名与恢复不回滚真实交易。

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

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

* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Main/GameTable.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Main/GameTable.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Packets/CGPlayerShopSaleShopOptHandler.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Other/PlayerShopBuyShopStallBox.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Common/ServerBase/FileDef.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Common/GameDefine_Item.h</code>：实际加载、解析、字段使用或示例关联依据
* <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;">Client/Client/Game/DataPool/GMDataPool.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Client/Client/Game/Interface/GMInterface_Script_PlayerShop.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Client/Client/Game/Script/GMScriptSystm.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/DBC/GMDataBase.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/Data/Interface/SelectRecycleItem/SelectRecycleItem.lua</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/RecycleItemClass.txt</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/RecycleItemType.txt</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/CommonItem.txt</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Client/Data/Config/RecycleItemClass.txt</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Client/Data/Config/RecycleItemType.txt</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Client/Data/Config/RecycleItem.txt</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Client/Data/Config/CommonItem.txt</code>：实际加载、解析、字段使用或示例关联依据

原始DBC及客户端分类筛选、子类描述与物品查询方法的隔离测试；资源映射、界面脚本和注册方法经源码核对。未启动游戏，按钮渲染与实际交易需要实测。
</div>
[[Category:工程参考]]