工程参考/配置文件/Server/ShimenRoundMultipleTable.txt

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


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

师门任务是每天一轮的固定环任务,这张表给出「第几环乘多少」的倍率:第 1 列的环数、第 2 列金钱倍率、第 3 列经验倍率。样本 20 行,环数 1 到 20,金钱倍率从 0.7 逐环递增,经验倍率从 1 开始递增。

脚本按环号取值,环号必须严格等于行号 + 1,否则整张表会被清掉。

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

文件位置与生效

项目 说明
运行文件 ./Config/ShimenRoundMultipleTable.txt,由 FileDef.h 的 FILE_SHIMEN_ROUND_MULTIPLE 定义,相对于 Server 工作目录。
读取程序 Server 进程:TableInit::InitShimenRoundMultipleTable 打开 FILE_SHIMEN_ROUND_MULTIPLE;LuaFnGetMoneyMultipleByRound / LuaFnGetExpMultipleByRound 供脚本调用
生效方法 正常保存并停服后重启 Server。当前检索未发现单独重载本文件的可用入口。
样本格式 GB18030-compatibleCRLF。保留原编码;源码读取器不会自动把中文转为 UTF-8。

加载要求行数**恰好等于** MAX_SHIMENROUNDMULTIPLE_NUM(20)、列数**恰好等于** 3。随后逐行读三列,并断言 m_nRound == i + 1

约束 行为
行数不等于 20 Assert 并返回,什么都不读。
列数不等于 3 Assert 并返回。
环数不等于行号 + 1 把整张表 memset 成 0 并返回——所有倍率变成 0,脚本计算结果也变成 0。
查询范围 Lua 要求入参 1 到 20,超出才 return 0,不会崩。

注意这里的失败是「静默清零」而不是断电:加载日志一样会打印 OK,但实际倍率全是 0。

文件格式

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

字段详解

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

字段与类型 含义与修改要点 缺项或特殊值
第 1 列
INT:环数
第几环。必须等于本行的行号 + 1(第一行是 1),但**程序不按它的值做查找**——写入数组的第 i 项就等于第 i+1 环。 不等于行号 + 1 时整张表被清零。
第 2 列
FLOAT:金钱倍率
该环获得的金钱倍率。样本第 1 环 0.7,逐环递增。 DBC 读取器按 FLOAT 解析;写非数字文本会被解析成 0。
第 3 列
FLOAT:经验倍率
该环获得的经验倍率。样本第 1 环 1,逐环递增。 同上。

常用修改实例

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

把第 1 环的金钱倍率从 0.7 提高到 0.8

修改前:

INT	FLOAT	FLOAT
环数	金钱倍率	经验倍率
1	0.7	1

修改后:

INT	FLOAT	FLOAT
环数	金钱倍率	经验倍率
1	0.8	1

按第 1 列定位环数 1。原本金钱倍率 0.7、经验倍率 1,这里只把第 2 列改成 0.8,经验倍率与其余 19 行保持原样。

改完重启 Server,GetMoneyMultipleByRound(1) 返回 0.8。实际到手的金钱还要乘脚本里的基础值与玩家等级相关项,这里只是其中一个乘数。示例块含类型行、列名行与该行原文,不能覆盖整表。

验证与排查

启动日志出现 “Load ShimenRoundMultipleTable.txt ... OK!”。但要小心:**环数与行号不匹配时日志同样会打 OK**,只是所有倍率被清零——判断是否真的读进来的办法是在脚本里打印某一环的返回值,非 0 才算成功。

改动后重启 Server,跑一轮师门任务并核对实际获得的金钱与经验,确认与倍率乘积一致。

行数与列数都必须正好

要 20 行 3 列。这不是「至少」,是多一行少一行都会加载失败。

环数错位的代价是整表清零

把某一行的环数写错会让 memset 把整张表填 0,脚本的结果变成 0;而启动日志看起来依然正常。

=== 查询入口是有范围的 ===Lua 接口要求入参 1 到 20,超出直接 return 0,并且除了 Assert 之外没有任何提示(Release 下 Assert 不触发)。

倍率是乘数不是绝对值

0.7 不代表 0.7 文钱,它乘在脚本计算出的基础收益上。

与等级奖励是两张不同的表

旁边还有一张 MAX_SHIMENLEVEL_BONUS_NUM = 141 的等级奖励表,与本表的环数倍率不是一个概念。

关联与依据

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

  • Server/Server/GameServer/Server/Main/GameTable.cpp:实际加载、解析、字段使用或示例关联依据
  • Server/Server/GameServer/Server/Main/GameTable.h:实际加载、解析、字段使用或示例关联依据
  • Server/Server/GameServer/Server/Script/LuaFnTbl_Mission.h:实际加载、解析、字段使用或示例关联依据
  • Server/Server/GameServer/Server/Script/LuaFnRegister.cpp:实际加载、解析、字段使用或示例关联依据
  • Common/ServerBase/FileDef.h:实际加载、解析、字段使用或示例关联依据
  • Common/DataBase/TLBB_DBC.cpp:实际加载、解析、字段使用或示例关联依据
  • Common/DataBase/TLBB_DBC.h:实际加载、解析、字段使用或示例关联依据
  • resources/Server/Config/ShimenRoundMultipleTable.txt:实际加载、解析、字段使用或示例关联依据

本页核对 InitShimenRoundMultipleTable 的行列断言、「环数 = 行号 + 1」的校验与失败时 memset 清零的行为,以及两个 Lua 取倍率接口的入参范围;未启动服务端与游戏,实际收益需要实测。