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

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


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

DiePenalty.txt 是独立于 Punish 三表的一套死亡扣除配置,每一行给出金钱、经验、装备耐久、物品与装备掉落的上下限。它的实现类是 DiePenaltyManager,读取方式与 Punish 系列完全不同。

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

文件位置与生效

项目 说明
运行文件 ./Config/DiePenalty.txt,相对于 Server 工作目录。
读取程序 Server 在 Server::Init 里通过 g_pDiePenaltyManager->Init(1024) 加载;DiePenaltyManager::GetDiePenalty 按编号查询
生效方法 停服后备份并修改实际 Server/Config 副本,再重启 Server。本表在 Server::Init 里一次性读取(Init(1024)),不在 ReloadCombatTables 的清单里,也没有单独重载入口,因此改本表必须重启整个 Server。客户端不加载本表。
样本格式 GB18030-compatibleCRLF。保留原编码;源码读取器不会自动把中文转为 UTF-8。

样本 105 条记录、12 列,容量由 Init(1024) 写死为 1024。第 2 列是说明文字,加载器从第 3 列开始读。

关键差异:第 3 到第 12 列在类型行里都是 STRING,源码按字符串读取再用 atoi 解析,并以「最后一个字符是不是 %」区分两种写法——写 50% 会存成百分比 50,写 5000 会存成绝对值 5000。这是全库少见的「同一列两种语义」写法,改的时候不要把 % 漏掉或补错。

本表不校验列数,缺列时读到空字符串,经 atoi 变成 0,表现为该类型不掉落。

文件格式

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

字段详解

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

字段与类型 含义与修改要点 缺项或特殊值
第 1 列
INT:惩罚记录ID
记录编号,也是 m_papPenaltyInfo 数组下标。 须 ≥0 且小于初始化容量 1024。
第 2 列
STRING:说明
加载器从第 3 列开始读,本列不写入任何成员。 改它不影响运行。
第 3 列
STRING:MoneyMin
源码按字符串读取再用 atoi 解析,并以最后一个字符是否为 % 区分两种写法:写 50% 存成百分比 50,写 5000 存成绝对值 5000。 空字符串经 atoi 为 0,按「该类型不掉落/不扣」处理。
第 4 列
STRING:MoneyMax
源码按字符串读取再用 atoi 解析,并以最后一个字符是否为 % 区分两种写法:写 50% 存成百分比 50,写 5000 存成绝对值 5000。 空字符串经 atoi 为 0,按「该类型不掉落/不扣」处理。
第 5 列
STRING:ExpMin
源码按字符串读取再用 atoi 解析,并以最后一个字符是否为 % 区分两种写法:写 50% 存成百分比 50,写 5000 存成绝对值 5000。 空字符串经 atoi 为 0,按「该类型不掉落/不扣」处理。
第 6 列
STRING:ExpMax
源码按字符串读取再用 atoi 解析,并以最后一个字符是否为 % 区分两种写法:写 50% 存成百分比 50,写 5000 存成绝对值 5000。 空字符串经 atoi 为 0,按「该类型不掉落/不扣」处理。
第 7 列
STRING:EquipDurMin
源码按字符串读取再用 atoi 解析,并以最后一个字符是否为 % 区分两种写法:写 50% 存成百分比 50,写 5000 存成绝对值 5000。 空字符串经 atoi 为 0,按「该类型不掉落/不扣」处理。
第 8 列
STRING:EquipDurMax
源码按字符串读取再用 atoi 解析,并以最后一个字符是否为 % 区分两种写法:写 50% 存成百分比 50,写 5000 存成绝对值 5000。 空字符串经 atoi 为 0,按「该类型不掉落/不扣」处理。
第 9 列
STRING:ItemMin
源码按字符串读取再用 atoi 解析,并以最后一个字符是否为 % 区分两种写法:写 50% 存成百分比 50,写 5000 存成绝对值 5000。 空字符串经 atoi 为 0,按「该类型不掉落/不扣」处理。
第 10 列
STRING:ItemMax
源码按字符串读取再用 atoi 解析,并以最后一个字符是否为 % 区分两种写法:写 50% 存成百分比 50,写 5000 存成绝对值 5000。 空字符串经 atoi 为 0,按「该类型不掉落/不扣」处理。
第 11 列
STRING:EquipMin
源码按字符串读取再用 atoi 解析,并以最后一个字符是否为 % 区分两种写法:写 50% 存成百分比 50,写 5000 存成绝对值 5000。 空字符串经 atoi 为 0,按「该类型不掉落/不扣」处理。
第 12 列
STRING:EquipMax
源码按字符串读取再用 atoi 解析,并以最后一个字符是否为 % 区分两种写法:写 50% 存成百分比 50,写 5000 存成绝对值 5000。 空字符串经 atoi 为 0,按「该类型不掉落/不扣」处理。

常用修改实例

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

把 0 号记录(普通_新手_切磋)的 MoneyMin 从 0 改成 5000

修改前:

INT	STRING	STRING	STRING	STRING	STRING	STRING	STRING	STRING	STRING	STRING	STRING
ID	说明	MoneyMin	MoneyMax	ExpMin	ExpMax	EquipDurMin	EquipDurMax	ItemMin	ItemMax	EquipMin	EquipMax
0	普通_新手_切磋	0	0	0	0	0	0	0	0	0	0

修改后:

INT	STRING	STRING	STRING	STRING	STRING	STRING	STRING	STRING	STRING	STRING	STRING
ID	说明	MoneyMin	MoneyMax	ExpMin	ExpMax	EquipDurMin	EquipDurMax	ItemMin	ItemMax	EquipMin	EquipMax
0	普通_新手_切磋	5000	0	0	0	0	0	0	0	0	0

按第一列定位 0 号记录。第 3 列原本是 0(不扣钱),改为 5000 后按绝对值处理,最小扣 5000。只改第 3 列,保留 12 列和其余 104 行。本片段含表头与该行,不能覆盖整表。

隔离加载读回 m_nMoneyMin = 5000 且百分比标记为假。如果写 5%,源码会存成 m_nPercent_MoneyMin = 5,是另一种语义,不要混用。实际扣钱需要实测。

验证与排查

启动日志没有单独的本表日志行,判定依据是 Server::Init 返回成功且 g_pDiePenaltyManager 非空。0 号记录 MoneyMin 为 5000。把某列写成带 % 的值会切换成百分比语义,读回来的字段名也不同(m_nPercent_* 而不是 m_n*)。无法热重载,改后必须重启 Server。

与 Punish 三表的区别

Punish 三表用比例列(m_fMoneyLost 一类)直接表达扣多少;本表用「最小值/最大值」两个字符串列,并在字符串里区分百分比与绝对值。两套实现在代码里互不引用,不要把一个表的字段说明套到另一个表上。

容量

容量 1024 由 Server.cpp 的 Init(1024) 写死,第一列不能 ≥1024。

关联与依据

Server/PunishByLevel.txt · Server/PvpRuler.txt

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

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

原始 DiePenaltyManager::Init 与 GetDiePenalty 隔离加载测试(含 % 与绝对值两种写法)。死亡结算未在游戏中执行。