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

2026-09-11T17:58:22Z

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

新页面

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

CampaignTable.txt 是客户端活动日历的数据源。第 1 列是编号，第 2 列是时间类型，第 3 列是「前段-后段」形式的开始时间，第 7 到 11 列是名称、简述、补充、图标与详细说明。样本 181 行、13 列。

客户端在启动或刷新时遍历全部记录，按时间类型判断这条活动是否出现在「今日 / 明日 / 每日」列表里，再按开始时间的后段排序。

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

== 文件位置与生效 ==
{| 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;">CampaignTable.txt</code>。当前核对范围内服务端没有任何进程打开同名文件，Server 与 World 都不读它。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 读取程序
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 客户端：GMDataBase.cpp 以 DBC_CAMPAIGN 注册 "CampaignTable.txt"，GMDataPool.cpp 的 Campaign_Refresh 按当天与明天分档
|-
| 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;" | 样本格式
| 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: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;" | 0
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 指定日期。开始时间按 - 拆成两段，前一段是 MMDD，比当天或明天。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 1
| 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;" | 每周。前一段是星期几，与 tm_wday 比较。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 3
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 按日或按周的第几个。前一段写成 D 加日期或 W 加「第几周乘 10 加星期几」。
|}

开始时间按 - 拆成两段，段数不为 2 的行在所有分支里都被跳过。第 1 类比较 MMDD 是否等于当天或明天；第 2 类比较 tm_wday；第 3 类支持 D 加日期与 W 加「第几周乘 10 加星期几」两种写法。排序时取后段转成整数，先比小时再比分钟。

{| 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;" | 客户端结构体把第 5、6 列读成 nStartMonthDay 与 nEndMonthDay，这两列在样本里叫 time_slice 与 time_invalid。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 月份过滤什么时候生效
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 两列都为 0 或起始大于结束时视为不过滤。样本两列全为空（读成 0），所以过滤一直被跳过。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 结构体覆盖到第几列
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 1 到 11 列。第 12 列追踪类型与第 13 列追踪文本在结构体之后，当前核对范围内没有读取。
|-
| 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;">Campaign_SplitTime</code> 要求正好两段，否则该行不进任何列表，也不报错。
|}

== 文件格式 ==
首行是类型行：<code style="white-space:normal;overflow-wrap:anywhere;">INT INT STRING STRING INT INT STRING STRING STRING STRING STRING 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
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 活动编号，同时是 DBC 索引列。客户端按记录条数遍历，不按它查找。
| 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;">第 2 列</code> INT：time_type
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 时间类型，决定第 3 列怎么解释。0 指定日期、1 每天、2 每周、3 按日或按周的第几个；其它值走 default 分支，整行不进任何列表。
| 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> STRING：time_start
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 开始时间，格式是「前段-后段」。前段按第 2 列的类型解释，后段是 HHMM 形式的时刻，排序与「进行中」判断都用它。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 必填。少写 - 或段数不为 2 时该行在所有分支里都被跳过。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 4 列</code> STRING：time_end
| 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;">第 5 列</code> INT：time_slice
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 时间片。客户端结构体 _DBC_CAMPAIGN 的下一个整型字段 nStartMonthDay 正好落在本列上，月份过滤实际读的是它。
| 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;">第 6 列</code> INT：time_invalid
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 失效时间。客户端结构体的 nEndMonthDay 落在本列上，与第 5 列配对做月份区间过滤。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 样本全为空（读成 0）。第 5 列大于本列时同样视为不过滤。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 7 列</code> STRING：campaignName$1$
| 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;">第 8 列</code> STRING：desc$1$
| 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;">第 9 列</code> STRING：additionDesc$1$
| 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;">第 10 列</code> STRING：icon
| 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;">第 11 列</code> STRING：detailDesc$1$
| 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;">第 12 列</code> INT：track_type
| 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;">第 13 列</code> STRING：trackDesc$1$
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 追踪文本。当前核对范围内没有读取本列。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 不生效。
|}

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

