工程参考/配置文件/Server/ZhuandanOutput.txt
ZhuandanOutput.txt 是转蛋的候选产物表。每一行挂到 ZhuandanBase 的某一行(CrossIndex),按文件顺序填入该转蛋的候选槽。权重在所属转蛋内累计,不在全表累计。
文件位置与生效
| 项目 | 说明 |
|---|---|
| 运行文件 | ./Config/ZhuandanOutput.txt,相对于 Server 工作目录。
|
| 读取程序 | Server 在 ZhuandanBase 之后加载,按 CrossIndex 填入对应转蛋的候选数组 |
| 生效方法 | 与 ZhuandanBase.txt 一起备份。停服后修改实际 Server/Config 副本,再重启 Server。当前检索范围未发现独立重载。客户端不加载本表。 |
| 样本格式 | GB18030-compatible,CRLF。保留原编码;源码读取器不会自动把中文转为 UTF-8。
|
样本 350 行、8 列。Index 必须等于从 0 起的行号。CrossIndex 必须落在已加载的 Base 行范围内。每个 CrossIndex 的行数必须正好等于该 Base 行的 Candidate_Num。第 8 列 NOTE 样本有中文备注,加载器不读。
威力转蛋(CrossIndex 0)25 行,产物权重和 1000000,第一件 30008034 金刚砂权重 120000。
文件格式
首行是类型行:INT INT INT INT INT INT INT STRING;第二行是列名行,程序跳过其内容;从第三行开始读取数据。各列用真实 Tab 分隔,保留首列、空列及行尾,不用空格代替。数据行行首 # 表示注释,分号不是此表的注释规则。首列为空的行被跳过;不足的尾列补为空值,多余列不参与本页字段读取。空整数和非数字经 atoi 可能成为 0,空字符串仍为空,不把解析成功当作业务合法。第一列须唯一,重复会触发读取器错误。
字段详解
列号从 1 开始,源码列下标从 0 开始。
| 字段与类型 | 含义与修改要点 | 缺项或特殊值 |
|---|---|---|
第 1 列INT:Index |
行号。必须等于从 0 起的记录下标,否则整表失败并清空 Base。 | 空首列跳行。不是产物编号。 |
第 2 列INT:CrossIndex |
对应 ZhuandanBase 的行号。同一 CrossIndex 的行按出现顺序填入候选 0..Candidate_Num-1。 | 超出 Base 行数或候选溢出都会失败。 |
第 3 列INT:ProductID |
抽中后发给玩家的物品模板编号。样本第一行 30008034 金刚砂。 | 须 >0。 |
第 4 列INT:ProductNum |
一次抽中发放的件数。脚本按件数循环尝试收取。样本第一行为 1。 | 须 >0。 |
第 5 列INT:Rate |
本候选在所属转蛋内的权重,累加到该转蛋 iTotalRate。威力转蛋第一件样本 120000。 | 须 >0。不是全表百分率。 |
第 6 列INT:Bind |
0 不在本表强制绑定,1 收取后绑定。 | 只能 0 或 1。 |
第 7 列INT:BroadCast |
1 时 Info 再随机选一条 Base 公告模板返回给脚本;0 不返回公告串。 | 只能 0 或 1。脚本是否广播取决于调用方。 |
第 8 列STRING:NOTE |
样本备注。列必须存在,加载器不读。 | 改它不会改变抽取。 |
常用修改实例
示例为局部教学片段,先备份原运行文件,再修改对应行并保留其余配置。教学值不是程序默认值。 以下代码块保留真实 Tab;本地示例文件保留原样本编码、中文表头与 CRLF。网页文字使用浏览器编码显示,不表示运行文件应改存 UTF-8。
把威力转蛋第一件金刚砂的权重从 120000 改为 240000
修改前:
INT INT INT INT INT INT INT STRING Index CrossIndex ProductID ProductNum Rate Bind BroadCast NOTE 0 0 30008034 1 120000 0 0 威力转蛋
修改后:
INT INT INT INT INT INT INT STRING Index CrossIndex ProductID ProductNum Rate Bind BroadCast NOTE 0 0 30008034 1 240000 0 0 威力转蛋
按第一列定位行 0。样本 CrossIndex 0,产物 30008034,数量 1,Rate 120000,Bind 0,BroadCast 0。只把第 5 列改为 240000,保留 8 列和其余 349 行。本片段含表头与该行,不能覆盖整表。
该转蛋总权重由 1000000 变为 1120000。金刚砂份额大约从 120000/1000000 变为 240000/1120000。隔离加载读回该候选 Rate 240000、该转蛋总权重 1120000。实际转蛋结果需要实测。
验证与排查
启动有 Load ZhuandanOutput.txt ... OK!。350 行,各 CrossIndex 计数仍与 Base 一致,第一件权重 240000。用威力转蛋多次抽取看金刚砂是否仍能出现。Candidate 溢出或计数不符会清空整份 Base。恢复备份后重启。
必须先成功加载 Base。只改本表不会增加新的转蛋种类。boxdroplist 系列的转丹开箱不读本表。
关联与依据
Server/ZhuandanBase.txt · Server/ZhuandanConfig.txt · Server/boxdroplist系列 · Public/CommonItem.txt
其他配置及整理状态 · 服务端外网设置 · Lua 接口索引
Server/Server/GameServer/Server/Main/GameTable.cpp:实际加载、解析、字段使用或示例关联依据Server/Server/GameServer/Server/Main/GameTable.h:实际加载、解析、字段使用或示例关联依据Server/Server/GameServer/Server/Script/LuaFnTbl_Misc.h:实际加载、解析、字段使用或示例关联依据Server/Server/GameServer/Server/Script/LuaFnRegister.cpp:实际加载、解析、字段使用或示例关联依据resources/Public/Data/Script/obj/item/Zhuandan_Common.lua:实际加载、解析、字段使用或示例关联依据resources/Server/Config/ZhuandanBase.txt:实际加载、解析、字段使用或示例关联依据resources/Server/Config/ZhuandanOutput.txt:实际加载、解析、字段使用或示例关联依据
原始 DBC、Base 与 Output 联合加载隔离测试。Lua 随机抽取未在游戏中执行。