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

来自天龙知识库
雪舞留言 | 贡献2026年9月12日 (六) 01:58的版本 (维护配置文件知识库:完整字段、读取范围、手工修改实例与核对状态)
(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)
跳到导航跳到搜索


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

CharMount.txt 登记坐骑。第 1 列是编号,第 3 到 12 列依次是准乘人数、模型编号、抬高高度、配方、主坐动作组、主绑定点、副坐动作组、副绑定点、移动声音与可否跳跃。样本 57 行、12 列。

服务端读 9 个整型与浮点列,三个字符串列(名称、主绑定点、副绑定点)一律置空不读;客户端的结构体覆盖全部 12 列。

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

文件位置与生效

项目 说明
运行文件 ../Public/Config/CharMount.txt(宏 FILE_CHARMOUNT),相对于 GameServer 工作目录;客户端从资源目录按同名文件加载。
读取程序 GameServer:TableInit::InitDRideInfoTable 用 DBCFile::OpenFromTXT 打开 FILE_CHARMOUNT;客户端经 DBC_CHARACTER_MOUNT 读同一份
生效方法 停服后备份并修改实际副本,重启 Server;客户端一侧需要随资源更新并重启客户端。
样本格式 GB18030-compatibleCRLF。保留原编码;源码读取器不会自动把中文转为 UTF-8。

服务端按 _DBC_CHARACTER_MOUNT 枚举取列:ID=0、NAME=1、MAXPASSENGERCOUNT=2、MODELID=3、ADDHEIGHT=4、RECIPE=5、MAINACTIONFILEINDEX=6、MAINATTACHLOCATOR=7、SECONDACTIONFILEINDEX=8、SECONDATTACHLOCATOR=9、MOVESOUNDID=10、CANJUMP=11。

检查项 结论
编号怎么定位 直接当作数组下标 m_aDRideInfo[nDataID],必须落在 0 到 149 之间(MAX_DRIDE_INFO_COUNT)。
编号越界 AssertEx 并 continue,只跳过该行,其余照常加载。
字符串列 第 2、8、10 列服务端置空,只有客户端读。
哪个是 FLOAT 第 5 列抬高高度。
可否跳跃 第 12 列,非 0 表示可以跳跃。

文件格式

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

字段详解

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

字段与类型 含义与修改要点 缺项或特殊值
第 1 列
INT:ID
坐骑编号。服务端把它当作数组下标写入 m_aDRideInfo[nDataID],不在 0 到 149 之间会 AssertEx 并跳过该行。 空为 0。
第 2 列
STRING:名称
服务端不读取。坐骑名称。服务端把 m_pszName 置空,不读取本列。 服务端不生效。
第 3 列
INT:准乘人数
准乘人数。保存为 m_nMaxPassengerCount。 空为 0。
第 4 列
INT:ModelID
模型编号。保存为 m_nModelID。 空为 0。
第 5 列
FLOAT:AddHeight
骑乘后角色抬高的高度,按 FLOAT 读取。保存为 m_fAddHeight。 空为 0。
第 6 列
INT:RideRecipe
骑乘配方编号。保存为 m_nRecipe。 空为 0。
第 7 列
INT:主坐动作组索引
主坐动作组索引。保存为 m_nMainActionFileIndex。 空为 0。
第 8 列
STRING:主绑定点
服务端不读取。主坐绑定点名称。服务端把 m_pszMainAttachLocator 置空,不读取本列。 服务端不生效。
第 9 列
INT:副坐动作组索引
副坐动作组索引。保存为 m_nSecondActionFileIndex。 空为 0。
第 10 列
STRING:副绑定点
服务端不读取。副坐绑定点名称。服务端把 m_pszSecondAttachLocator 置空,不读取本列。 服务端不生效。
第 11 列
INT:坐骑的移动声音ID
移动声音编号。保存为 m_nMoveSoundID。 空为 0。
第 12 列
INT:是否能跳跃
是否能跳跃。保存为 m_nCanJump。 空为 0。

常用修改实例

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

把 0 号坐骑(虎)改成不能跳跃

修改前:

INT	STRING	INT	INT	FLOAT	INT	INT	STRING	INT	STRING	INT	INT
ID	名称	准乘人数	ModelID	AddHeight	RideRecipe	主坐动作组索引	主绑定点	副坐动作组索引	副绑定点	坐骑的移动声音ID	是否能跳跃
0	虎	1	1010	0.5	447	0	attach1	0	attach1	-1	1

修改后:

INT	STRING	INT	INT	FLOAT	INT	INT	STRING	INT	STRING	INT	INT
ID	名称	准乘人数	ModelID	AddHeight	RideRecipe	主坐动作组索引	主绑定点	副坐动作组索引	副绑定点	坐骑的移动声音ID	是否能跳跃
0	虎	1	1010	0.5	447	0	attach1	0	attach1	-1	0

按第 1 列定位 0 号坐骑(虎)。第 12 列是是否能跳跃,样本值 1,这里改成 0,其余 11 列与另 56 行全部保留。

第 2 列名称「虎」与第 8、10 列的绑定点服务端都不读,改它们只影响客户端。第 5 列抬高高度是 FLOAT,样本值 0.5。

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

验证与排查

Server 启动日志出现 “Load CharMount.txt ... OK!”。改完重启后上马,确认抬升高度、准乘人数、移动声音与跳跃行为符合新值。若日志出现 “Invalid CharMount ID”,说明有行的第 1 列落在 0 到 149 之外,那一行会被跳过。失败时恢复备份并重启。

编号就是数组下标

第 1 列必须落在 0 到 149 之间。越界的那一行会被 AssertEx 并跳过,其余行照常加载,所以症状常常是「某一个坐骑不见了」。

三个字符串列服务端不读

名称、主绑定点、副绑定点都被置成 NULL。改它们不会影响服务端,只会影响客户端显示与挂点。

只有抬高高度是浮点

第 5 列按 FLOAT 读取,其余整型列按 INT。类型行写错会让解析值完全不同。

和 Public/BusInfo.txt 的区别

BusInfo 是交通工具(有路线与停站),CharMount 是玩家坐骑,两张表编号空间独立,不要互相参照。

关联与依据

Public/BusInfo.txt

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

  • Common/DataBase/TLBB_DBC.cpp:实际加载、解析、字段使用或示例关联依据
  • Common/DataBase/TLBB_DBC.h:实际加载、解析、字段使用或示例关联依据
  • Server/Server/GameServer/Server/Main/GameTable.cpp:实际加载、解析、字段使用或示例关联依据
  • Server/Server/GameServer/Server/Main/GameTable.h:实际加载、解析、字段使用或示例关联依据
  • Common/ServerBase/FileDef.h:实际加载、解析、字段使用或示例关联依据
  • Client/Client/Common/TDDBC_Struct.h:实际加载、解析、字段使用或示例关联依据
  • Client/Client/Game/DBC/GMDataBase.cpp:实际加载、解析、字段使用或示例关联依据
  • resources/Public/Config/CharMount.txt:实际加载、解析、字段使用或示例关联依据

本页核对 InitDRideInfoTable 的 _DBC_CHARACTER_MOUNT 枚举落点(0、2、3、4、5、6、8、10、11)、MAX_DRIDE_INFO_COUNT=150、编号越界只跳该行的行为、第 5 列的 FLOAT 读取,以及客户端 _DBC_CHARACTER_MOUNT 的 12 字段;样本 57 行的列宽与编号唯一性经脚本核算。未启动服务端与客户端,骑乘表现需要实测。