Lua接口/服务端/LuaFnReSetItemApt

来自天龙知识库
雪舞​(留言 | 贡献)2026年9月10日 (四) 00:26的版本 (维护服务端 Lua 接口:核对参数、返回值、边界条件与调用示例)
跳到导航跳到搜索

首页 · 服务端接口 · 生活技能与装备 · 调用约定

重置装备六项资质并返回资质等级结果。

Lua 调用

LuaFnReSetItemApt(sceneId, selfId, bagIndex)

参数

序号 参数 / 类型 说明
1 sceneId
number
当前调用所在的场景 ID。
2 selfId
number
当前场景内的对象 ID。玩家接口需传入有效玩家对象;不是角色 GUID。
3 bagIndex
number
背包格子索引。

返回值

返回一个 number。成功通常为 1;对于基础属性为正且资质点大于 0 的项,ItemAptRate.txt 对应百分比大于 17 时结果可为 2,原资质点大于 250 时优先为 3。底层重洗报告失败为 0;物品无效、非装备或通用失败为 -1。

用法补充

1 为普通成功,2 为出现高资质,3 为出现 250 以上资质。

注意事项

  • 调用对象必须是当前场景中的有效玩家。
  • 此函数实际重洗装备六项资质,不是只查询。不要为了查看百分比调用它,查询使用 GetItemApt。
  • ItemAptRate.txt 影响返回 2 的判断;返回 3 按原资质点判断。改换算表后,应复核依赖本返回值的奖励或提示脚本,不能把 1/2/3 当作具体资质点。
核对依据:LuaFnTbl_Ability.h 第 3687 行,服务端注册表第 1122 行。调用格式与返回数量依据当前实现整理;游戏内效果、边界行为及未注明的业务枚举仍需实测。