工程参考/配置文件/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-compatible,CRLF。保留原编码;源码读取器不会自动把中文转为 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 读取,不随客户端资源分发;改完只需重启服务端。
关联与依据
其他配置及整理状态 · 服务端外网设置 · 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;未启动服务端与游戏,喊话的实际触发与分组效果需要实测。