=== 把 0 号活动的开始时间从 0104-1900 改为 0104-1930 ===
修改前：
<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 STRING STRING INT INT STRING STRING STRING STRING STRING INT STRING
ID time_type time_start time_end time_slice time_invalid campaignName$1$ desc$1$ additionDesc$1$ icon detailDesc$1$ track_type trackDesc$1$
0 0 0104-1900 0104-2300 横扫牡丹碗洛阳童贯、大理夏青青、苏州于倩倩 Huodong_6 所有#G等级≥30级#W、#G心法等级都≥30级#W的玩家只要组成#G3人以上#W的队伍就可前往#G洛阳#R童贯#{_INFOAIM204,57,0,童贯}#W、#G大理#R夏青青#{_INFOAIM282,95,2,夏青青}#W、#G苏州#R于倩倩#{_INFOAIM187,148,1,于倩倩}#W处参与#Y蹴鞠大赛#W活动，最终挑战蹴鞠十三妹#Y孙美美#W。 0 活动追踪文本0</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 STRING STRING INT INT STRING STRING STRING STRING STRING INT STRING
ID time_type time_start time_end time_slice time_invalid campaignName$1$ desc$1$ additionDesc$1$ icon detailDesc$1$ track_type trackDesc$1$
0 0 0104-1930 0104-2300 横扫牡丹碗洛阳童贯、大理夏青青、苏州于倩倩 Huodong_6 所有#G等级≥30级#W、#G心法等级都≥30级#W的玩家只要组成#G3人以上#W的队伍就可前往#G洛阳#R童贯#{_INFOAIM204,57,0,童贯}#W、#G大理#R夏青青#{_INFOAIM282,95,2,夏青青}#W、#G苏州#R于倩倩#{_INFOAIM187,148,1,于倩倩}#W处参与#Y蹴鞠大赛#W活动，最终挑战蹴鞠十三妹#Y孙美美#W。 0 活动追踪文本0</pre>

按第 1 列定位 0 号活动（横扫牡丹碗）。它的第 3 列开始时间是 0104-1900，这里改成 0104-1930，其余 12 列与另 180 行全部保留。

时间类型 0 表示指定日期，前段 0104 会与当天和明天的月日比较，后段 1930 用于排序与「进行中」判断，所以只改后段就能把活动在当天列表里的位置往后挪。改前段则会让它换一天出现（或消失）。

示例块含类型行、列名行与该行原文，不能覆盖整张表。客户端需要更新资源后重启。

== 验证与排查 ==
客户端启动后打开活动日历，确认这条活动出现在预期日期、时间排序位置正确、名称图标完整。改时间类型后要确认它进入了正确的分档（指定日期 / 每日 / 每周 / 按第几个）。若整条活动不见了，先检查第 3 列是否恰好被 - 拆成两段。失败时恢复备份。

=== 服务端不读这张表 ===
当前核对范围内只有客户端 GMDataBase.cpp 注册了它。改服务端副本不会有任何效果，改完也不需要重启服务端。

=== 月份过滤读错了列 ===
结构体 <code style="white-space:normal;overflow-wrap:anywhere;">_DBC_CAMPAIGN</code> 的 nStartMonthDay 与 nEndMonthDay 按顺序落在第 5、6 列，而这两列在文件里的列名是 time_slice 与 time_invalid。样本全为空（读成 0），于是 <code style="white-space:normal;overflow-wrap:anywhere;">Campaign_IsMonthDayEnabled</code> 一直返回 TRUE。一旦给这两列填了非零值，就会被当成 MMDD 形式的月份区间参与过滤，很可能让活动意外消失。

=== 结构体只到 11 列 ===
第 12 列追踪类型与第 13 列追踪文本在结构体之后，当前核对范围内没有代码读取。

== 关联与依据 ==
[[工程参考/配置文件/Public/ActivityNotice.txt|Public/ActivityNotice.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;">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/Game/DataPool/GMDataPool.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Client/Client/Game/DataPool/GMDataPool.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/CampaignTable.txt</code>：实际加载、解析、字段使用或示例关联依据

本页核对客户端 _DBC_CAMPAIGN 结构与 13 列的对应关系、四种时间类型的分支、Campaign_SplitTime 的两段要求、月份过滤实际读第 5/6 列、以及第 12/13 列的零引用；样本 181 行的列宽与编号唯一性经脚本核算。未启动客户端，日历的实际显示需要实测。
</div>
[[Category:工程参考]]

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

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

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