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

2026-09-11T17:58:26Z

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

新页面

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

CharTitle.txt 登记角色称号。第 1 列是称号编号，第 2 列是策划分类用类型，第 3 列是名称，第 4 列是描述，第 5 列是程序用逻辑类型，第 6 列是等级，第 7 列是有效时间，第 8 列是注释。样本 260 行、8 列。

服务端读 6 列（1、2、3、5、6、7），跳过第 4 列描述与第 8 列注释；客户端结构体只映射前 4 列。两端的查找都用行号（记录下标），所以第 1 列必须等于从 0 起的行号。

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

== 文件位置与生效 ==
{| 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/CharTitle.txt</code>，路径写死在加载函数里，相对于 GameServer 工作目录；客户端从资源目录按同名文件加载。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 读取程序
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | GameServer：TableInit::InitTitleTable 用 DBCFile::OpenFromTXT 打开 "../Public/Config/CharTitle.txt"；客户端经 DBC_TITLE_NAME 读同一份，用于把 #编号形式的称号文本展开
|-
| 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。
|}

加载先断言列数大于 7、行数在 0 到 TITLE_MAX_NUM（1000）之间，然后逐行校验：名称长度必须小于 MAX_CHARACTER_TITLE（34），逻辑类型必须在 0 到 65535 之间，等级必须在 0 到 255 之间。

{| 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;" | 必须大于 7。等于或小于 7 直接 return，整表不加载。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 行号怎么定位
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 两端都用记录下标（行号），第 1 列必须等于从 0 起的行号。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 名称长度
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 必须小于 34 字节，超了记错误日志、断言并整表作废。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 逻辑类型与等级
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 分别是 0 到 65535 与 0 到 255，越界同样整表作废。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 4、8 列
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 描述与注释，服务端不读；描述只有客户端读。
|-
| 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;">TransTitleStr</code> 只处理 # 开头且第二个字符不是 - 的文本，且编号大于 100 才查表。
|}

== 文件格式 ==
首行是类型行：<code style="white-space:normal;overflow-wrap:anywhere;">INT INT STRING STRING INT INT INT 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：ID
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 称号编号，同时是 DBC 索引列。服务端写入 m_nTitleIndex，客户端与服务端都按行号（记录下标）查找，因此它必须等于从 0 起的行号。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 必填且必须连续。样本 260 行的编号正好是 0 到 259。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 2 列</code> INT：类型(策划分类用)
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 策划分类用的类型。服务端写入 m_nType，只断言非负。
| 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：名称$1$
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 称号名称。服务端拷进 m_szTitle，长度必须小于 MAX_CHARACTER_TITLE（34），否则记错误日志、断言并整表作废。
| 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> STRING：描述$1$
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 称号描述。服务端完全不读本列；客户端 _DBC_TITLE_NAME 把它读成 szTitleDesc。
| 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;">第 5 列</code> INT：逻辑类型(程序用)
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 程序用的逻辑类型。服务端写入 m_wLogicID，必须落在 0 到 65535 之间。
| 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;">第 6 列</code> INT：等级
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 称号等级。服务端写入 m_byGrade，必须落在 0 到 255 之间。
| 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;">第 7 列</code> INT：时间
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 有效时间。服务端写入 m_nTime。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 空为 0。样本几乎全是 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 8 列</code> STRING：注释
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 注释。服务端与客户端都不读取本列。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 不生效。
|}

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

=== 把 91 号称号的等级从 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 STRING INT INT INT STRING
ID 类型(策划分类用) 名称$1$ 描述$1$ 逻辑类型(程序用) 等级时间注释
91 2 $N的夫君在天愿做比翼鸟，在地愿做连理枝。 2 1 -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 STRING INT INT INT STRING
ID 类型(策划分类用) 名称$1$ 描述$1$ 逻辑类型(程序用) 等级时间注释
91 2 $N的夫君在天愿做比翼鸟，在地愿做连理枝。 2 2 -1 夫妻</pre>

按第 1 列定位 91 号称号（$N的夫君）。第 6 列是等级，样本值 1，这里改成 2，其余 7 列与另 259 行全部保留。

等级按 BYTE 保存，必须落在 0 到 255 之间；超出会让整张称号表作废，而不是只丢这一行。第 5 列逻辑类型是另一个维度，改等级不会影响它。

示例块含类型行、列名行与该行原文，不能覆盖整张表。改完需要重启 Server，并同步更新客户端资源。

== 验证与排查 ==
Server 启动日志出现 “Load Chartitle.txt ... OK!”（日志里写成了 Chartitle）。改完重启后，给角色加上该称号，确认名称、等级与逻辑类型符合新值。若整表没加载，先检查是否有名称超过 33 字节、或逻辑类型 / 等级越界。失败时恢复备份并重启。

=== 一处越界整表作废 ===
名称超长、逻辑类型超出 65535、等级超出 255，任一发生都会 <code style="white-space:normal;overflow-wrap:anywhere;">SAFE_DELETE_ARRAY</code> 并把计数清 0。后果是全部称号消失，排查时不要只看改的那一行。

=== 编号必须等于行号 ===
服务端按行顺序写入数组，客户端用 <code style="white-space:normal;overflow-wrap:anywhere;">Search_LineNum_EQU</code> 按行号查。样本 260 行的编号正好是 0 到 259。插行而不重排会让后面全部错位。

=== 日志名拼写 ===
成功日志是 “Load Chartitle.txt”，比文件名少一个大写 T。

=== 客户端只映射前 4 列 ===
<code style="white-space:normal;overflow-wrap:anywhere;">_DBC_TITLE_NAME</code> 有 4 个字段，对应编号、类型、名称与描述。第 5 列及之后客户端结构体没有对应字段。

== 关联与依据 ==
[[工程参考/配置文件/Public/CharHead.txt|Public/CharHead.txt]]

[[工程参考/配置文件索引|其他配置及整理状态]] · [[工程参考/服务端外网设置|服务端外网设置]] · [[Lua接口/服务端函数索引|Lua 接口索引]]

* <code style="white-space:normal;overflow-wrap:anywhere;">Common/DataBase/TLBB_DBC.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Common/DataBase/TLBB_DBC.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Main/GameTable.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Main/GameTable.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Common/ServerBase/FileDef.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Client/Client/Common/TDDBC_Struct.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Client/Client/Game/DBC/GMDataBase.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Client/Client/Game/Interface/GMGameInterface_Script_PlayerMySelf.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/CharTitle.txt</code>：实际加载、解析、字段使用或示例关联依据

本页核对 InitTitleTable 的 6 列读取、列数大于 7 与行数上限 1000、名称 34 字节与逻辑类型 65535 / 等级 255 的越界处理，以及客户端 _DBC_TITLE_NAME 的 4 字段映射与 TransTitleStr 的展开条件；样本 260 行的编号与行号一致性经脚本核算。未启动服务端与客户端，称号的实际显示需要实测。
</div>
[[Category:工程参考]]

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

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

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