查看“︁工程参考/配置文件/Public/MissionPet HashTable.txt”︁的源代码

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

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><br>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><br>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><br>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><br>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><br>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><br>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><br>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><br>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><br>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><br>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><br>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><br>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><br>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><br>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><br>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><br>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><br>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玄武岛#&#123;_INFOAIM130,86,112,-1&#125;#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玄武岛#&#123;_INFOAIM130,86,112,-1&#125;#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:工程参考]]