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

2026-09-11T07:16:28Z

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

新页面

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

MissionPet_HashTable.txt 登记任务宠物：每一行是一只珍兽，前 3 列是编号、名称、描述，第 4 列起每列对应一个任务槽位，写该珍兽在那一列出现的权重。样本 262 条记录、17 列（即 14 个任务槽位）。

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

== 文件位置与生效 ==
{| 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/MissionPet_HashTable.txt</code>，相对于 Server 工作目录。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 读取程序
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | Server 在 TableInit::InitMissionPetHashTable 加载到 g_MissionPet_List 与 g_MissionPet_Unit_List；客户端 GMDataBase 注册同名表（声明 3 列固定）
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 生效方法
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 停服后备份并修改实际 Public 副本，再重启 Server。该加载入口不在 ReloadCombatTables 的清单里，改完必须重启 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。
|}

每列权重不是独立概率，而是从上往下累加的。加载时同一列只有大于 0 的格子会被登记，登记时把当前值加到前一只的累加值上；加载完成后逐列检查，每列最后一个累加值必须正好等于 10000（MISSIONPET_RANDRANDG），否则调试版触发 Assert。

正因如此，单独改一个格子一定会破坏该列合计：要么把同列其它行一起调整，要么整列重写。这是本表最容易踩的坑。

第 1 列编号最多 5000 只（MAX_PET_NUM），任务列最多 1024 列（MAX_MISSIONIUNIT_NUM）；列数不足 3 也会断言。样本第三行是一行以 # 开头的注释，说明每列对应的任务，读取器会跳过它。

== 文件格式 ==
首行是类型行：<code style="white-space:normal;overflow-wrap:anywhere;">INT STRING STRING INT INT INT INT INT INT INT INT INT INT INT INT INT INT</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：珍兽编号
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 写入 m_nPetId，也是任务宠物列表的编号。样本 3000..3499，不连号。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 重复编号会让同一只宠物出现两次；容量 MAX_PET_NUM=5000。
|-
| 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;" | 写入 m_szPetName，按定长复制。
| 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：珍兽描述
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 写入 m_szPetDesc，可含 #B/#W 一类颜色标记。
| 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：第 0 个任务列的权重
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 按列号对应任务槽位（列号-3 即任务序号）。加载时同一列从上往下累加，只有大于 0 的行会被登记。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 同一列所有行的数值合计必须正好等于 10000（MISSIONPET_RANDRANDG），否则调试版 Assert、发布版最后一个宠物的命中区间越界。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 5 列</code> INT：第 1 个任务列的权重
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 按列号对应任务槽位（列号-3 即任务序号）。加载时同一列从上往下累加，只有大于 0 的行会被登记。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 同一列所有行的数值合计必须正好等于 10000（MISSIONPET_RANDRANDG），否则调试版 Assert、发布版最后一个宠物的命中区间越界。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 6 列</code> INT：第 2 个任务列的权重
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 按列号对应任务槽位（列号-3 即任务序号）。加载时同一列从上往下累加，只有大于 0 的行会被登记。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 同一列所有行的数值合计必须正好等于 10000（MISSIONPET_RANDRANDG），否则调试版 Assert、发布版最后一个宠物的命中区间越界。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 7 列</code> INT：第 3 个任务列的权重
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 按列号对应任务槽位（列号-3 即任务序号）。加载时同一列从上往下累加，只有大于 0 的行会被登记。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 同一列所有行的数值合计必须正好等于 10000（MISSIONPET_RANDRANDG），否则调试版 Assert、发布版最后一个宠物的命中区间越界。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 8 列</code> INT：第 4 个任务列的权重
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 按列号对应任务槽位（列号-3 即任务序号）。加载时同一列从上往下累加，只有大于 0 的行会被登记。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 同一列所有行的数值合计必须正好等于 10000（MISSIONPET_RANDRANDG），否则调试版 Assert、发布版最后一个宠物的命中区间越界。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 9 列</code> INT：第 5 个任务列的权重
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 按列号对应任务槽位（列号-3 即任务序号）。加载时同一列从上往下累加，只有大于 0 的行会被登记。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 同一列所有行的数值合计必须正好等于 10000（MISSIONPET_RANDRANDG），否则调试版 Assert、发布版最后一个宠物的命中区间越界。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 10 列</code> INT：第 6 个任务列的权重
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 按列号对应任务槽位（列号-3 即任务序号）。加载时同一列从上往下累加，只有大于 0 的行会被登记。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 同一列所有行的数值合计必须正好等于 10000（MISSIONPET_RANDRANDG），否则调试版 Assert、发布版最后一个宠物的命中区间越界。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 11 列</code> INT：第 7 个任务列的权重
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 按列号对应任务槽位（列号-3 即任务序号）。加载时同一列从上往下累加，只有大于 0 的行会被登记。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 同一列所有行的数值合计必须正好等于 10000（MISSIONPET_RANDRANDG），否则调试版 Assert、发布版最后一个宠物的命中区间越界。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 12 列</code> INT：第 8 个任务列的权重
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 按列号对应任务槽位（列号-3 即任务序号）。加载时同一列从上往下累加，只有大于 0 的行会被登记。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 同一列所有行的数值合计必须正好等于 10000（MISSIONPET_RANDRANDG），否则调试版 Assert、发布版最后一个宠物的命中区间越界。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 13 列</code> INT：第 9 个任务列的权重
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 按列号对应任务槽位（列号-3 即任务序号）。加载时同一列从上往下累加，只有大于 0 的行会被登记。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 同一列所有行的数值合计必须正好等于 10000（MISSIONPET_RANDRANDG），否则调试版 Assert、发布版最后一个宠物的命中区间越界。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 14 列</code> INT：第 10 个任务列的权重
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 按列号对应任务槽位（列号-3 即任务序号）。加载时同一列从上往下累加，只有大于 0 的行会被登记。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 同一列所有行的数值合计必须正好等于 10000（MISSIONPET_RANDRANDG），否则调试版 Assert、发布版最后一个宠物的命中区间越界。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 15 列</code> INT：第 11 个任务列的权重
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 按列号对应任务槽位（列号-3 即任务序号）。加载时同一列从上往下累加，只有大于 0 的行会被登记。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 同一列所有行的数值合计必须正好等于 10000（MISSIONPET_RANDRANDG），否则调试版 Assert、发布版最后一个宠物的命中区间越界。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 16 列</code> INT：第 12 个任务列的权重
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 按列号对应任务槽位（列号-3 即任务序号）。加载时同一列从上往下累加，只有大于 0 的行会被登记。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 同一列所有行的数值合计必须正好等于 10000（MISSIONPET_RANDRANDG），否则调试版 Assert、发布版最后一个宠物的命中区间越界。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 17 列</code> INT：第 13 个任务列的权重
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 按列号对应任务槽位（列号-3 即任务序号）。加载时同一列从上往下累加，只有大于 0 的行会被登记。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 同一列所有行的数值合计必须正好等于 10000（MISSIONPET_RANDRANDG），否则调试版 Assert、发布版最后一个宠物的命中区间越界。
|}

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

