工程参考/配置文件/Public/CampaignTable.txt
CampaignTable.txt 是客户端活动日历的数据源。第 1 列是编号，第 2 列是时间类型，第 3 列是「前段-后段」形式的开始时间，第 7 到 11 列是名称、简述、补充、图标与详细说明。样本 181 行、13 列。
客户端在启动或刷新时遍历全部记录，按时间类型判断这条活动是否出现在「今日 / 明日 / 每日」列表里，再按开始时间的后段排序。
文件位置与生效
| 项目 | 说明 |
|---|---|
| 运行文件 | 客户端资源目录中的 CampaignTable.txt。当前核对范围内服务端没有任何进程打开同名文件，Server 与 World 都不读它。
|
| 读取程序 | 客户端：GMDataBase.cpp 以 DBC_CAMPAIGN 注册 "CampaignTable.txt"，GMDataPool.cpp 的 Campaign_Refresh 按当天与明天分档 |
| 生效方法 | 随客户端资源更新并重启客户端；服务端不需要重启。 |
| 样本格式 | GB18030-compatible，CRLF。保留原编码；源码读取器不会自动把中文转为 UTF-8。
|
时间类型
| 值 | 解释 |
|---|---|
| 0 | 指定日期。开始时间按 - 拆成两段，前一段是 MMDD，比当天或明天。 |
| 1 | 每天。直接进今日与每日列表。 |
| 2 | 每周。前一段是星期几，与 tm_wday 比较。 |
| 3 | 按日或按周的第几个。前一段写成 D 加日期或 W 加「第几周乘 10 加星期几」。 |
开始时间按 - 拆成两段，段数不为 2 的行在所有分支里都被跳过。第 1 类比较 MMDD 是否等于当天或明天；第 2 类比较 tm_wday；第 3 类支持 D 加日期与 W 加「第几周乘 10 加星期几」两种写法。排序时取后段转成整数，先比小时再比分钟。
| 检查项 | 结论 |
|---|---|
| 月份过滤读的是哪两列 | 客户端结构体把第 5、6 列读成 nStartMonthDay 与 nEndMonthDay，这两列在样本里叫 time_slice 与 time_invalid。 |
| 月份过滤什么时候生效 | 两列都为 0 或起始大于结束时视为不过滤。样本两列全为空（读成 0），所以过滤一直被跳过。 |
| 结构体覆盖到第几列 | 第 1 到 11 列。第 12 列追踪类型与第 13 列追踪文本在结构体之后，当前核对范围内没有读取。 |
| 段数不对会怎样 | Campaign_SplitTime 要求正好两段，否则该行不进任何列表，也不报错。
|
文件格式
首行是类型行：INT INT STRING STRING INT INT STRING STRING STRING STRING STRING INT STRING；第二行是列名行，程序跳过其内容；从第三行开始读取数据。各列用真实 Tab 分隔，保留首列、空列及行尾，不用空格代替。数据行行首 # 表示注释，分号不是此表的注释规则。首列为空的行被跳过；不足的尾列补为空值，多余列不参与本页字段读取。空整数和非数字经 atoi 可能成为 0，空字符串仍为空，不把解析成功当作业务合法。第一列须唯一，重复会触发读取器错误。
字段详解
列号从 1 开始，源码列下标从 0 开始。
| 字段与类型 | 含义与修改要点 | 缺项或特殊值 |
|---|---|---|
第 1 列INT：ID |
活动编号，同时是 DBC 索引列。客户端按记录条数遍历，不按它查找。 | 必填且不能重复。空首列会让整行被跳过。 |
第 2 列INT：time_type |
时间类型，决定第 3 列怎么解释。0 指定日期、1 每天、2 每周、3 按日或按周的第几个；其它值走 default 分支，整行不进任何列表。 | 必填。写错类型等于这条活动在日历里不显示。 |
第 3 列STRING：time_start |
开始时间，格式是「前段-后段」。前段按第 2 列的类型解释，后段是 HHMM 形式的时刻，排序与「进行中」判断都用它。 | 必填。少写 - 或段数不为 2 时该行在所有分支里都被跳过。 |
第 4 列STRING：time_end |
结束时间。当前核对范围内没有读取本列。 | 不生效。 |
第 5 列INT：time_slice |
时间片。客户端结构体 _DBC_CAMPAIGN 的下一个整型字段 nStartMonthDay 正好落在本列上，月份过滤实际读的是它。 | 样本全为空（读成 0），于是月份过滤被跳过；一旦填了非零值，就会被当成起始月日参与过滤。 |
第 6 列INT：time_invalid |
失效时间。客户端结构体的 nEndMonthDay 落在本列上，与第 5 列配对做月份区间过滤。 | 样本全为空（读成 0）。第 5 列大于本列时同样视为不过滤。 |
第 7 列STRING：campaignName$1$ |
活动名称，显示在活动日历上。 | 只在客户端读取。 |
第 8 列STRING：desc$1$ |
活动简述。 | 只在客户端读取。 |
第 9 列STRING：additionDesc$1$ |
补充说明。 | 只在客户端读取。 |
第 10 列STRING：icon |
图标名。 | 只在客户端读取。 |
第 11 列STRING：detailDesc$1$ |
详细说明。结构体里排在图标之后，是旧表追加出来的字段。 | 只在客户端读取。 |
第 12 列INT：track_type |
追踪类型。当前核对范围内没有读取本列。 | 不生效。 |
第 13 列STRING：trackDesc$1$ |
追踪文本。当前核对范围内没有读取本列。 | 不生效。 |
常用修改实例
示例为局部教学片段，先备份原运行文件，再修改对应行并保留其余配置。教学值不是程序默认值。 以下代码块保留真实 Tab；本地示例文件保留原样本编码、中文表头与 CRLF。网页文字使用浏览器编码显示，不表示运行文件应改存 UTF-8。
把 0 号活动的开始时间从 0104-1900 改为 0104-1930
修改前：
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
修改后：
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
按第 1 列定位 0 号活动（横扫牡丹碗）。它的第 3 列开始时间是 0104-1900，这里改成 0104-1930，其余 12 列与另 180 行全部保留。
时间类型 0 表示指定日期，前段 0104 会与当天和明天的月日比较，后段 1930 用于排序与「进行中」判断，所以只改后段就能把活动在当天列表里的位置往后挪。改前段则会让它换一天出现（或消失）。
示例块含类型行、列名行与该行原文，不能覆盖整张表。客户端需要更新资源后重启。
验证与排查
客户端启动后打开活动日历，确认这条活动出现在预期日期、时间排序位置正确、名称图标完整。改时间类型后要确认它进入了正确的分档（指定日期 / 每日 / 每周 / 按第几个）。若整条活动不见了，先检查第 3 列是否恰好被 - 拆成两段。失败时恢复备份。
服务端不读这张表
当前核对范围内只有客户端 GMDataBase.cpp 注册了它。改服务端副本不会有任何效果，改完也不需要重启服务端。
月份过滤读错了列
结构体 _DBC_CAMPAIGN 的 nStartMonthDay 与 nEndMonthDay 按顺序落在第 5、6 列，而这两列在文件里的列名是 time_slice 与 time_invalid。样本全为空（读成 0），于是 Campaign_IsMonthDayEnabled 一直返回 TRUE。一旦给这两列填了非零值，就会被当成 MMDD 形式的月份区间参与过滤，很可能让活动意外消失。
结构体只到 11 列
第 12 列追踪类型与第 13 列追踪文本在结构体之后，当前核对范围内没有代码读取。
关联与依据
其他配置及整理状态 · 服务端外网设置 · Lua 接口索引
Common/DataBase/TLBB_DBC.cpp：实际加载、解析、字段使用或示例关联依据Common/DataBase/TLBB_DBC.h：实际加载、解析、字段使用或示例关联依据Client/Client/Common/TDDBC_Struct.h：实际加载、解析、字段使用或示例关联依据Client/Client/Game/DBC/GMDataBase.cpp：实际加载、解析、字段使用或示例关联依据Client/Client/Game/DataPool/GMDataPool.cpp：实际加载、解析、字段使用或示例关联依据Client/Client/Game/DataPool/GMDataPool.h：实际加载、解析、字段使用或示例关联依据resources/Public/Config/CampaignTable.txt：实际加载、解析、字段使用或示例关联依据
本页核对客户端 _DBC_CAMPAIGN 结构与 13 列的对应关系、四种时间类型的分支、Campaign_SplitTime 的两段要求、月份过滤实际读第 5/6 列、以及第 12/13 列的零引用；样本 181 行的列宽与编号唯一性经脚本核算。未启动客户端，日历的实际显示需要实测。
