Lua接口/服务端/LuaFnDarkUpgrade

来自天龙知识库
Waylee​(留言 | 贡献)2026年9月20日 (日) 00:10的版本 (维护服务端 Lua 接口:核对参数、返回值、边界条件与调用示例)
(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)
跳到导航跳到搜索

首页 · 服务端接口 · 暗器 · 调用约定

用修炼满 90 的梅花镖与寒冰星石锻造成品阶 +400 的新暗器,并重置该暗器的修炼与技能。

Lua 调用

LuaFnDarkUpgrade(sceneId, selfId, equipPos, stonePos)

服务端脚本中共出现 1 处调用,实参个数出现过:4 个(1 处)。

实现位于 LuaFnTbl_Dark.h。

参数

序号 参数 / 类型 说明
1 sceneId
number
当前调用所在的场景 ID。
脚本中的实参:sceneId
2 selfId
number
当前场景内的对象 ID。玩家接口需传入有效玩家对象;不是角色 GUID。
脚本中的实参:selfId
3 equipPos
number
梅花镖所在的背包格。要求该格为未加锁的暗器,且物品编号是 10155003 或 10155005。
脚本中的实参:Bind_Item1
4 stonePos
number
寒冰星石所在的背包格,不能与第 3 个参数相同。要求该格为未加锁的寒冰星石,编号是 30008069 或 30008070。
脚本中的实参:Bind_Item2

返回值

1 = 进阶成功;-1 = 物品无效、已加锁、格子参数非法或生成/写入失败;-2 = 暗器修炼等级不足;-3 = 金钱不足或金钱被锁定。

脚本中的调用

以下是服务端脚本里的真实调用点,按实参形态去重后列出 1 条。这些调用取自随包发布的脚本,可用于确认参数顺序与实际传入的值;它们不代表该写法在当前版本仍然有效。

-- event/loulangucheng/eloulan_darkup.lua
LuaFnDarkUpgrade(sceneId, selfId, Bind_Item1, Bind_Item2)

注意事项

  • 调用对象必须是当前场景中的有效玩家。
  • 要求暗器当前修炼等级不低于 90。
  • 固定消耗 2,000,000 金钱,优先扣交子;金钱被锁定时直接失败。
  • 成功后该暗器的修炼与技能会重置,品阶在原有基础上增加 400;装备投资沿用原值,绑定状态跟随原暗器。
  • 先准备好新物品数据再统一提交:中途失败会回滚,不会只扣掉寒冰星石或只扣掉金钱。