工程参考/配置文件/Public/Mission_NpcDefault.txt
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-compatible,CRLF。保留原编码;源码读取器不会自动把中文转为 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 列是文本。条数写大而文本为空,会读到空字符串;文本填了但条数小,后面的文本不会被取用。
只在没有任务对白时兜底
本表是「缺省对白」,玩家身上有可接或可交任务时优先走任务对白,看不到这里的文本。调试时要先确保没有相关任务状态。
关联与依据
其他配置及整理状态 · 服务端外网设置 · Lua 接口索引
Server/Server/GameServer/Server/Main/GameTable.cpp:实际加载、解析、字段使用或示例关联依据resources/Public/Config/Mission_NpcDefault.txt:实际加载、解析、字段使用或示例关联依据
本页核对 TableInit::InitMissionNpcDefaultTable 的 MissionOpen 列数参数与逐列取值(第 1 到 4 列、4+i 读第 5 到 9 列),以及 SMissionDefaultTalk 的字段对应关系;未启动服务端与游戏,缺省对白的实际显示需要实测。