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

2026-09-11T13:50:29Z

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

新页面

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

CityBuilding.txt 登记城市里每一座建筑。第 1 到 8 列是基础信息（其中第 3、7、8 列是给客户端与编辑器用的名称与摆放数据，服务端不读）；第 9 到 13 列是 1 到 5 级的升级条件，第 14 到 18 列是对应等级引用的研究集合，第 19 到 23 列是对应等级的维护消耗。样本 3240 行、23 列。

升级条件指向 Public/Condition.txt 的行号，研究集合指向 Public/ResearchItem.txt 的行号，两者都是 1 起。

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

== 文件位置与生效 ==
{| 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/CityBuilding.txt</code>，由 FileDef.h 的 FILE_CITY_BUILDING 定义，相对于 World 工作目录；客户端从资源目录按同名文件加载。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 读取程序
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | World 进程：TableInit::Init_CityBuilding 用 FILE_CITY_BUILDING 宏（"../Public/Config/CityBuilding.txt"）打开；客户端 GMDataBase.cpp 以 DBC_CITY_BUILDING 注册同名文件，不限列数
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 生效方法
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 正常保存并停 World 后重启 World；客户端一侧需要随资源更新并重启客户端。当前检索未发现单独重载本文件的可用入口。
|-
| 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。
|}

服务端 Init_CityBuilding 逐行读取，跳过第 3 列（名称）、第 7、8 列（Gfx 位置与旋转）——这三列只有客户端结构里才有对应字段。随后对 nLevel 从 0 到 MAX_BUILDING_LEVEL-1（即 5 个等级）分别读 0 基 8+nLevel、13+nLevel、18+nLevel 三列。

{| 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;" | 第 9 到 13 列
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 0 基 8+nLevel
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | nLevelRequire：升到该等级所需的 Condition.txt 编号（1 起）。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 14 到 18 列
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 0 基 13+nLevel
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | nResearchItem：该等级引用的 ResearchItem.txt 集合号（1 起）。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 19 到 23 列
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 0 基 18+nLevel
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | nLevelMaintain：该等级的维护消耗。
|}

{| 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;" | LevelRequire 列名写 1 到 5，ResearchItem 与 Maintain 列名写 0 到 4，但代码一律按 0 基数组使用。列名不能当列号用。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 等级是叠加的
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 取研究集合时 for Level 从 0 到当前等级，高等级建筑会叠加低等级的所有集合。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | -1 的含义
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 研究集合列填 -1 表示该等级没有研究项；升级条件列为 -1 会被引擎当成非法编号拒绝。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | BuildingType 是下标
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 4 列直接作为 <code style="white-space:normal;overflow-wrap:anywhere;">m_Builds[BuildingType]</code> 的下标，取值 0 到 17。
|}

