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

2026-09-10T10:59:07Z

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

新页面

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

DropNotify.txt 给击杀掉落的拾取广播提供文案。掉落包在 DropBoxContent 第 3 列写下通知编号；玩家捡起物品后，Server 按编号在本表里找稿，同一编号有多行时随机取一条。它不是开箱/转蛋公告，也不替代物品表上的广播开关。

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

== 文件位置与生效 ==
{| 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/DropNotify.txt</code>，相对于 Server 工作目录。源码宏 FILE_ITEM_DROP_NOTIFY。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 读取程序
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | Server 在 ItemTable::Init 加载；拾取掉落盒时按包上的通知编号查询。GM 命令 reloadtab=DropNotify 可重读
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 生效方法
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 推荐停服后备份并修改实际 Public 副本，再重启 Server。已有最高 GM 权限的管理入口可执行 <code style="white-space:normal;overflow-wrap:anywhere;">reloadtab=DropNotify</code>，等号右侧名称区分大小写，不带 .txt；它不是 Lua 调用。当前重载重新分配通知表，源码未释放旧分配，不用于频繁循环刷新。客户端不加载本表。
|-
| 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。
|}

样本 101 行、5 列。第 2 列通知编号 0..74，必须按非递减排列，允许重复；样本不少编号有 2 或 3 条稿。第 1 列索引加载器不读，但仍须唯一，因为 DBC 按首列建索引。样本频道列全是 4。

{| 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;" | DropBoxContent 第 3 列
| 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;" | 装备、普通物品、材料、宝石各表的广播标志为假则直接返回。任务物品恒为假。
|-
| 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;">&A</code> 活动描述、<code style="white-space:normal;overflow-wrap:anywhere;">&S</code> 场景名、<code style="white-space:normal;overflow-wrap:anywhere;">&T</code> 同场景队长名（没有则用拾取者名）、<code style="white-space:normal;overflow-wrap:anywhere;">&U</code> 拾取者、<code style="white-space:normal;overflow-wrap:anywhere;">&I</code> 物品传输串。模板和结果都限 255 字节。不要在文案里写 <code style="white-space:normal;overflow-wrap:anywhere;">%</code>，替换后按 sprintf 处理。

== 文件格式 ==
首行是类型行：<code style="white-space:normal;overflow-wrap:anywhere;">INT INT INT STRING 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：索引（无具体含义）
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 行号。DBC 按本列建索引，加载通知内容时不读它。样本 0..100 唯一递增。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空首列跳行。重复编号触发 DBC 错误。改它不会改变按通知号查找的结果。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 2 列</code><br>INT：广播类型ID（顺序递增）
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 通知编号，对应 DropBoxContent 第 3 列。查找按本列全表扫描，同一编号的多行随机抽一条。加载时若本行编号小于上一行则断言失败。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 须保持非递减。-1 不会被掉落包当作有效通知号来发。样本 0 有 3 条。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 3 列</code><br>INT：频道类型：4-系统消息，6-帮派消息，7-门派消息
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 聊天频道。4 或其它非 6、非 7 的值都按系统消息发送；6 发帮派并加前缀 <code style="white-space:normal;overflow-wrap:anywhere;">@*;SrvMsg;GLD:</code>；7 发门派。枚举定义在 GameDefine2.h：系统=4、帮派=6、门派=7。样本全为 4。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空值经 atoi 为 0，仍走系统频道。改成 6/7 后仍要有对应帮会或门派才会看到。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 4 列</code><br>STRING：活动描述$1$
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 替换 <code style="white-space:normal;overflow-wrap:anywhere;">&A</code> 时插入的短描述。拷入 64 字节缓冲，超长截断并补 0。样本第一行是企鹅王。
| 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><br>STRING：广播内容…
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 广播模板。拷入 256 字节缓冲，超长截断并补 0。发送时依次替换五个占位符。列数必须至少 5。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 缺列断言失败。模板里不要出现 %。
|}

== 常用修改实例 ==
示例为局部教学片段，先备份原运行文件，再修改对应行并保留其余配置。教学值不是程序默认值。以下代码块保留真实 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 INT INT STRING STRING
索引（无具体含义）广播类型ID（顺序递增）频道类型：4-系统消息，6-帮派消息，7-门派消息活动描述$1$ 广播内容（消息限长256CHAR，严禁使用字符%）：&A-活动描述，&S-场景名称，&T-队长名称，&U-玩家名称，&I-物品名称$1$
0 0 4 企鹅王 #W&U#P在雪原上将#{_BOSS42}#P踹翻在地，捡起#W&I#P，飞一般的走了。</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 INT STRING STRING
索引（无具体含义）广播类型ID（顺序递增）频道类型：4-系统消息，6-帮派消息，7-门派消息活动描述$1$ 广播内容（消息限长256CHAR，严禁使用字符%）：&A-活动描述，&S-场景名称，&T-队长名称，&U-玩家名称，&I-物品名称$1$
0 0 6 企鹅王 #W&U#P在雪原上将#{_BOSS42}#P踹翻在地，捡起#W&I#P，飞一般的走了。</pre>

按第一列定位行 0。样本第 2 列为通知号 0，第 3 列为 4，活动描述为企鹅王。只把第 3 列改为 6，保留 5 列、模板和其余 100 行。本片段含表头与该行，不能覆盖整表。通知号 0 另有两行仍为频道 4；发送时在三行里随机，只有抽中本行才走帮派。隔离加载读回频道 6。实际拾取还要求掉落包填写通知号 0，且该物品广播开关为真。需要实测。

== 验证与排查 ==
启动有 InitItemDropNotifyTable() Ok!。101 行、编号仍非递减，行 0 频道为 6。用引用通知号 0 的掉落包击杀并拾取，看系统或帮派频道。reloadtab=DropNotify 后新文案应生效，但不要反复重载。恢复备份后重启或再 reload 一次。

=== 发送时机 ===
在掉落盒拾取成功、物品进入背包之后发送，不是怪物死亡当下。Lua 开箱/转蛋用各自脚本广播，不读本表。

=== 物品开关 ===
GetIsBroadCast 按物品大类查装备、普通物品、宝石表。开关为假则本表再完整也不会发。

=== 重载 ===
命令解析取等号后整段，DropNotify 大小写必须一致。权限为最高 GM。重载不释放旧表。

== 关联与依据 ==
[[工程参考/配置文件/Server/DropBoxContent.txt|Server/DropBoxContent.txt]] · [[工程参考/配置文件/Server/MonsterDropBoxs.txt|Server/MonsterDropBoxs.txt]] · [[工程参考/配置文件/Public/CommonItem.txt|Public/CommonItem.txt]] · [[工程参考/配置文件/Public/GemInfo.txt|Public/GemInfo.txt]]

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

* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Item/ItemTable.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Item/ItemTable.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Item/ItemRuler.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Item/ItemRuler.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Obj/Obj_ItemBox.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Packets/CGCommandHandler.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Common/GameDefine2.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Common/ServerBase/FileDef.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;">resources/Public/Config/DropNotify.txt</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Server/Config/DropBoxContent.txt</code>：实际加载、解析、字段使用或示例关联依据

原始 DBC 与 InitItemDropNotifyTable 隔离测试。格式替换、频道发包和拾取流程为源码核对；未启动游戏。
</div>
[[Category:工程参考]]

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

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

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