工程参考/配置文件/Public/CityIdOfChina.txt

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


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

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

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

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

文件位置与生效

项目 说明
运行文件 ../Public/Config/CityIdOfChina.txt，路径写死在加载函数里，相对于 Server 工作目录；客户端从资源目录按同名文件加载。改一边不够，两边都要同步。
读取程序 Server 进程：TableInit::InitIPRegionInfoTable 打开 "../Public/Config/CityIdOfChina.txt" 建立编号→地名索引；客户端 GMDataBase 以 DBC_CITY_ID_OF_CHINA（218）注册同名文件，聊天标签从它取名
生效方法 正常保存并停服后重启 Server；客户端一侧需要随资源更新并重启客户端。当前检索未发现单独重载本文件的可用入口。
样本格式 GB18030-compatible，CRLF。保留原编码；源码读取器不会自动把中文转为 UTF-8。

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

环节 出处与作用
服务端 InitIPRegionInfoTable 建立数组，AttrRefesh 在属性变化时把编号发出去，角色初始化时用同样的方式校验并兜底。
客户端标签 BuildIPRegionLabel 按编号查表：总是显示省份名，第 4 列为 1 时再拼上市名。
聊天传播 CHAT_TYPE_IPREGION 类型的聊天包会带上归属编号，接收方客户端据此显示标签。
兜底编号 角色初始化时如果自己的编号查不到，会被强制设成 1。

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

文件格式

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

字段详解

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

字段与类型 含义与修改要点 缺项或特殊值
第 1 列
INT：ID 		归属地编号，也是查表键。客户端与服务端都用 Search_Index_EQU 或线性扫描比对它。 必须大于 0 且唯一；0、负数、重复都会让整张表加载失败。
第 2 列
STRING：市 		城市名。只有第 4 列为 1 时它才会出现在玩家的标签里；服务端不做业务判断，只存起来。 不能为空，也不能超过缓冲区长度（结构体总长 32 字节，省名市名共享剩余空间）。
第 3 列
STRING：省 		省份或直辖市名。标签里总是显示它，相当于一级地名。 同上，不能为空也不能超长。
第 4 列
INT：直辖市 		是否把市名拼到省名后面。客户端 nCityType == 1 时才追加市名，所以这一列真正的作用更像“显示到市级”。样本里北京、上海、天津、重庆都填 0（它们的省名与市名相同，拼了会重复），其它城市填 1。 只能是 0 或 1，其它值会让整张表加载失败。

常用修改实例

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

把合肥的标签从「[安徽合肥]」改成「[安徽]」

修改前： 

INT	STRING	STRING	INT
ID	市	省	直辖市
551	合肥	安徽	1

修改后： 

INT	STRING	STRING	INT
ID	市	省	直辖市
551	合肥	安徽	0

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

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

验证与排查

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

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

编号 1 是兜底，别动它

角色初始化时如果现有编号查不到，Obj_Human 会把它强制设成 1；样本第 1 行写的市、省都是「火星」。删掉它会让所有兜底玩家拿到一个查不到的标签。

第四列的名字是误导

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

两张布森认

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

缓冲区很紧

_IPREGION_INFO 总共 32 字节，编号占 4 字节，剩下的空间给省名和市名，长地名会被截断或让加载失败。

关联与依据

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

  • Server/Server/GameServer/Server/Main/GameTable.cpp：实际加载、解析、字段使用或示例关联依据
  • Server/Server/GameServer/Server/Main/GameTable.h：实际加载、解析、字段使用或示例关联依据
  • Server/Server/GameServer/Server/Packets/CGCIPRegionHandler.cpp：实际加载、解析、字段使用或示例关联依据
  • Common/DataBase/TLBB_DBC.cpp：实际加载、解析、字段使用或示例关联依据
  • Common/DataBase/TLBB_DBC.h：实际加载、解析、字段使用或示例关联依据
  • Client/Client/Game/DBC/GMDataBase.cpp：实际加载、解析、字段使用或示例关联依据
  • Client/Client/Common/TDDBC_Struct.h：实际加载、解析、字段使用或示例关联依据
  • Client/Client/Game/Interface/GMInterface_Script_Talk.cpp：实际加载、解析、字段使用或示例关联依据
  • Client/Client/Game/Interface/GMGameInterface_Script_DataPool.cpp：实际加载、解析、字段使用或示例关联依据
  • resources/Public/Config/CityIdOfChina.txt：实际加载、解析、字段使用或示例关联依据

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

检索自“https://www.waylee.net/index.php?title=工程参考/配置文件/Public/CityIdOfChina.txt&oldid=1445”