工程参考/配置文件/Server/ShimenRoundMultipleTable.txt
师门任务是每天一轮的固定环任务,这张表给出「第几环乘多少」的倍率:第 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-compatible,CRLF。保留原编码;源码读取器不会自动把中文转为 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 取倍率接口的入参范围;未启动服务端与游戏,实际收益需要实测。