工程参考/配置文件/Public/CharMount.txt
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-compatible,CRLF。保留原编码;源码读取器不会自动把中文转为 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 是玩家坐骑,两张表编号空间独立,不要互相参照。
关联与依据
其他配置及整理状态 · 服务端外网设置 · 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 行的列宽与编号唯一性经脚本核算。未启动服务端与客户端,骑乘表现需要实测。