Lua接口/服务端/GetBagItemLevel：修订间差异
来自天龙知识库
跳到导航跳到搜索
整理当前服务端 Lua 接口：注册名称、参数、返回值与调用说明 |
维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例 |
||
| 第3行： | 第3行： | ||
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/生活技能与装备|生活技能与装备]] · [[Lua接口/服务端调用约定|调用约定]] | [[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/生活技能与装备|生活技能与装备]] · [[Lua接口/服务端调用约定|调用约定]] | ||
<div style="padding:14px 0;border-top:3px solid #287568;border-bottom:1px solid #dbe3e6;"> | <div style="padding:14px 0;border-top:3px solid #287568;border-bottom:1px solid #dbe3e6;">读取背包装备的需求等级；暗器取装备需求等级与暗器等级的较大值。</div> | ||
== Lua 调用 == | == Lua 调用 == | ||
| 第24行： | 第24行： | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 3 | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 3 | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">BagIndex</code><br /><span style="color:#657078;"><code style="white-space:normal;overflow-wrap:anywhere;">number</code></span> | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">BagIndex</code><br /><span style="color:#657078;"><code style="white-space:normal;overflow-wrap:anywhere;">number</code></span> | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 待查询装备所在的背包格号，不是物品模板编号、装备栏槽号或物品 GUID。 | ||
|} | |} | ||
== 返回值 == | == 返回值 == | ||
返回一个 number。有效装备通常返回装备表的需求等级；暗器返回需求等级与暗器等级的较大值。物品不存在或为空及通用失败返回 -1；非装备或查不到装备模板时返回初始哨兵 255，不能把 255 当作正常等级。 | |||
== 调用示例 == | |||
<pre style="white-space:pre-wrap;overflow-wrap:anywhere;font-size:13px;line-height:1.7;padding:12px;background:#f5f7f8;border:1px solid #dbe3e6;">local level = GetBagItemLevel(sceneId, selfId, equipBagPos) | |||
if level < 0 or level == 255 then | |||
return | |||
end | |||
-- level 是本次查询得到的装备需求等级</pre> | |||
== 注意事项 == | == 注意事项 == | ||
* 调用对象必须是当前场景中的有效玩家。 | * 调用对象必须是当前场景中的有效玩家。 | ||
* 此值不是角色等级，也不是强化等级或已镶宝石数量。打孔费用索引见 [[工程参考/配置文件/Public/SlotCost.txt|SlotCost.txt]]。 | |||
* 需求等级保存在 BYTE 值中，异常超范围配置不能据此得到可靠等级。客户端当前打孔预览只取装备表需求等级，暗器等级更高时，两端可能使用不同费用行；同表同步不能修复这一代码差异。 | |||
<div style="margin-top:20px;padding-top:10px;border-top:1px solid #dbe3e6;color:#657078;font-size:12px;">核对依据：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnTbl_Ability.h</code> 第 473 行，服务端注册表第 400 行。调用格式与返回数量依据当前实现整理；游戏内效果、边界行为及未注明的业务枚举仍需实测。</div> | <div style="margin-top:20px;padding-top:10px;border-top:1px solid #dbe3e6;color:#657078;font-size:12px;">核对依据：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnTbl_Ability.h</code> 第 473 行，服务端注册表第 400 行。调用格式与返回数量依据当前实现整理；游戏内效果、边界行为及未注明的业务枚举仍需实测。</div> | ||
</div> | </div> | ||
2026年9月9日 (三) 23:34的最新版本
读取背包装备的需求等级；暗器取装备需求等级与暗器等级的较大值。
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 行。调用格式与返回数量依据当前实现整理；游戏内效果、边界行为及未注明的业务枚举仍需实测。