工程参考/配置文件/Public/EquipLevelUp.txt

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


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

EquipLevelUp.txt 是装备升级(升级生活技能对装备生效)的几率与消耗表:每十级一个段位,给出成功几率和消耗的物品编号。样本 7 条记录、3 列。

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

文件位置与生效

项目 说明
运行文件 ../Public/Config/EquipLevelUp.txt,相对于 Server 工作目录。
读取程序 Server 在 ItemTable::InitItemLevelUpTable 加载;ItemTable::GetItemLevelupTable 被 Lua 生活技能升级调用
生效方法 停服后备份并修改实际 Public 副本,再重启 Server。该加载入口不在 ReloadCombatTables 的清单里,改完必须重启 Server,热重载指令不会重读它。客户端不加载本表。
样本格式 GB18030-compatibleCRLF。保留原编码;源码读取器不会自动把中文转为 UTF-8。

第 1 列是「级别段」,读取器先用 nLevel/10*10 取整,再按本列精确匹配。所以本列必须是 10 的倍数;样本用 60、70、…、120 表示 60..69、70..79 这样的区间。

第 3 列列名写的是 Item_ID,但读取器把它存进 nCost 成员,不要因为名字里有 ID 就以为它是索引。样本 7 行全部指向 30900008。

只有 3 列,列数变动会让读取错位;样本没有校验列数,也没有校验级别段递增。

文件格式

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

字段详解

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

字段与类型 含义与修改要点 缺项或特殊值
第 1 列
INT:级别段
写入 nLevel。GetItemLevelupTable 先用 nLevel/10*10 取整成十位段,再按本列精确匹配,所以本列应当是 10 的整数倍。 样本 60..120;写成非十位段时该段取不到记录,返回空。
第 2 列
INT:几率
写入 nSuccess。 空为 0;0 在调用方可能被当成「必定失败」。
第 3 列
INT:Item_ID
列名写的是 Item_ID,但读取器把它存进 nCost。样本全是 30900008 同一个物品。 空为 0。

常用修改实例

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

把 60 级段的成功几率从 100 改成 90

修改前:

INT	INT	INT
级别段	几率	Item_ID
60	100	30900008

修改后:

INT	INT	INT
级别段	几率	Item_ID
60	90	30900008

按第一列定位 60 级段。样本第 2 列几率为 100,改为 90。只改第 2 列,保留 3 列和其余 6 行。本片段含表头与该行,不能覆盖整表。

GetItemLevelupTable(60) 与 GetItemLevelupTable(69) 都会取到这一行,nSuccess 变为 90。隔离加载读回 90。真实升级成功率需要实测。

验证与排查

启动无独立日志行(写 CacheLog 调试日志)。7 条记录、3 列,60 级段几率为 90。把第 1 列改成非十位段(如 65)会让该段查不到记录,GetItemLevelupTable 返回空。恢复备份后重启,本表不能热重载。

十位段不是精确等级

调用方先做 nLevel/10*10,所以 60 与 69 取到同一行。想做更细的分段必须同时改调用方代码,只加行没有用。

第 3 列的命名陷阱

列名 Item_ID 与实际成员 nCost 不一致,按列名理解会误判用途。

关联与依据

Public/EquipSetAttr.txt · Public/EquipExtraAttr.txt · Public/EquipVisual.txt

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

  • Server/Server/GameServer/Server/Item/ItemTable.cpp:实际加载、解析、字段使用或示例关联依据
  • Server/Server/GameServer/Server/Item/ItemTable.h:实际加载、解析、字段使用或示例关联依据
  • Common/ServerBase/FileDef.h:实际加载、解析、字段使用或示例关联依据
  • Server/Server/GameServer/Server/Script/LuaFnTbl_Ability.h:实际加载、解析、字段使用或示例关联依据
  • resources/Public/Config/EquipLevelUp.txt:实际加载、解析、字段使用或示例关联依据

原始 ItemTable::InitItemLevelUpTable 与 GetItemLevelupTable 段位取整的隔离加载测试。装备升级实际结算未在游戏中执行。