工程参考/配置文件/Public/Mission_NpcDefault.txt

来自天龙知识库
雪舞留言 | 贡献2026年9月11日 (五) 19:08的版本 (维护配置文件知识库:完整字段、读取范围、手工修改实例与核对状态)
(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)
跳到导航跳到搜索


首页 · 配置文件索引 · 修改约定

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

位置与生效 · 文件格式 · 字段详解 · 修改实例

文件位置与生效

项目 说明
运行文件 ../Public/Config/Mission_NpcDefault.txt,相对于服务端工作目录。当前检索未发现客户端加载本文件的入口。
读取程序 Server 游戏进程:TableInit::InitMissionNpcDefaultTable 用 MissionOpen(file, "../Public/Config/Mission_NpcDefault.txt", 9) 加载
生效方法 正常保存并停服后,重启读取此文件的 Server。当前检索未发现单独重载本文件的可用入口。
样本格式 GB18030-compatibleCRLF。保留原编码;源码读取器不会自动把中文转为 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 字符串长度占位符。

文件格式

首行是类型行:INT INT STRING INT STRING STRING STRING STRING STRING;第二行是列名行,程序跳过其内容;从第三行开始读取数据。各列用真实 Tab 分隔,保留首列、空列及行尾,不用空格代替。数据行行首 # 表示注释,分号不是此表的注释规则。首列为空的行被跳过;不足的尾列补为空值,多余列不参与本页字段读取。空整数和非数字经 atoi 可能成为 0,空字符串仍为空,不把解析成功当作业务合法。第一列须唯一,重复会触发读取器错误。

字段详解

列号从 1 开始,源码列下标从 0 开始。

字段与类型 含义与修改要点 缺项或特殊值
第 1 列
INT:ScriptId
任务脚本编号,服务端 InitMissionNpcDefaultTable 读第 1 列存为 record.m_nMissionIndex。 空为 0。
第 2 列
INT:SceneID
该 NPC 所在场景 ID,存为 record.m_nNpcScene。 空为 0。
第 3 列
STRING:NpcName$1$
NPC 名称,存为 record.m_szNpcName,用于按名字匹配到场景里的 NPC。 空字符串。
第 4 列
INT:对白数量
本行实际使用的对白条数,存为 record.m_nTalkCount。第 5 到 9 列共 5 条对白,本列决定取前几条。 空为 0(不使用对白)。
第 5 列
STRING:详细对白1$1$
第 1 条缺省对白文本,服务端按 4+i 列读取(i 从 0 到 4),存到 m_szTalkDesc1。只有第 1 条及之前的对白会被第 4 列的数量取用。 空字符串;超过第 4 列数量的条目不生效。
第 6 列
STRING:详细对白2$1$
第 2 条缺省对白文本,服务端按 4+i 列读取(i 从 0 到 4),存到 m_szTalkDesc2。只有第 2 条及之前的对白会被第 4 列的数量取用。 空字符串;超过第 4 列数量的条目不生效。
第 7 列
STRING:详细对白3$1$
第 3 条缺省对白文本,服务端按 4+i 列读取(i 从 0 到 4),存到 m_szTalkDesc3。只有第 3 条及之前的对白会被第 4 列的数量取用。 空字符串;超过第 4 列数量的条目不生效。
第 8 列
STRING:详细对白4$1$
第 4 条缺省对白文本,服务端按 4+i 列读取(i 从 0 到 4),存到 m_szTalkDesc4。只有第 4 条及之前的对白会被第 4 列的数量取用。 空字符串;超过第 4 列数量的条目不生效。
第 9 列
STRING:详细对白5$1$
第 5 条缺省对白文本,服务端按 4+i 列读取(i 从 0 到 4),存到 m_szTalkDesc5。只有第 5 条及之前的对白会被第 4 列的数量取用。 空字符串;超过第 4 列数量的条目不生效。

常用修改实例

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

把 1040000 号条目的对白数量从 1 改成 2

修改前:

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	我是干光豪,这是我填入表中的缺省对白,生效了哦!!				

修改后:

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	我是干光豪,这是我填入表中的缺省对白,生效了哦!!				

按第一列定位 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

其他配置及整理状态 · 服务端外网设置 · Lua 接口索引

  • Server/Server/GameServer/Server/Main/GameTable.cpp:实际加载、解析、字段使用或示例关联依据
  • resources/Public/Config/Mission_NpcDefault.txt:实际加载、解析、字段使用或示例关联依据

本页核对 TableInit::InitMissionNpcDefaultTable 的 MissionOpen 列数参数与逐列取值(第 1 到 4 列、4+i 读第 5 到 9 列),以及 SMissionDefaultTalk 的字段对应关系;未启动服务端与游戏,缺省对白的实际显示需要实测。