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

2026-09-11T16:49:48Z

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

新页面

{{DISPLAYTITLE:<span style="font-size:24px;line-height:1.4;overflow-wrap:anywhere;">工程参考/配置文件/Public/CityIdOfChina.txt</span>}}
__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;">
[[首页|首页]] · [[工程参考/配置文件索引|配置文件索引]] · [[工程参考/配置文件修改约定|修改约定]]

CityIdOfChina.txt 把一套 IP 归属地编号翻译成可读的地名：第 1 列是编号，第 2 列市，第 3 列省，第 4 列决定是否把市名拼到省名后面。样本 340 行、4 列。

玩家登录后会把自己的归属地编号同步给服务端，服务端用它换显示标签并广播给周围的人。

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

== 文件位置与生效 ==
{| 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/CityIdOfChina.txt</code>，路径写死在加载函数里，相对于 Server 工作目录；客户端从资源目录按同名文件加载。改一边不够，两边都要同步。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 读取程序
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | Server 进程：TableInit::InitIPRegionInfoTable 打开 "../Public/Config/CityIdOfChina.txt" 建立编号→地名索引；客户端 GMDataBase 以 DBC_CITY_ID_OF_CHINA（218）注册同名文件，聊天标签从它取名
|-
| 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。
|}

加载时要求**列数正好 4**、行数大于 0，逐行读四列并做完整校验：编号必须大于 0、不能与前面的行重复、城市名与省份名都必须存在且放得进缓冲区、第 4 列只能是 0 或 1。任一条件不满足都会打印 <code style="white-space:normal;overflow-wrap:anywhere;">Failed! row=… region=…</code> 并 Assert(FALSE)，整张表 CleanUp。

{| 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;" | InitIPRegionInfoTable 建立数组，AttrRefesh 在属性变化时把编号发出去，角色初始化时用同样的方式校验并兜底。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 客户端标签
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | BuildIPRegionLabel 按编号查表：总是显示省份名，第 4 列为 1 时再拼上市名。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 聊天传播
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | CHAT_TYPE_IPREGION 类型的聊天包会带上归属编号，接收方客户端据此显示标签。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 兜底编号
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 角色初始化时如果自己的编号查不到，会被强制设成 1。
|}

编号为 1 的那一行是「火星」——任何查不到归属地的玩家都会落到这里，所以**不要删掉或改掉第 1 行**。

== 文件格式 ==
首行是类型行：<code style="white-space:normal;overflow-wrap:anywhere;">INT STRING STRING INT</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><br>INT：ID
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 归属地编号，也是查表键。客户端与服务端都用 <code style="white-space:normal;overflow-wrap:anywhere;">Search_Index_EQU</code> 或线性扫描比对它。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 必须大于 0 且唯一；0、负数、重复都会让整张表加载失败。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 2 列</code><br>STRING：市
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 城市名。只有第 4 列为 1 时它才会出现在玩家的标签里；服务端不做业务判断，只存起来。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 不能为空，也不能超过缓冲区长度（结构体总长 32 字节，省名市名共享剩余空间）。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 3 列</code><br>STRING：省
| 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;">第 4 列</code><br>INT：直辖市
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 是否把市名拼到省名后面。客户端 <code style="white-space:normal;overflow-wrap:anywhere;">nCityType == 1</code> 时才追加市名，所以这一列真正的作用更像“显示到市级”。样本里北京、上海、天津、重庆都填 0（它们的省名与市名相同，拼了会重复），其它城市填 1。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 只能是 0 或 1，其它值会让整张表加载失败。
|}

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

=== 把合肥的标签从「[安徽合肥]」改成「[安徽]」 ===
修改前：
<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 STRING STRING INT
ID 市省直辖市
551 合肥安徽 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 STRING STRING INT
ID 市省直辖市
551 合肥安徽 0</pre>

按第 1 列定位编号 551（市合肥，省安徽）。原本第 4 列是 1，客户端会把省名与市名拼起来显示成 [安徽合肥]；改成 0 之后只显示省名 [安徽]。

这一列服务端原样保存，真正消费它的是客户端的 BuildIPRegionLabel。改完既要在服务端重启 Server 才能让对象属性更新，也要同步客户端资源并重开客户端才会看到新的标签。示例块含类型行、列名行与该行原文，不能覆盖整表。

== 验证与排查 ==
启动日志出现 “Load InitIPRegionInfoTable ... OK!”；编号重复、编号非正、第 4 列写 2、城市名或省份名过长都会打印 “Load CityIdOfChina.txt ... Failed! row=… region=…” 并 Assert。

验证显示效果需要客户端：登录后在聊天框发一条归属地可见的发言（CHAT_TYPE_IPREGION），或观察周围角色属性刷新后的标签。改某个编号或用不存在的编号时，玩家会被兜底设成编号 1（火星）。

=== 编号 1 是兜底，别动它 ===
角色初始化时如果现有编号查不到，<code style="white-space:normal;overflow-wrap:anywhere;">Obj_Human</code> 会把它强制设成 1；样本第 1 行写的市、省都是「火星」。删掉它会让所有兜底玩家拿到一个查不到的标签。

=== 第四列的名字是误导 ===
它实际说的是“标签里要不要拼市名”，不是“这是不是直辖市”。样本里四个直辖市都填 0，普通城市填 1，正好相反。

=== 两张布森认 ===
服务端按数组线性扫描，客户端用 DBC 检索；两边读同一份结构但各存一份文件内容，改完必须同步否则出现「有编号但不显示」或「显示成 Unknown」的错配。

=== 缓冲区很紧 ===
<code style="white-space:normal;overflow-wrap:anywhere;">_IPREGION_INFO</code> 总共 32 字节，编号占 4 字节，剩下的空间给省名和市名，长地名会被截断或让加载失败。

== 关联与依据 ==

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

* <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;">Server/Server/GameServer/Server/Packets/CGCIPRegionHandler.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <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;">Client/Client/Game/DBC/GMDataBase.cpp</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/Interface/GMInterface_Script_Talk.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Client/Client/Game/Interface/GMGameInterface_Script_DataPool.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/CityIdOfChina.txt</code>：实际加载、解析、字段使用或示例关联依据

本页核对 InitIPRegionInfoTable 的四列读取与全部校验条件、服务端角色初始化把未知编号兜底为 1 的行为，以及客户端 BuildIPRegionLabel 里第 4 列决定“是否拼市名”的用法；未启动服务端与游戏，聊天标签的实际显示需要实测。
</div>
[[Category:工程参考]]

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

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

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