Lua接口/服务端/LuaFnEquipEnhance
来自天龙知识库
扣除强化费用,执行强化并同步物品;成功返回 0,新强化等级,
Lua 调用
LuaFnEquipEnhance(sceneId, selfId, equipBagIndex, materialBagIndex)
参数
| 序号 | 参数 / 类型 | 说明 |
|---|---|---|
| 1 | sceneIdnumber
|
当前调用所在的场景 ID。 |
| 2 | selfIdnumber
|
当前场景内的对象 ID。玩家接口需传入有效玩家对象;不是角色 GUID。 |
| 3 | equipBagIndexnumber
|
装备所在的背包格子。 |
| 4 | materialBagIndexnumber
|
材料所在的背包格子。 |
返回值
返回 1 或 2 个 number。正常操作返回 0、新强化等级,或 -6、失败后等级。-1 为表缺失或通用失败;-2 装备无效/交易锁;-3 单值为材料无效/被锁;-4 达到全表上限。金币+交子不足或金钱操作锁定时返回 -3、所需费用,不是检查接口的 -5。
注意事项
- 调用对象必须是当前场景中的有效玩家。
- 按 ItemEnhance.txt 请求优先扣交子、余款用金币,再尝试强化;成功和正常随机失败均已进入扣款后的处理。扣款返回值未被本入口检查,异常不保证整体回滚。
- 材料模板和数量由业务脚本检查。本函数不删除材料;现有脚本 809262 根据结果调用删除材料格或减少强化露次数。原材料绑定可使装备绑定。
- 失败时设置成表里的退化等级,不是减去这个数字。底层操作失败也可走 -6 分支,不能认为每个 -6 都来自正常随机失败。
- 不能绕过脚本只调用本函数完成完整强化业务,尤其不要自动重试负数结果;要同时记录两个返回值与实际钱款、材料和装备变化。
核对依据:
LuaFnTbl_Ability.h 第 3973 行,服务端注册表第 1125 行。调用格式与返回数量依据当前实现整理;游戏内效果、边界行为及未注明的业务枚举仍需实测。