工程参考/配置文件/Server/NPCChat.txt

来自天龙知识库
跳到导航跳到搜索


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

NPCChat.txt 是怪物与 NPC 的喊话文本表:第 1 列是喊话编号,第 2 列是喊话内容。编号按每 1000 一组划分(BASENUM=1000),同一组内的多条文本属于同一类喊话,加载时会分别统计「有多少组」与「每组有多少条」。样本 12 条数据记录、2 列,分为 1000/2000/3000/4000 四组。

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

文件位置与生效

项目 说明
运行文件 ./Config/NPCChat.txt,相对于 Server 工作目录(FileDef.h 的 FILE_NPC_CHAT)。
读取程序 Server 游戏进程:TableInit::InitMonsterSpeakTable 通过 FILE_NPC_CHAT(./Config/NPCChat.txt)加载
生效方法 正常保存并停服后,重启读取此文件的 Server。当前检索未发现单独重载本文件的可用入口;不需要把本文件复制到玩家客户端。
样本格式 GB18030-compatibleCRLF。保留原编码;源码读取器不会自动把中文转为 UTF-8。

InitMonsterSpeakTable 逐行读第 1 列存为 nSpeakID、第 2 列拷进 szSpeakContent,并用 BASENUM=1000 做分组:第一项直接开新组;之后若上一行与本行的 ID/1000 相同,就只给当前组的计数加一;不同则递增组号并开新组。

因此编号不是随便分配的:把两条本应同类的喊话写成跨千位的不同编号(例如 2000 与 3000),它们会被算成两类而不是一类;反过来把不同类的文本挤在同一个千位段里,也会被当成同一类。

整表条数上限 MAXCHAT_NUMBER=64,样本只有 12 条,扩展空间有限。

文件格式

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

字段详解

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

字段与类型 含义与修改要点 缺项或特殊值
第 1 列
INT:ID
喊话编号。InitMonsterSpeakTable 读第 1 列存为 nSpeakID,并按 BASENUM=1000 分组:相邻行只要 ID/1000 相同就算同一组,换组时递增类型计数。整表条数上限 MAXCHAT_NUMBER=64。 空为 0;超过 64 条会触发断言。
第 2 列
STRING:CHAT$1$
喊话文本,读第 2 列拷进 szSpeakContent(长度上限 MAX_MONSTERSPEAK_CONTENT)。 空字符串。

常用修改实例

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

把 2000 号喊话的文本从 "You must be cheating." 改成 "Stop right there."

修改前:

INT	STRING
ID	CHAT$1$
2000	You must be cheating.

修改后:

INT	STRING
ID	CHAT$1$
2000	Stop right there.

按第一列定位 2000 号喊话。样本第 2 列为 "You must be cheating.",改成 "Stop right there."。只改第 2 列,保留 2 列。本片段含类型行、列名行与该行,不能覆盖整表。

这里选 2000 号是因为它的原文是纯 ASCII,可直接替换;中文文本需要用现有的编码子串方式改写。改完需要重启服务端才会生效。

验证与排查

重启后触发对应怪物或 NPC 的喊话(例如进入战斗),确认喊话内容与编号分组符合预期。注意整表条数上限 MAXCHAT_NUMBER=64,且编号的千位段决定归类,新增文本不要跨段或挤占同段。失败时恢复备份并重启。

编号按千位分组

分组依据是 ID/1000 是否相同(BASENUM=1000)。同类喊话要放在同一个千位段内,不同类不要混进同一段。

条数上限 64

MAXCHAT_NUMBER=64,样本已有 12 条。超过上限会触发断言,不能无限制追加。

只影响服务端

本文件在 Server/Config 下,通过 FILE_NPC_CHAT 以 ./Config/NPCChat.txt 读取,不随客户端资源分发;改完只需重启服务端。

关联与依据

Public/Mission_NpcDefault.txt

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

  • Common/ServerBase/FileDef.h:实际加载、解析、字段使用或示例关联依据
  • Common/GameDefine.h:实际加载、解析、字段使用或示例关联依据
  • Server/Server/GameServer/Server/Main/GameTable.cpp:实际加载、解析、字段使用或示例关联依据
  • resources/Server/Config/NPCChat.txt:实际加载、解析、字段使用或示例关联依据

本页核对 FileDef.h 的 FILE_NPC_CHAT、InitMonsterSpeakTable 的逐列读取与 BASENUM=1000 分组逻辑、GameDefine.h 的 MAXCHAT_NUMBER=64;未启动服务端与游戏,喊话的实际触发与分组效果需要实测。