雪舞：维护配置文件知识库：完整字段、读取范围、手工修改实例与核对状态

2026-09-11T17:58:23Z

维护配置文件知识库：完整字段、读取范围、手工修改实例与核对状态

新页面

{{DISPLAYTITLE:工程参考/配置文件/Public/IDCollections.txt}}
__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;">
[[首页|首页]] · [[工程参考/配置文件索引|配置文件索引]] · [[工程参考/配置文件修改约定|修改约定]]

IDCollections.txt 把一批同类编号归成一个集合。第 1 列是集合编号，第 2 列是说明，第 3 列是集合里编号的类型，第 4 列是有效个数，第 5 到 34 列是最多 30 个编号，第 35 列是结尾说明。样本 99 行、35 列。

对外只有两个查询：<code style="white-space:normal;overflow-wrap:anywhere;">GetIDByIndex(下标)</code> 与 <code style="white-space:normal;overflow-wrap:anywhere;">IsThisIDInCollection(编号)</code>，两者都只扫前 m_nSize 项。

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

== 文件位置与生效 ==
{| 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/IDCollections.txt</code>（宏 FILE_ID_COLLECTION），相对于 GameServer 工作目录。当前核对范围内客户端不读本表。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 读取程序
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | GameServer：TableInit::InitIdCollectionMgr 用 g_IDCollectionMgr.InitFromDB(FILE_ID_COLLECTION)；读取实现在 Common/Combat/DataRecords.cpp
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 生效方法
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 停服后备份并修改实际副本，重启 Server。当前检索未发现单独重载入口。
|-
| 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。
|}

=== 编号类型 ===
{| 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;" | 0
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | BUFF_ID
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | Buff 编号
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 1
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | IMPACT_MUTEX_ID
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 效果互斥编号
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 2
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | IMPACT_LOGIC_ID
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 效果逻辑编号
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 3
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | SKILL_ID
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 技能编号
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 4
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | SKILL_LOGIC_ID
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 技能逻辑编号
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 5
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | DIRECT_IMPACT_ID
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 直接效果编号
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 6
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | SPECIAL_OBJ_CLASS_ID
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 特殊对象类别编号
|}

加载由 <code style="white-space:normal;overflow-wrap:anywhere;">TemplateManager_T</code> 完成：第 1 列的值当作数组下标写入第 nID 项，随后由 <code style="white-space:normal;overflow-wrap:anywhere;">IDCollection_T::InitFromDB</code> 顺序读说明、类型、个数与 30 个编号，最后读结尾说明。

{| 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;" | 不能。必须在 0 到 1023 之间（IDCollection_T::MAX_ID = 1024）。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 最多几个编号
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 30 个（COLLECTION_SIZE）。第 4 列填得再大也只按 30 处理。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 有效个数怎么生效
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 只扫前 m_nSize 项；后面的编号填了也不参与查询。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 类型列有用吗
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 当前核对范围内只保存不使用（GetType 有实现但没有调用方）。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空槽怎么处理
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 集合初始化时全部填 INVALID_ID，空列经 atoi 得到 0，两者不同。
|}