=== 把 3000 号珍兽的名称改成 ASCII 教学名 TestPet3000 ===
修改前：
<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 STRING INT INT INT INT INT INT INT INT INT INT INT INT INT INT
珍兽编号珍兽名称$1$ 珍兽描述$1$ 珍兽出现几率珍兽出现几率珍兽出现几率珍兽出现几率珍兽出现几率珍兽出现几率珍兽出现几率珍兽出现几率珍兽出现几率珍兽出现几率珍兽出现几率珍兽出现几率珍兽出现几率珍兽出现几率
3000 成年兔子 #B玄武岛#{_INFOAIM130,86,112,-1}#W 68 10000 10000 1250 500 361 1000 1000 1000 1000 1000 1000 500 361</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 STRING INT INT INT INT INT INT INT INT INT INT INT INT INT INT
珍兽编号珍兽名称$1$ 珍兽描述$1$ 珍兽出现几率珍兽出现几率珍兽出现几率珍兽出现几率珍兽出现几率珍兽出现几率珍兽出现几率珍兽出现几率珍兽出现几率珍兽出现几率珍兽出现几率珍兽出现几率珍兽出现几率珍兽出现几率
3000 TestPet3000 #B玄武岛#{_INFOAIM130,86,112,-1}#W 68 10000 10000 1250 500 361 1000 1000 1000 1000 1000 1000 500 361</pre>

按第一列定位 3000 号珍兽。第 2 列是显示用名称，样本为中文；改成 ASCII 名称不会影响任何权重列，因此不会破坏累计合计。只改第 2 列，保留 17 列和其余 261 行。本片段含表头与该行，不能覆盖整表。

隔离加载读回名称 TestPet3000，第 4 到 17 列的累加合计仍为 10000。真实任务刷宠需要实测。

== 验证与排查 ==
启动日志出现 Load InitMissionPetHashTable.txt ... OK! Count=… Mission=…，Mission=17-3=14。262 条记录、17 列。单独改某一列的一个权重会让该列合计不再等于 10000：调试版触发 Assert，发布版最后一个珍兽的命中区间越界。恢复备份后重启，本表不能热重载。

=== 权重必须整列平衡 ===
每列是一条 0..9999 的累积数轴，最后一个格子必须是 10000。想调整某只珍兽的权重，需要把同一列里排在它后面的所有行一起改。

=== 客户端声明 ===
客户端把本表登记为固定 3 列（DBC_MISSION_PET_HASHTABLE）。服务端却按实际列数遍历，所以「服务端能读、客户端只认前 3 列」是正常现象，不要以为客户端会读权重。

== 关联与依据 ==
[[工程参考/配置文件/Public/PetTypeAttr.txt|Public/PetTypeAttr.txt]] · [[工程参考/配置文件/Public/PetAttrTable.txt|Public/PetAttrTable.txt]] · [[工程参考/配置文件/Public/PetSkillBook.txt|Public/PetSkillBook.txt]]

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

* <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;">Server/Server/GameServer/Server/MissionExtend/GameStruct_Mission.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/MissionExtend/GameStruct_Mission.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/MissionPet_HashTable.txt</code>：实际加载、解析、字段使用或示例关联依据

原始 TableInit::InitMissionPetHashTable 及其逐列累加与合计校验的隔离加载测试（含合计不等于 10000 的负向用例）。任务刷宠与宠物生成未在游戏中执行。
</div>
[[Category:工程参考]]

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

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

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