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

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


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

ZhuandanOutput.txt 是转蛋的候选产物表。每一行挂到 ZhuandanBase 的某一行(CrossIndex),按文件顺序填入该转蛋的候选槽。权重在所属转蛋内累计,不在全表累计。

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

文件位置与生效

项目 说明
运行文件 ./Config/ZhuandanOutput.txt,相对于 Server 工作目录。
读取程序 Server 在 ZhuandanBase 之后加载,按 CrossIndex 填入对应转蛋的候选数组
生效方法 与 ZhuandanBase.txt 一起备份。停服后修改实际 Server/Config 副本,再重启 Server。当前检索范围未发现独立重载。客户端不加载本表。
样本格式 GB18030-compatibleCRLF。保留原编码;源码读取器不会自动把中文转为 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 随机抽取未在游戏中执行。