== 文件格式 ==
首行是类型行：<code style="white-space:normal;overflow-wrap:anywhere;">INT STRING INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT 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> INT：标识ID的分类ID
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 集合编号，同时是 DBC 索引列。TemplateManager_T 把它当作数组下标写入 m_vTemplateList[nID]，必须落在 0 到 1023 之间。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 必填且不能重复。超出范围会触发 AssertEx 并丢弃该行。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 2 列</code> STRING：分类说明
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 集合说明。保存为字符串指针，供人阅读。
| 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;">第 3 列</code> INT：本行中所有ID的类型(必须填)
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 本行所有编号的类型。取值见 <code style="white-space:normal;overflow-wrap:anywhere;">IDCollection_T::CollectionIdType_T</code>：0 Buff、1 效果互斥、2 效果逻辑、3 技能、4 技能逻辑、5 直接效果、6 特殊对象类别。
| 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;">第 4 列</code> INT：本类中的ID数量
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 本集合里有效编号的个数。GetIDByIndex 与 IsThisIDInCollection 都只扫前 m_nSize 项，超过 30 会被夹回 30。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 必填。填 0 表示空集合；填大于 30 的值不会让代码多读，只会按 30 处理。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 5 列</code> INT：ID1
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 1 个编号。只有下标小于第 4 列的那些项会被读取。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。超出第 4 列个数的项填了也不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 6 列</code> INT：ID2
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 2 个编号。只有下标小于第 4 列的那些项会被读取。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。超出第 4 列个数的项填了也不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 7 列</code> INT：ID3
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 3 个编号。只有下标小于第 4 列的那些项会被读取。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。超出第 4 列个数的项填了也不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 8 列</code> INT：ID4
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 4 个编号。只有下标小于第 4 列的那些项会被读取。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。超出第 4 列个数的项填了也不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 9 列</code> INT：ID5
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 5 个编号。只有下标小于第 4 列的那些项会被读取。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。超出第 4 列个数的项填了也不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 10 列</code> INT：ID6
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 6 个编号。只有下标小于第 4 列的那些项会被读取。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。超出第 4 列个数的项填了也不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 11 列</code> INT：ID7
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 7 个编号。只有下标小于第 4 列的那些项会被读取。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。超出第 4 列个数的项填了也不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 12 列</code> INT：ID8
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 8 个编号。只有下标小于第 4 列的那些项会被读取。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。超出第 4 列个数的项填了也不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 13 列</code> INT：ID9
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 9 个编号。只有下标小于第 4 列的那些项会被读取。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。超出第 4 列个数的项填了也不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 14 列</code> INT：ID10
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 10 个编号。只有下标小于第 4 列的那些项会被读取。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。超出第 4 列个数的项填了也不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 15 列</code> INT：ID11
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 11 个编号。只有下标小于第 4 列的那些项会被读取。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。超出第 4 列个数的项填了也不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 16 列</code> INT：ID12
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 12 个编号。只有下标小于第 4 列的那些项会被读取。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。超出第 4 列个数的项填了也不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 17 列</code> INT：ID13
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 13 个编号。只有下标小于第 4 列的那些项会被读取。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。超出第 4 列个数的项填了也不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 18 列</code> INT：ID14
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 14 个编号。只有下标小于第 4 列的那些项会被读取。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。超出第 4 列个数的项填了也不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 19 列</code> INT：ID15
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 15 个编号。只有下标小于第 4 列的那些项会被读取。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。超出第 4 列个数的项填了也不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 20 列</code> INT：ID16
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 16 个编号。只有下标小于第 4 列的那些项会被读取。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。超出第 4 列个数的项填了也不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 21 列</code> INT：ID17
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 17 个编号。只有下标小于第 4 列的那些项会被读取。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。超出第 4 列个数的项填了也不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 22 列</code> INT：ID18
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 18 个编号。只有下标小于第 4 列的那些项会被读取。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。超出第 4 列个数的项填了也不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 23 列</code> INT：ID19
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 19 个编号。只有下标小于第 4 列的那些项会被读取。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。超出第 4 列个数的项填了也不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 24 列</code> INT：ID20
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 20 个编号。只有下标小于第 4 列的那些项会被读取。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。超出第 4 列个数的项填了也不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 25 列</code> INT：ID21
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 21 个编号。只有下标小于第 4 列的那些项会被读取。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。超出第 4 列个数的项填了也不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 26 列</code> INT：ID22
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 22 个编号。只有下标小于第 4 列的那些项会被读取。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。超出第 4 列个数的项填了也不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 27 列</code> INT：ID23
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 23 个编号。只有下标小于第 4 列的那些项会被读取。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。超出第 4 列个数的项填了也不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 28 列</code> INT：ID24
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 24 个编号。只有下标小于第 4 列的那些项会被读取。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。超出第 4 列个数的项填了也不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 29 列</code> INT：ID25
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 25 个编号。只有下标小于第 4 列的那些项会被读取。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。超出第 4 列个数的项填了也不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 30 列</code> INT：ID26
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 26 个编号。只有下标小于第 4 列的那些项会被读取。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。超出第 4 列个数的项填了也不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 31 列</code> INT：ID27
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 27 个编号。只有下标小于第 4 列的那些项会被读取。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。超出第 4 列个数的项填了也不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 32 列</code> INT：ID28
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 28 个编号。只有下标小于第 4 列的那些项会被读取。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。超出第 4 列个数的项填了也不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 33 列</code> INT：ID29
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 29 个编号。只有下标小于第 4 列的那些项会被读取。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。超出第 4 列个数的项填了也不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 34 列</code> INT：ID30
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 30 个编号。只有下标小于第 4 列的那些项会被读取。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。超出第 4 列个数的项填了也不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 35 列</code> STRING：结尾说明，测试用
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 结尾说明。保存为字符串指针，注释里写着是测试用。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 不参与逻辑。
|}

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

