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%2FRecycleItemType.txt
工程参考/配置文件/Public/RecycleItemType.txt - 版本历史
2026-09-10T12:26:05Z
本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/RecycleItemType.txt&diff=1311&oldid=prev
雪舞：维护配置文件知识库：完整字段、读取范围、手工修改实例与核对状态
2026-09-10T02:35:51Z
<p>维护配置文件知识库：完整字段、读取范围、手工修改实例与核对状态</p>
<p><b>新页面</b></p><div>{{DISPLAYTITLE:<span style="font-size:24px;line-height:1.4;overflow-wrap:anywhere;">工程参考/配置文件/Public/RecycleItemType.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 />
本表定义“铸造材料 → 矿石”中的第二层名称和所属大类。index是整张表的记录号，classID是大类号，typeID才是该大类下的子类号；三个数字不能互换。只改显示名称时保留前三列。<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;" | Public/Config/RecycleItemType.txt 为发布目录样本；实际菜单由玩家电脑客户端 General 资源中的同名文件生成。<br />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 读取程序<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 客户端 General 资源数据库及玩家商店菜单；Server 同名加载函数未发现启动调用<br />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 生效方法<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 备份客户端实际加载的文件，退出 Game.exe 后修改并重新启动，打开玩家商店的收购物品选择窗口。当前检索范围未发现独立重载入口。仅改菜单名称无需重启 Server；只改 Public 样本不会更新客户端菜单。<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 />
样本38行，index从0到37。首行0、1、1、矿石表示：记录号0，属于大类1，子类号1，显示矿石。另一行16、5、1、矿石属于大类5；两行名称相同、typeID相同，但(classID,typeID)不同。<br />
<br />
客户端先按classID扫描整表，把匹配行的位置加入菜单，再用该位置作为首列index键查询。因此index必须等于有效数据行从0起的位置；不是文本编辑器行号，前两行表头不计入。样本最后一行37、2、6、食材虽不紧挨其他classID=2记录，仍归烹饪材料。<br />
<br />
当前每个大类只有16个子类按钮；打造图大类6已用满16个。总表38行不等于每类38个按钮，不能把未调用Server加载器的64行上限理解为客户端每类64个按钮。物品列表的分页不为子类增加按钮。<br />
<br />
== 文件格式 ==<br />
首行是类型行：<code style="white-space:normal;overflow-wrap:anywhere;">INT INT INT STRING</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：index<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 全表唯一、从0连续的记录号，等于有效数据行零基位置。跨所有大类统一编号，不按classID重新从0开始。<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空首列跳行，重复键报错；乱序、缺号可能造成名称或物品查询错误。新增应在末尾追加下一编号；删除中间行必须重排后续index。<br />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 2 列</code><br>INT：classID（和RecycleItemClass.txt里id对应）<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 所属大类ID，关联RecycleItemClass第一列；与typeID组成子类身份。<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 必须有对应大类。未知ID没有正常菜单入口；改值等于搬移子类，需要同步核对RecycleItem引用，不是改名。<br />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 3 列</code><br>INT：typeID（自己定）<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 大类内部的子类号，关联RecycleItem第三列。样本采用正整数；不同大类可复用，同一大类内保持唯一。<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 不是index，也不是当前按钮序号。客户端按筛选后的零基位置选按钮，再取本列匹配物品。-1会被物品查询拒绝；0或其他负数不作为禁用方式，保留已核对的正整数。重复组合可能把同一批物品列在多个按钮下，不要用作新增分类。<br />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 4 列</code><br>STRING：描述$1$<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 子类按钮显示文本，样本如矿石、烹饪辅料；名称不决定物品归类。<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空值可能显示空按钮，无自动命名。保留原编码、Tab与行尾，名称内不插入Tab或换行；长度和实际显示需要实测。<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 STRING<br />
index classID（和RecycleItemClass.txt里id对应） typeID（自己定） 描述$1$<br />
7 2 5 烹饪辅料</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 STRING<br />
index classID（和RecycleItemClass.txt里id对应） typeID（自己定） 描述$1$<br />
7 2 5 辅料</pre><br />
<br />
定位前三列7、2、5的行，核对原描述为“烹饪辅料”，只改第四列为“辅料”。保留完整38行、前三列、表头、Tab和编码。示例仅含该行与表头，不能覆盖整表；本地示例片段保留原中文字节。无需改物品目录的classID=2、typeID=5。重启客户端后进入“烹饪材料”，原“烹饪辅料”按钮应改名而候选物品不变。不要将第三列5改成第一列7，也不要改物品模板号。<br />
<br />
== 验证与排查 ==<br />
确认仍为38行、index等于0..37的行位置、全部classID有大类、每类不超过16行、(classID,typeID)组合无重复。仅index=7的第四列应变化。重启客户端进入烹饪材料，检查辅料按钮及原有物品列表；逐类抽查名称和选择。若名称错位先检查index与行位置是否一致，物品为空再核对classID/typeID组合及RecycleItem和CommonItem。<br />
<br />
=== 客户端实际修改位置 ===<br />
检查 Client/Bin/FairyResources.cfg 的 General 资源组。FileSystem=*../Data/Config 对应 Client/Data/Config 下的同名文件；AxpFileSystem=../Data/Config.axp 对应资源包内同名成员。以当前启用的映射为准，备份实际文件或资源包。不要只改源码的 resources/Public/Config 样本就期待玩家菜单变化。<br />
<br />
=== 与服务端的关系 ===<br />
Server 源码存在 InitRecycleItemClassTable 和 InitRecycleItemTypeTable，但在当前 Prj 检索范围仅找到声明和定义，未发现启动调用。已确认启动的是 RecycleItem.txt 第四列白名单加载。仅修改分类名称不会改变可收购物品、价格、数量、资金或已有订单。若部署使用不同程序，需重新核对加载入口。<br />
<br />
未调用的服务端分类加载函数有额外约束：大类1..16行、子类1..64行，名称复制最多31字节；这些不是当前客户端界面的可用容量或名称上限，不应据此扩充菜单。客户端显示长度取决于字体和按钮宽度，需要实测。<br />
<br />
本页不提供服务端Lua修改分类的接口；PlayerShop菜单方法属于客户端脚本。恢复时退出Game.exe，恢复本次修改的文件或资源包备份并重新启动；改名与恢复不回滚真实交易。<br />
<br />
== 关联与依据 ==<br />
[[工程参考/配置文件/Public/RecycleItemClass.txt|Public/RecycleItemClass.txt]] · [[工程参考/配置文件/Public/RecycleItem.txt|Public/RecycleItem.txt]] · [[工程参考/配置文件/Public/CommonItem.txt|Public/CommonItem.txt]]<br />
<br />
[[工程参考/配置文件索引|其他配置及整理状态]] · [[工程参考/服务端外网设置|服务端外网设置]] · [[Lua接口/服务端函数索引|Lua 接口索引]]<br />
<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Main/GameTable.cpp</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Main/GameTable.h</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Packets/CGPlayerShopSaleShopOptHandler.cpp</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Other/PlayerShopBuyShopStallBox.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/GameDefine_Item.h</code>：实际加载、解析、字段使用或示例关联依据<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;">Client/Client/Game/DataPool/GMDataPool.cpp</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">Client/Client/Game/Interface/GMInterface_Script_PlayerShop.cpp</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">Client/Client/Game/Script/GMScriptSystm.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/DBC/GMDataBase.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/Data/Interface/SelectRecycleItem/SelectRecycleItem.lua</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/RecycleItemClass.txt</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/RecycleItemType.txt</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/CommonItem.txt</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Client/Data/Config/RecycleItemClass.txt</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Client/Data/Config/RecycleItemType.txt</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Client/Data/Config/RecycleItem.txt</code>：实际加载、解析、字段使用或示例关联依据<br />
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Client/Data/Config/CommonItem.txt</code>：实际加载、解析、字段使用或示例关联依据<br />
<br />
原始DBC及客户端分类筛选、子类描述与物品查询方法的隔离测试；资源映射、界面脚本和注册方法经源码核对。未启动游戏，按钮渲染与实际交易需要实测。<br />
</div><br />
[[Category:工程参考]]</div>
雪舞