Lua接口/服务端/LuaFnGetAvailableItemFirstPos

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

查找指定物品在背包中的第一个可用格（排除加锁）。

Lua 调用

LuaFnGetAvailableItemFirstPos(sceneId, selfId, itemId)

服务端脚本中未检索到该接口的调用点（已检索 4397 个随包脚本）。

实现位于 LuaFnTbl_Ability.h。

参数

序号	参数 / 类型	说明
1	sceneId number	当前调用所在的场景 ID。
2	selfId number	当前场景内的对象 ID；必须是本场景线程中的有效玩家，不是角色 GUID。
3	itemId number	物品编号，必须大于 0。

返回值

返回 1 个 number：第一个可用格号；找不到或参数无效时返回 −1。

注意事项

• 实现体要求实参恰好 3 个（含 sceneId、selfId），多传或少传都直接返回失败值。
• 排除交易锁与密码锁，但不限制绑定状态；与库存统计接口的口径不同。