=== 把 1 号集合的有效编号个数从 3 改为 2 ===
修改前：
<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 INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT STRING
标识ID的分类ID 分类说明本行中所有ID的类型(必须填) 本类中的ID数量 ID1 ID2 ID3 ID4 ID5 ID6 ID7 ID8 ID9 ID10 ID11 ID12 ID13 ID14 ID15 ID16 ID17 ID18 ID19 ID20 ID21 ID22 ID23 ID24 ID25 ID26 ID27 ID28 ID29 ID30 结尾说明，测试用
1 摩诃无量+万劫无相+明镜无尘 0 3 105 108 106 </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 INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT STRING
标识ID的分类ID 分类说明本行中所有ID的类型(必须填) 本类中的ID数量 ID1 ID2 ID3 ID4 ID5 ID6 ID7 ID8 ID9 ID10 ID11 ID12 ID13 ID14 ID15 ID16 ID17 ID18 ID19 ID20 ID21 ID22 ID23 ID24 ID25 ID26 ID27 ID28 ID29 ID30 结尾说明，测试用
1 摩诃无量+万劫无相+明镜无尘 0 2 105 108 106 </pre>

按第 1 列定位 1 号集合（摩诃无量 + 万劫无相 + 明镜无尘，类型是 0 即 Buff）。样本第 4 列是 3，第 5 到 7 列依次是 105、108、106；这里把第 4 列改成 2，其余 34 列与另 98 行全部保留。

改完后 <code style="white-space:normal;overflow-wrap:anywhere;">GetIDByIndex(2)</code> 返回 INVALID_ID，<code style="white-space:normal;overflow-wrap:anywhere;">IsThisIDInCollection(106)</code> 也变成假——第 3 个编号还留在文件里，但已经不参与查询。这比删掉单元格更安全：想恢复只要把个数改回 3。

示例块含类型行、列名行与该行原文，不能覆盖整张表。改完需要重启 Server。

== 验证与排查 ==
Server 启动日志出现 “Load IDCollections.txt ... OK!”。改完重启后，让目标 Buff 或技能触发一次，确认按集合判定的结果符合预期（个数改小后第三个编号不再命中）。若整表加载失败，先检查第 1 列是否落在 0 到 1023 之间。失败时恢复备份并重启。

=== 个数才是开关 ===
第 4 列决定扫到第几个编号。想临时停用一个编号，把个数改小比清空单元格更安全，也更容易回滚。

=== 30 是硬上限 ===
<code style="white-space:normal;overflow-wrap:anywhere;">COLLECTION_SIZE</code> 是 30，第 5 到 34 列正好 30 个槽位。想加第 31 个必须同时改类型行、列名行、所有数据行并改这个常量。

=== 类型列目前没人用 ===
<code style="white-space:normal;overflow-wrap:anywhere;">m_nType</code> 有 GetType 访问器，但当前核对范围内没有调用方。填错不会报错，但会让将来按类型分支的代码误判。

=== 空槽是 0 不是 INVALID_ID ===
集合初始化时把数组填成 INVALID_ID，但文件里的空单元格经 atoi 得到 0。如果 0 恰好是一个合法编号，就会意外命中。

== 关联与依据 ==
[[工程参考/配置文件/Public/CampAndStand.txt|Public/CampAndStand.txt]] · [[工程参考/配置文件/Public/SpecialObjData.txt|Public/SpecialObjData.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;">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;">Common/Combat/DataRecords.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Common/Combat/DataRecords.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Common/ServerBase/FileDef.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/IDCollections.txt</code>：实际加载、解析、字段使用或示例关联依据

本页核对 TemplateManager_T 按下标写入的行为、IDCollection_T::InitFromDB 的顺序读取、COLLECTION_SIZE=30 与 MAX_ID=1024 两个上限、GetIDByIndex 与 IsThisIDInCollection 只扫前 m_nSize 项；样本 99 行的编号范围经脚本核算。未启动服务端，实际按集合判定的效果需要实测。
</div>
[[Category:工程参考]]

工程参考/配置文件/Public/IDCollections.txt - 版本历史

雪舞：​维护配置文件知识库：完整字段、读取范围、手工修改实例与核对状态

雪舞：维护配置文件知识库：完整字段、读取范围、手工修改实例与核对状态