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

2026-09-11T17:58:24Z

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

新页面

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

BusInfo.txt 登记交通工具。第 1 列是编号，第 3 到 9 列是脚本、类型、停站时间、模型、模型高度、准乘人数与行驶速度，第 10 到 25 列是 8 个座位的动作表编号与绑定点名称。样本 6 行、25 列。

服务端只读前 9 列里的 8 个（跳过第 2 列名称），座位区完全不读；客户端的结构体 _DBC_BUS_INFO 覆盖全部 25 列。

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

== 文件位置与生效 ==
{| 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/BusInfo.txt</code>，路径写死在加载函数里，相对于 GameServer 工作目录；客户端从资源目录按同名文件加载。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 读取程序
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | GameServer：TableInit::InitBusInfoTable 用 DBCFile::OpenFromTXT 打开 "../Public/Config/BusInfo.txt"；客户端经 DBC_BUS_INFO 读同一份（结构体多出 8 个座位）
|-
| 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。
|}

加载先断言行数在 0 到 MAX_BUS_INFO_COUNT（2046）之间、列数不少于 9，然后逐行取编号并检查越界与重复。

{| 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;" | 直接当作数组下标 m_aBusInfo[nDataID]，并检查重复。
|-
| 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;" | 第 2 列名称
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端把 m_pszName 置空，不读取；只有客户端结构体读它。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 7、9 列
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 按 FLOAT 读取（模型高度、行驶速度）。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 10 到 25 列
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 8 对「动作表编号 + 绑定点」，服务端不读，正好填满客户端座位数组成员。
|}

== 文件格式 ==
首行是类型行：<code style="white-space:normal;overflow-wrap:anywhere;">INT STRING INT INT INT INT FLOAT INT FLOAT INT STRING INT STRING INT STRING INT STRING INT STRING INT STRING INT STRING 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;" | 交通工具编号。服务端把它当作数组下标写入 m_aBusInfo[nDataID]，并检查重复。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 必须落在 0 到 2045 之间且不能重复；越界或重复会记错误日志、断言并清空整表。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 2 列</code> STRING：名称
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 名称。服务端把 m_pszName 置空，不读取本列；客户端结构体 _DBC_BUS_INFO 把它读成字符串。
| 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;">第 3 列</code> INT：脚本ID
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 脚本编号。保存为 m_nScriptID。
| 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;">第 4 列</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;">第 5 列</code> INT：停站时间(毫秒)
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 停站时间，单位是毫秒。保存为 m_nStopTime。
| 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;">第 6 列</code> INT：模型数据ID
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 模型数据编号。保存为 m_nModelID。
| 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;">第 7 列</code> FLOAT：模型高度
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 模型高度，按 FLOAT 读取。保存为 m_fModelHeight。
| 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;">第 8 列</code> INT：准乘人数
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 准乘人数。保存为 m_nMaxPassengerCount。
| 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;">第 9 列</code> FLOAT：行驶速度
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 行驶速度，按 FLOAT 读取。保存为 m_fMoveSpeed。
| 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;">第 10 列</code> INT：动作表编号0
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 1 个座位的动作表编号。服务端不读；客户端结构体里的座位数组有 8 项，正好对应第 10 到 25 列。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端不生效。填 -1 表示这个座位不存在。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 11 列</code> STRING：绑定点名称0
| 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;">第 12 列</code> INT：动作表编号1
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 2 个座位的动作表编号。服务端不读；客户端结构体里的座位数组有 8 项，正好对应第 10 到 25 列。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端不生效。填 -1 表示这个座位不存在。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 13 列</code> STRING：绑定点名称1
| 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;">第 14 列</code> INT：动作表编号2
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 3 个座位的动作表编号。服务端不读；客户端结构体里的座位数组有 8 项，正好对应第 10 到 25 列。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端不生效。填 -1 表示这个座位不存在。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 15 列</code> STRING：绑定点名称2
| 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;">第 16 列</code> INT：动作表编号3
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 4 个座位的动作表编号。服务端不读；客户端结构体里的座位数组有 8 项，正好对应第 10 到 25 列。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端不生效。填 -1 表示这个座位不存在。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 17 列</code> STRING：绑定点名称3
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 4 个座位的绑定点名称。服务端不读。
| 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;">第 18 列</code> INT：动作表编号4
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 5 个座位的动作表编号。服务端不读；客户端结构体里的座位数组有 8 项，正好对应第 10 到 25 列。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端不生效。填 -1 表示这个座位不存在。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 19 列</code> STRING：绑定点名称4
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 5 个座位的绑定点名称。服务端不读。
| 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：动作表编号5
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 6 个座位的动作表编号。服务端不读；客户端结构体里的座位数组有 8 项，正好对应第 10 到 25 列。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端不生效。填 -1 表示这个座位不存在。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 21 列</code> STRING：绑定点名称5
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 6 个座位的绑定点名称。服务端不读。
| 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：动作表编号6
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 7 个座位的动作表编号。服务端不读；客户端结构体里的座位数组有 8 项，正好对应第 10 到 25 列。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端不生效。填 -1 表示这个座位不存在。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 23 列</code> STRING：绑定点名称6
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 7 个座位的绑定点名称。服务端不读。
| 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;">第 24 列</code> INT：动作表编号7
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 8 个座位的动作表编号。服务端不读；客户端结构体里的座位数组有 8 项，正好对应第 10 到 25 列。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端不生效。填 -1 表示这个座位不存在。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 25 列</code> STRING：绑定点名称7
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 8 个座位的绑定点名称。服务端不读。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 服务端不生效。
|}

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

