Lua接口/服务端/LuaFnEquipEnhance

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

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

扣除强化费用,执行强化并同步物品;成功返回 0,新强化等级,

Lua 调用

LuaFnEquipEnhance(sceneId, selfId, equipBagIndex, materialBagIndex)

参数

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

返回值

返回 1 或 2 个 number。正常操作返回 0、新强化等级,或 -6、失败后等级。-1 为表缺失或通用失败;-2 装备无效/交易锁;-3 单值为材料无效/被锁;-4 达到全表上限。金币+交子不足或金钱操作锁定时返回 -3、所需费用,不是检查接口的 -5。

注意事项

  • 调用对象必须是当前场景中的有效玩家。
  • 按 ItemEnhance.txt 请求优先扣交子、余款用金币,再尝试强化;成功和正常随机失败均已进入扣款后的处理。扣款返回值未被本入口检查,异常不保证整体回滚。
  • 材料模板和数量由业务脚本检查。本函数不删除材料;现有脚本 809262 根据结果调用删除材料格或减少强化露次数。原材料绑定可使装备绑定。
  • 失败时设置成表里的退化等级,不是减去这个数字。底层操作失败也可走 -6 分支,不能认为每个 -6 都来自正常随机失败。
  • 不能绕过脚本只调用本函数完成完整强化业务,尤其不要自动重试负数结果;要同时记录两个返回值与实际钱款、材料和装备变化。
核对依据:LuaFnTbl_Ability.h 第 3973 行,服务端注册表第 1125 行。调用格式与返回数量依据当前实现整理;游戏内效果、边界行为及未注明的业务枚举仍需实测。