== 文件格式 ==
首行是类型行：<code style="white-space:normal;overflow-wrap:anywhere;">INT INT STRING INT INT INT STRING STRING INT INT INT INT INT INT INT INT INT INT INT INT INT INT 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> INT：ID
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 建筑记录编号，同时是 DBC 索引列。加载后写进城市数据的 m_BuildingID。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 必须唯一且非空；重复触发 DBC 重复索引错误，空首列使整行被跳过。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 2 列</code> INT：CityID
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 该建筑所在城市的场景 ID。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 加载时断言落在 0 到 MAX_SCENE-1（1023）。填错会让建筑挂到别的城市。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 3 列</code> STRING：Name$1$
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 建筑名称。服务端不读这一列，只存在于客户端结构 <code style="white-space:normal;overflow-wrap:anywhere;">_DBC_CITY_BUILDING::szCityName</code> 与编辑器数据里。
| 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> INT：BuildingType
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 逻辑建筑类型，直接作为 <code style="white-space:normal;overflow-wrap:anywhere;">m_Builds[BuildingType]</code> 的下标：0 县衙、1 厢房、2 酒肆、3 钱庄、4 防具、5 锻台、6 武具、7 米仓、8 城墙、9 集仿、10 医舍、11 武仿、12 箭塔、13 书房、14 奇迹、15 校场、16 火冰塔、17 大旗。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 加载时断言落在 0 到 BUILDING_MAX（18）。同一城市同一类型只能有一行生效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 5 列</code> INT：BuildingID
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 建筑的资源 ID，客户端按它去建筑定义表里取模型与图标。
| 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：InitialLevel
| 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;">第 7 列</code> STRING：GfxPosition
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 建筑在场景里的摆放坐标，三个数字用空格分隔（例如 400 1200 -5600）。服务端不读这一列。
| 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;">第 8 列</code> STRING：GfxOrientation
| 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;">第 9 列</code> INT：LevelRequire1
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 升到第 1 级所需的 Condition.txt 条件编号（1 起）。加载后存进 <code style="white-space:normal;overflow-wrap:anywhere;">m_nCondition[0]</code>，由 BuildingCore::CanLevelUp 在升级时校验并扣除。注意列名从 1 起，代码下标从 0 起。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 加载时断言 >= -1。实际升级时编号必须落在 1 到 Condition.txt 行数之间，否则日志出现 iCondition 相关错误并失败。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 10 列</code> INT：LevelRequire2
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 升到第 2 级所需的 Condition.txt 条件编号（1 起）。加载后存进 <code style="white-space:normal;overflow-wrap:anywhere;">m_nCondition[1]</code>，由 BuildingCore::CanLevelUp 在升级时校验并扣除。注意列名从 1 起，代码下标从 0 起。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 加载时断言 >= -1。实际升级时编号必须落在 1 到 Condition.txt 行数之间，否则日志出现 iCondition 相关错误并失败。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 11 列</code> INT：LevelRequire3
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 升到第 3 级所需的 Condition.txt 条件编号（1 起）。加载后存进 <code style="white-space:normal;overflow-wrap:anywhere;">m_nCondition[2]</code>，由 BuildingCore::CanLevelUp 在升级时校验并扣除。注意列名从 1 起，代码下标从 0 起。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 加载时断言 >= -1。实际升级时编号必须落在 1 到 Condition.txt 行数之间，否则日志出现 iCondition 相关错误并失败。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 12 列</code> INT：LevelRequire4
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 升到第 4 级所需的 Condition.txt 条件编号（1 起）。加载后存进 <code style="white-space:normal;overflow-wrap:anywhere;">m_nCondition[3]</code>，由 BuildingCore::CanLevelUp 在升级时校验并扣除。注意列名从 1 起，代码下标从 0 起。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 加载时断言 >= -1。实际升级时编号必须落在 1 到 Condition.txt 行数之间，否则日志出现 iCondition 相关错误并失败。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 13 列</code> INT：LevelRequire5
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 升到第 5 级所需的 Condition.txt 条件编号（1 起）。加载后存进 <code style="white-space:normal;overflow-wrap:anywhere;">m_nCondition[4]</code>，由 BuildingCore::CanLevelUp 在升级时校验并扣除。注意列名从 1 起，代码下标从 0 起。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 加载时断言 >= -1。实际升级时编号必须落在 1 到 Condition.txt 行数之间，否则日志出现 iCondition 相关错误并失败。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 14 列</code> INT：ResearchItem0
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 0 级（代码下标）引用的 ResearchItem.txt 集合号（1 起）。取用代码是 <code style="white-space:normal;overflow-wrap:anywhere;">for(Level = 0; Level <= BuildingLevel; ++Level)</code>，因此高等级建筑会叠加低等级的所有集合，不是只取最高等级这一个。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 加载时断言 >= -1。填 -1 表示该等级没有研究项；填 0 或超出 ResearchItem.txt 行数都会被跳过并写日志。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 15 列</code> INT：ResearchItem1
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 1 级（代码下标）引用的 ResearchItem.txt 集合号（1 起）。取用代码是 <code style="white-space:normal;overflow-wrap:anywhere;">for(Level = 0; Level <= BuildingLevel; ++Level)</code>，因此高等级建筑会叠加低等级的所有集合，不是只取最高等级这一个。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 加载时断言 >= -1。填 -1 表示该等级没有研究项；填 0 或超出 ResearchItem.txt 行数都会被跳过并写日志。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 16 列</code> INT：ResearchItem2
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 2 级（代码下标）引用的 ResearchItem.txt 集合号（1 起）。取用代码是 <code style="white-space:normal;overflow-wrap:anywhere;">for(Level = 0; Level <= BuildingLevel; ++Level)</code>，因此高等级建筑会叠加低等级的所有集合，不是只取最高等级这一个。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 加载时断言 >= -1。填 -1 表示该等级没有研究项；填 0 或超出 ResearchItem.txt 行数都会被跳过并写日志。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 17 列</code> INT：ResearchItem3
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 3 级（代码下标）引用的 ResearchItem.txt 集合号（1 起）。取用代码是 <code style="white-space:normal;overflow-wrap:anywhere;">for(Level = 0; Level <= BuildingLevel; ++Level)</code>，因此高等级建筑会叠加低等级的所有集合，不是只取最高等级这一个。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 加载时断言 >= -1。填 -1 表示该等级没有研究项；填 0 或超出 ResearchItem.txt 行数都会被跳过并写日志。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 18 列</code> INT：ResearchItem4
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 4 级（代码下标）引用的 ResearchItem.txt 集合号（1 起）。取用代码是 <code style="white-space:normal;overflow-wrap:anywhere;">for(Level = 0; Level <= BuildingLevel; ++Level)</code>，因此高等级建筑会叠加低等级的所有集合，不是只取最高等级这一个。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 加载时断言 >= -1。填 -1 表示该等级没有研究项；填 0 或超出 ResearchItem.txt 行数都会被跳过并写日志。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 19 列</code> INT：Maintain0
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 0 级（代码下标）的维护消耗。
| 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;">第 20 列</code> INT：Maintain1
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 1 级（代码下标）的维护消耗。
| 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;">第 21 列</code> INT：Maintain2
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 2 级（代码下标）的维护消耗。
| 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;">第 22 列</code> INT：Maintain3
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 3 级（代码下标）的维护消耗。
| 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;">第 23 列</code> INT：Maintain4
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 4 级（代码下标）的维护消耗。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 加载时断言非负。
|}

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