=== 把 0 号交通工具的停站时间从 0 毫秒改为 3000 毫秒 ===
修改前：
<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 INT INT INT INT FLOAT INT FLOAT INT STRING INT STRING INT STRING INT STRING INT STRING INT STRING INT STRING INT STRING
ID 名称脚本ID 类型停站时间(毫秒) 模型数据ID 模型高度准乘人数行驶速度动作表编号0 绑定点名称0 动作表编号1 绑定点名称1 动作表编号2 绑定点名称2 动作表编号3 绑定点名称3 动作表编号4 绑定点名称4 动作表编号5 绑定点名称5 动作表编号6 绑定点名称6 动作表编号7 绑定点名称7
0 单程车 -1 0 0 1018 3 1 6 6 attach1 -1 -1 -1 -1 -1 -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 STRING INT INT INT INT FLOAT INT FLOAT INT STRING INT STRING INT STRING INT STRING INT STRING INT STRING INT STRING INT STRING
ID 名称脚本ID 类型停站时间(毫秒) 模型数据ID 模型高度准乘人数行驶速度动作表编号0 绑定点名称0 动作表编号1 绑定点名称1 动作表编号2 绑定点名称2 动作表编号3 绑定点名称3 动作表编号4 绑定点名称4 动作表编号5 绑定点名称5 动作表编号6 绑定点名称6 动作表编号7 绑定点名称7
0 单程车 -1 0 3000 1018 3 1 6 6 attach1 -1 -1 -1 -1 -1 -1 -1 </pre>

按第 1 列定位 0 号交通工具（单程车）。第 5 列是停站时间，单位是毫秒，样本值 0，这里改成 3000，其余 24 列与另 5 行全部保留。

第 2 列名称「单程车」服务端不读，改它不影响任何逻辑；准乘人数在第 8 列、行驶速度在第 9 列，改之前先数清列号。

示例块含类型行、列名行与该行原文，不能覆盖整张表。改完需要重启 Server。

== 验证与排查 ==
Server 启动日志出现 “Load BusInfoTbl.txt ... OK!”（日志里的名字多了 Tbl 三个字母）。改完重启后乘坐对应交通工具，确认停站时长、准乘人数与行驶速度符合新值。若日志出现 invalid or duplicate ID，说明编号越界或重复，整表此时已被清空。失败时恢复备份并重启。

=== 编号直接当数组下标 ===
第 1 列必须落在 0 到 2045 之间且不能重复，否则整表清零。样本只有 6 行，编号 0 到 5。

=== 服务端不读名称与座位 ===
第 2 列与第 10 到 25 列只有客户端用。给服务端改这些列不会有任何效果。

=== 列数只要求不少于 9 ===
断言是 <code style="white-space:normal;overflow-wrap:anywhere;">iColumnCount >= 9</code>，加列不会报错；但删到 9 列以下会直接 return，整表不加载。

=== 两端的名字不一样 ===
成功日志写的是 “BusInfoTbl.txt”，比文件名多三个字母，排查时别当成文件名拼错。

== 关联与依据 ==
[[工程参考/配置文件/Public/CharMount.txt|Public/CharMount.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;">resources/Public/Config/BusInfo.txt</code>：实际加载、解析、字段使用或示例关联依据

本页核对 InitBusInfoTable 的编号下标写入、越界与重复检查、MAX_BUS_INFO_COUNT=2046、列数不少于 9 的断言、第 7/9 列的 FLOAT 读取，以及客户端 _DBC_BUS_INFO 的 8 个座位与第 10 到 25 列的对应；样本 6 行的列宽与编号唯一性经脚本核算。未启动服务端与客户端，乘坐表现需要实测。
</div>
[[Category:工程参考]]

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

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

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