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

2026-09-11T11:08:16Z

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

新页面

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

Mission_NpcDefault.txt 是 NPC 缺省对白表：第 1 列是任务脚本编号，第 2 列是场景 ID，第 3 列是 NPC 名称，第 4 列是对白条数，第 5 到 9 列是 5 条对白文本。样本 16 条数据记录、9 列。当玩家与该 NPC 对话、但没有可接或可交的任务时，用这里的文本兜底。

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

== 文件位置与生效 ==
{| 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/Mission_NpcDefault.txt</code>，相对于服务端工作目录。当前检索未发现客户端加载本文件的入口。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 读取程序
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | Server 游戏进程：TableInit::InitMissionNpcDefaultTable 用 MissionOpen(file, "../Public/Config/Mission_NpcDefault.txt", 9) 加载
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 生效方法
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 正常保存并停服后，重启读取此文件的 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。
|}

InitMissionNpcDefaultTable 先调用 MissionOpen(file, 路径, 9)，第三个参数 9 是期望的列数；列数不足会直接 return，整张表不加载。

逐行读第 1 列存为 m_nMissionIndex、第 2 列存为 m_nNpcScene、第 3 列拷进 m_szNpcName、第 4 列存为 m_nTalkCount，再用 4+i（i 从 0 到 4）读第 5 到 9 列拷进 m_szTalkDesc1 到 m_szTalkDesc5。

第 4 列决定实际取用前几条对白：写 1 时只有第 5 列生效，写 3 时取第 5 到 7 列。第 5 到 9 列是字符串，文本里的 $1$ 是 DBC 字符串长度占位符。

== 文件格式 ==
首行是类型行：<code style="white-space:normal;overflow-wrap:anywhere;">INT INT STRING INT STRING STRING STRING 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> INT：ScriptId
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 任务脚本编号，服务端 InitMissionNpcDefaultTable 读第 1 列存为 record.m_nMissionIndex。
| 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;">第 2 列</code> INT：SceneID
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 该 NPC 所在场景 ID，存为 record.m_nNpcScene。
| 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;">第 3 列</code> STRING：NpcName$1$
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | NPC 名称，存为 record.m_szNpcName，用于按名字匹配到场景里的 NPC。
| 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：对白数量
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 本行实际使用的对白条数，存为 record.m_nTalkCount。第 5 到 9 列共 5 条对白，本列决定取前几条。
| 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;">第 5 列</code> STRING：详细对白1$1$
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 1 条缺省对白文本，服务端按 4+i 列读取（i 从 0 到 4），存到 m_szTalkDesc1。只有第 1 条及之前的对白会被第 4 列的数量取用。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空字符串；超过第 4 列数量的条目不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 6 列</code> STRING：详细对白2$1$
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 2 条缺省对白文本，服务端按 4+i 列读取（i 从 0 到 4），存到 m_szTalkDesc2。只有第 2 条及之前的对白会被第 4 列的数量取用。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空字符串；超过第 4 列数量的条目不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 7 列</code> STRING：详细对白3$1$
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 3 条缺省对白文本，服务端按 4+i 列读取（i 从 0 到 4），存到 m_szTalkDesc3。只有第 3 条及之前的对白会被第 4 列的数量取用。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空字符串；超过第 4 列数量的条目不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 8 列</code> STRING：详细对白4$1$
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 4 条缺省对白文本，服务端按 4+i 列读取（i 从 0 到 4），存到 m_szTalkDesc4。只有第 4 条及之前的对白会被第 4 列的数量取用。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空字符串；超过第 4 列数量的条目不生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 9 列</code> STRING：详细对白5$1$
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 5 条缺省对白文本，服务端按 4+i 列读取（i 从 0 到 4），存到 m_szTalkDesc5。只有第 5 条及之前的对白会被第 4 列的数量取用。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空字符串；超过第 4 列数量的条目不生效。
|}

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

=== 把 1040000 号条目的对白数量从 1 改成 2 ===
修改前：
<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 INT STRING STRING STRING STRING STRING
ScriptId SceneID NpcName$1$ 对白数量详细对白1$1$ 详细对白2$1$ 详细对白3$1$ 详细对白4$1$ 详细对白5$1$
1040000 6 干光豪 1 我是干光豪，这是我填入表中的缺省对白，生效了哦！！ </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 INT STRING STRING STRING STRING STRING
ScriptId SceneID NpcName$1$ 对白数量详细对白1$1$ 详细对白2$1$ 详细对白3$1$ 详细对白4$1$ 详细对白5$1$
1040000 6 干光豪 2 我是干光豪，这是我填入表中的缺省对白，生效了哦！！ </pre>

按第一列定位 1040000 号条目。样本第 4 列对白数量为 1，改为 2。只改第 4 列，保留 9 列。本片段含类型行、列名行与该行，不能覆盖整表。

改成 2 后第 5、6 两条对白都会参与；样本第 6 列为空字符串，实际只会多出一条空对白，真正使用时应先在第 6 列填好文本。改完需要重启服务端才会生效。

== 验证与排查 ==
重启后到对应场景找到该 NPC（第 2 列场景、第 3 列名称），在没有任何可接/可交任务的状态下对话，确认显示的是这里配置的缺省对白。若对话仍显示默认文本，先确认列数不少于 9、第 4 列与第 5 到 9 列是否配套。失败时恢复备份并重启。

=== 列数不足会整表不加载 ===
MissionOpen 的第三个参数是 9，列数少于 9 时函数直接 return，不是跳过单行。追加列时不要删掉任何一列。

=== 对白条数与实际文本要配套 ===
第 4 列是取用条数，第 5 到 9 列是文本。条数写大而文本为空，会读到空字符串；文本填了但条数小，后面的文本不会被取用。

=== 只在没有任务对白时兜底 ===
本表是「缺省对白」，玩家身上有可接或可交任务时优先走任务对白，看不到这里的文本。调试时要先确保没有相关任务状态。

== 关联与依据 ==
[[工程参考/配置文件/Server/NPCChat.txt|Server/NPCChat.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;">resources/Public/Config/Mission_NpcDefault.txt</code>：实际加载、解析、字段使用或示例关联依据

本页核对 TableInit::InitMissionNpcDefaultTable 的 MissionOpen 列数参数与逐列取值（第 1 到 4 列、4+i 读第 5 到 9 列），以及 SMissionDefaultTalk 的字段对应关系；未启动服务端与游戏，缺省对白的实际显示需要实测。
</div>
[[Category:工程参考]]

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

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

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