=== 让城墙（ID 15）在 0 级就挂上 1 号研究集合 ===
修改前：
<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 INT INT INT STRING STRING INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT
ID CityID Name$1$ BuildingType BuildingID InitialLevel GfxPosition GfxOrientation LevelRequire1 LevelRequire2 LevelRequire3 LevelRequire4 LevelRequire5 ResearchItem0 ResearchItem1 ResearchItem2 ResearchItem3 ResearchItem4 Maintain0 Maintain1 Maintain2 Maintain3 Maintain4
15 205 城墙 8 17 0 400 0 1000 1 0 0 0 1 1 1 1 -1 -1 -1 -1 -1 -1 0 0 0 0 0</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 INT INT INT STRING STRING INT INT INT INT INT INT INT INT INT INT INT INT INT INT INT
ID CityID Name$1$ BuildingType BuildingID InitialLevel GfxPosition GfxOrientation LevelRequire1 LevelRequire2 LevelRequire3 LevelRequire4 LevelRequire5 ResearchItem0 ResearchItem1 ResearchItem2 ResearchItem3 ResearchItem4 Maintain0 Maintain1 Maintain2 Maintain3 Maintain4
15 205 城墙 8 17 0 400 0 1000 1 0 0 0 1 1 1 1 -1 1 -1 -1 -1 -1 0 0 0 0 0</pre>

