Lua接口/服务端/GetBagItemLevel
来自天龙知识库
读取背包装备的需求等级；暗器取装备需求等级与暗器等级的较大值。
Lua 调用
GetBagItemLevel(sceneId, selfId, BagIndex)
参数
| 序号 | 参数 / 类型 | 说明 |
|---|---|---|
| 1 | sceneIdnumber
|
当前调用所在的场景 ID。 |
| 2 | selfIdnumber
|
当前场景内的对象 ID。玩家接口需传入有效玩家对象；不是角色 GUID。 |
| 3 | BagIndexnumber
|
待查询装备所在的背包格号，不是物品模板编号、装备栏槽号或物品 GUID。 |
返回值
返回一个 number。有效装备通常返回装备表的需求等级；暗器返回需求等级与暗器等级的较大值。物品不存在或为空及通用失败返回 -1；非装备或查不到装备模板时返回初始哨兵 255，不能把 255 当作正常等级。
调用示例
local level = GetBagItemLevel(sceneId, selfId, equipBagPos)
if level < 0 or level == 255 then
return
end
-- level 是本次查询得到的装备需求等级
注意事项
- 调用对象必须是当前场景中的有效玩家。
- 此值不是角色等级，也不是强化等级或已镶宝石数量。打孔费用索引见 SlotCost.txt。
- 需求等级保存在 BYTE 值中，异常超范围配置不能据此得到可靠等级。客户端当前打孔预览只取装备表需求等级，暗器等级更高时，两端可能使用不同费用行；同表同步不能修复这一代码差异。
核对依据：
LuaFnTbl_Ability.h 第 473 行，服务端注册表第 400 行。调用格式与返回数量依据当前实现整理；游戏内效果、边界行为及未注明的业务枚举仍需实测。