Lua接口/服务端/GetHp

首页 · 服务端接口 · 角色属性与物品 · 调用约定

读取角色当前生命值。

Lua 调用

GetHp(sceneId, selfId)

服务端脚本中共出现 57 处调用，实参个数出现过：2 个（57 处）。

实现位于 LuaFnTbl_Attr.h 第 2137 行，注册表第 318 行。

参数

序号	参数 / 类型	说明
1	sceneId number	当前调用所在的场景 ID。 脚本中的实参：sceneId（57 处）
2	selfId number	当前场景内的对象 ID。玩家接口需传入有效玩家对象；不是角色 GUID。 脚本中的实参：selfId（41 处）、nNpcId（13 处）、nMonsterId（2 处）

返回值

返回当前生命值（number），不是生命上限。对象无效等失败路径返回 -1。

调用示例

local hp = GetHp(sceneId, selfId)
if hp >= 0 then
    -- hp 为有效生命值；0 也属于有效数值
end

脚本中的调用

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

-- event/fuben/efuben_bangzhan.lua
GetHp(sceneId, nNpcId)

-- event/fuben/efuben_bangzhan.lua
GetHp(sceneId, TankInfo[i].selfId)

-- event/fuben/efuben_bangzhan.lua
GetHp(sceneId, selfId)

-- event/fuben/efuben_cuju.lua
GetHp(sceneId, nMonsterId)

注意事项

• 调用对象必须是当前场景中的有效角色对象，可包括玩家、怪物或珍兽。