按第 1 列定位 ID 15。这是一座城墙（BuildingType 8、BuildingID 17、CityID 205），第 14 列 ResearchItem0 原本是 -1，表示 0 级没有研究项；改成 1 之后，等级 0 的建筑就会引用 ResearchItem.txt 的第 1 个集合（18 项研究）。

研究集合是叠加的：代码从 Level 0 一直取到建筑当前等级，所以 0 级挂上的集合在更高等级依然生效。想让某项只在高级出现，应该改对应等级那一列，而不是 0 级这一列。

示例块含类型行、列名行与该行原文，不能覆盖整张表。改完需要重启 World，客户端如果也要显示研究列表还需同步资源。

== 验证与排查 ==
World 启动日志里 Init_CityBuilding 不会单独打印成功行（它以 Init 的其它日志为准）；CityID、BuildingType、BuildingID、InitialLevel 为负或越界、三组分列为负都会断言。改动后重启 World，进入对应城市的建筑界面核对等级、升级条件提示与维护消耗；再发起升级与研究的完整流程，确认条件编号与集合号都指到了正确的行。失败时恢复备份并重启。

=== 列名起点的两套习惯不要混用 ===
同一张表里 LevelRequire 用 1 到 5 命名，ResearchItem 与 Maintain 用 0 到 4 命名，而代码一律按 0 基数组。看列名数格子必然错位，一律按上表的列号对。

=== 研究集合是逐级叠加的 ===
<code style="white-space:normal;overflow-wrap:anywhere;">for(Level = 0; Level <= BuildingLevel; ++Level)</code> 说明等级 3 的建筑会依次应用下标 0、1、2、3 四个集合。只改最高等级那一列，低等级的集合依然生效。

=== 三列服务端不读 ===
第 3 列名称、第 7 列 GfxPosition、第 8 列 GfxOrientation 在 World 的加载函数里没有出现，只有客户端结构有对应字段。改这三列不影响服务端，改摆放与名称需要同步客户端资源。

=== BuildingType 是数组下标不是枚举名 ===
第 4 列直接用作 <code style="white-space:normal;overflow-wrap:anywhere;">m_Builds[BuildingType]</code>，范围 0 到 17（BUILDING_MAX = 18），与 MAX_CITY_BUILDING_NUM 相同。同一城市里重复的类型只会有一行生效。

=== 客户端整表读取 ===
注册项 DBC_CITY_BUILDING 没有写 nColumnToRead，结构体 <code style="white-space:normal;overflow-wrap:anywhere;">_DBC_CITY_BUILDING</code> 覆盖全部 23 列（含服务端不读的三列）。改列数必须同步改结构体。

== 关联与依据 ==
[[工程参考/配置文件/Public/ResearchItem.txt|Public/ResearchItem.txt]] · [[工程参考/配置文件/Public/Condition.txt|Public/Condition.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/WorldServer/World/Main/WorldTable.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/WorldServer/World/Main/WorldTable.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Common/GameDefine_City.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/WorldServer/World/WorldData/City.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/WorldServer/World/WorldData/IBuilding.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/WorldServer/World/WorldData/BuildingCore.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/WorldServer/World/WorldData/exe/ExeCityResearchLevelUp.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/WorldServer/World/WorldData/exe/ExeCityBuildingLevelUp.cpp</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/GMInterface_Script_City.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/CityBuilding.txt</code>：实际加载、解析、字段使用或示例关联依据

本页核对 Init_CityBuilding 读取的 0 基列号（含被跳过的第 3、7、8 列）、MAX_BUILDING_LEVEL=5 的三列循环、各字段的断言范围，以及 City.cpp 把三组分列写进 IBuilding、BuildingCore::CanLevelUp 用 m_nCondition 校验、研究集合的逐级叠加取法；同时核对客户端 _DBC_CITY_BUILDING 覆盖 23 列与 nResearchItem 的用法。未启动服务端与游戏，城市建筑的实际表现需要实测。
</div>
[[Category:工程参考]]

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

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

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