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

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


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

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

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

字段详解

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

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

常用修改实例

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

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

修改前:

INT	STRING	INT	INT	FLOAT	INT	INT	INT	STRING	INT	INT	STRING	STRING	STRING	STRING	STRING	INT	INT	INT	INT	INT	INT	FLOAT	INT
INT	STRING	INT	INT	FLOAT	INT	INT	INT	STRING	INT	INT	STRING	STRING	STRING	STRING	STRING	INT	INT	INT	INT	INT	INT	FLOAT	INT
0	虎	1	1010	0.5	447	2877	2878	attach1	2877	2878	attach1	attach1	attach1	attach1	attach1	-1	1	-1	-1	0	-1	0	-1

修改后:

INT	STRING	INT	INT	FLOAT	INT	INT	INT	STRING	INT	INT	STRING	STRING	STRING	STRING	STRING	INT	INT	INT	INT	INT	INT	FLOAT	INT
INT	STRING	INT	INT	FLOAT	INT	INT	INT	STRING	INT	INT	STRING	STRING	STRING	STRING	STRING	INT	INT	INT	INT	INT	INT	FLOAT	INT
0	虎	1	1010	0.5	447	2877	2878	attach1	2877	2878	0	attach1	attach1	attach1	attach1	-1	1	-1	-1	0	-1	0	-1

按第 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:实际加载、解析、字段使用或示例关联依据