雪舞：维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

2026-09-12T05:54:23Z

维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

←上一版本		2026年9月12日 (六) 13:54的版本
第173行：		第173行：
	* [[Lua接口/时间与计时\|时间与计时]]		* [[Lua接口/时间与计时\|时间与计时]]
	* [[Lua接口/怪物相关\|怪物相关]]		* [[Lua接口/怪物相关\|怪物相关]]
			* [[Lua接口/队伍相关\|队伍相关]]
			* [[Lua接口/帮会相关\|帮会相关]]
			* [[Lua接口/消息与提示\|消息与提示]]
			* [[Lua接口/聊天与公告\|聊天与公告]]

	[[Lua接口/服务端调用约定\|服务端调用约定]] · [[Lua接口/服务端调用示例\|服务端调用示例]] · [[Lua接口/服务端函数索引\|服务端函数索引]]		[[Lua接口/服务端调用约定\|服务端调用约定]] · [[Lua接口/服务端调用示例\|服务端调用示例]] · [[Lua接口/服务端函数索引\|服务端函数索引]]

雪舞：维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

2026-09-12T05:37:39Z

维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

←上一版本		2026年9月12日 (六) 13:37的版本
第167行：		第167行：
	* [[Lua接口/珍兽查询\|珍兽查询]]		* [[Lua接口/珍兽查询\|珍兽查询]]
	* [[Lua接口/珍兽操作\|珍兽操作]]		* [[Lua接口/珍兽操作\|珍兽操作]]
			* [[Lua接口/场景查询\|场景查询]]
			* [[Lua接口/坐标与传送\|坐标与传送]]
			* [[Lua接口/副本相关\|副本相关]]
			* [[Lua接口/活动相关\|活动相关]]
			* [[Lua接口/时间与计时\|时间与计时]]
			* [[Lua接口/怪物相关\|怪物相关]]

	[[Lua接口/服务端调用约定\|服务端调用约定]] · [[Lua接口/服务端调用示例\|服务端调用示例]] · [[Lua接口/服务端函数索引\|服务端函数索引]]		[[Lua接口/服务端调用约定\|服务端调用约定]] · [[Lua接口/服务端调用示例\|服务端调用示例]] · [[Lua接口/服务端函数索引\|服务端函数索引]]

雪舞：维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

2026-09-12T05:28:44Z

维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

新页面

__NOTOC__
<div class="lua-reference" style="max-width:1200px;margin:0 auto;line-height:1.8;color:#29343a;font-family:Arial,'Microsoft YaHei',sans-serif;letter-spacing:0;overflow-wrap:anywhere;">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端调用约定|调用约定]]

查询珍兽的 GUID、等级、生命、悟性、资质、类型、名称与技能配置。多数接口用 GUID 的高低段（guidPetHigh、guidPetLow）定位宠物，而不是场景对象 ID。

== GUID 获取 ==
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 接口
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 参数与返回
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPetGUID|LuaFnGetPetGUID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, petIndex</code> → 宠物 GUID 高低段（2 个值）；无返回表示没有。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetCurrentPetGUID|LuaFnGetCurrentPetGUID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId</code> → 当前召唤宠物 GUID 高低段（2 个值）；未召唤不返回值。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPetObjIdByGUID|LuaFnGetPetObjIdByGUID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, guidPetHigh, guidPetLow</code> → 已召唤时返回场景对象 ID，否则 -1。
|}
[[Lua接口/服务端/LuaFnGetPetGUID|LuaFnGetPetGUID]] 和 [[Lua接口/服务端/LuaFnGetCurrentPetGUID|LuaFnGetCurrentPetGUID]] 都返回**两个值**（高段、低段），必须用两个变量接收。珍兽接口普遍使用这种高低段 GUID，与场景对象 ID 不同——需要对象 ID 时用 [[Lua接口/服务端/LuaFnGetPetObjIdByGUID|LuaFnGetPetObjIdByGUID]] 转换。

== 等级与经验 ==
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 接口
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 参数与返回
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPetLevelByGUID|LuaFnGetPetLevelByGUID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, guidPetHigh, guidPetLow</code> → 等级；失败 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetPet_ExpByGUID|GetPet_ExpByGUID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, guidPetHigh, guidPetLow</code> → 当前经验；宠物不存在返回 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPetNeedExp|LuaFnGetPetNeedExp]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, petLevel</code> → 该等级升级所需经验；非正等级返回 0。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetPetMaxLevelToHuman|GetPetMaxLevelToHuman]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, guidPetHigh, guidPetLow</code> → 相对主人允许的最高等级；失败 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetPetMaxLevelLimit|GetPetMaxLevelLimit]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">()</code> → 宠物等级配置表允许的最大等级（无参）。
|}
[[Lua接口/服务端/LuaFnGetPetNeedExp|LuaFnGetPetNeedExp]] 传的是**等级**（petLevel），不是 GUID。[[Lua接口/服务端/GetPetMaxLevelLimit|GetPetMaxLevelLimit]] 不接受参数。

== 生命与寿命 ==
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 接口
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 参数与返回
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPetHP|LuaFnGetPetHP]] / [[Lua接口/服务端/LuaFnGetPetMaxHP|LuaFnGetPetMaxHP]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, petGUID_H, petGUID_L</code> → 当前 / 上限生命；失败 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPetLife|LuaFnGetPetLife]] / [[Lua接口/服务端/LuaFnGetPetMaxLife|LuaFnGetPetMaxLife]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, petGUID_H, petGUID_L</code> → 当前 / 最大寿命；失败 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPetHappiness|LuaFnGetPetHappiness]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, petGUID_H, petGUID_L</code> → 快乐度；失败 -1。
|}
注意这组查询接口的参数名是 petGUID_H / petGUID_L，与设置接口的 happy 等混用需按实际顺序传入。

== 悟性与资质 ==
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 接口
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 参数与返回
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetPetSavvy|GetPetSavvy]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, guidPetHigh, guidPetLow</code> → 悟性；宠物不存在返回 0。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPetGenGuByGUID|LuaFnGetPetGenGuByGUID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, guidPetHigh, guidPetLow</code> → 根骨；失败 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetPetPerceptionLevel|GetPetPerceptionLevel]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, guidPetHigh, guidPetLow</code> → 资质档位；部分分支无返回值。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetPetTransString|GetPetTransString]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, guidPetHigh, guidPetLow</code> → 转移字符串；不存在返回空串。
|}
[[Lua接口/服务端/GetPetSavvy|GetPetSavvy]] 宠物不存在返回 0（与失败 -1 不同），不要用 0 判断「失败」。

== 类型与属性 ==
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 接口
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 参数与返回
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPetTypeByGUID|LuaFnGetPetTypeByGUID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, guidPetHigh, guidPetLow</code> → 类型（宝宝 / 变异 / 野生）；失败 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPetAITypeByGUID|LuaFnGetPetAITypeByGUID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, guidPetHigh, guidPetLow</code> → 性格类型；失败 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPetDataIDByGUID|LuaFnGetPetDataIDByGUID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, guidPetHigh, guidPetLow</code> → 模型数据编号；失败 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPetNameByGUID|LuaFnGetPetNameByGUID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, guidPetHigh, guidPetLow</code> → 名称；不存在 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPetSpouseGUIDByGUID|LuaFnGetPetSpouseGUIDByGUID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, guidPetHigh, guidPetLow</code> → 配偶 GUID 高低段（2 个值）；不存在不返回值。
|}

== 称号与数量 ==
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 接口
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 参数与返回
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPetTitleAttr|LuaFnGetPetTitleAttr]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, arg3, arg4, titleId</code> → 类别、等级、格式、说明（4 个值）。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetPetNumMax|GetPetNumMax]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId</code> → 允许携带的宠物数量上限；部分分支无返回值。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetPetNumExtra|GetPetNumExtra]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId</code> → 额外宠物栏数量；部分分支无返回值。
|}
[[Lua接口/服务端/LuaFnGetPetTitleAttr|LuaFnGetPetTitleAttr]] 返回 4 个值，需要用 4 个变量接收。

== 技能与药品配置 ==
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 接口
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 参数与返回
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetPetBookSkillID|GetPetBookSkillID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, nBookItemID</code> → 技能书物品对应的技能编号；失败 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetPetSkillLevelupTbl|GetPetSkillLevelupTbl]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, guidPetHigh, guidPetLow, nSkillIndex</code> → 升级技能、消耗物品、费用、广播标记（5 个值）。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetPetMedicineHCTbl|GetPetMedicineHCTbl]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, nMedicineHCID</code> → 合成后物品编号及费用（2 个值）；失败 -100。
|}
[[Lua接口/服务端/GetPetSkillLevelupTbl|GetPetSkillLevelupTbl]] 返回 5 个值，[[Lua接口/服务端/GetPetMedicineHCTbl|GetPetMedicineHCTbl]] 返回 2 个值，注意按顺序接收。

== 读取宠物等级 ==
<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 high, low = LuaFnGetPetGUID(sceneId, selfId, petIndex)
if type(high) == "number" and type(low) == "number" then
local level = LuaFnGetPetLevelByGUID(sceneId, selfId, high, low)
if type(level) == "number" and level ~= -1 then
-- 取得宠物等级
end
end</pre>
[[Lua接口/服务端/LuaFnGetPetGUID|LuaFnGetPetGUID]] 返回两个值（高段、低段），用两个变量接收，再传给其他按 GUID 定位的接口。

== 读取宠物悟性 ==
<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 savvy = GetPetSavvy(sceneId, selfId, guidPetHigh, guidPetLow)
if type(savvy) == "number" then
-- savvy 为悟性；宠物不存在时返回 0
end</pre>
[[Lua接口/服务端/GetPetSavvy|GetPetSavvy]] 宠物不存在返回 0，不要用 0 判断失败；失败路径需要另判。

== 相关主题 ==
* [[Lua接口/角色信息|角色信息]]
* [[Lua接口/属性读取与修改|属性读取与修改]]
* [[Lua接口/等级与经验|等级与经验]]
* [[Lua接口/货币相关|货币相关]]
* [[Lua接口/物品查询|物品查询]]
* [[Lua接口/物品发放与扣除|物品发放与扣除]]
* [[Lua接口/背包空间|背包空间]]
* [[Lua接口/装备操作|装备操作]]
* [[Lua接口/任务状态|任务状态]]
* [[Lua接口/任务变量|任务变量]]
* [[Lua接口/NPC对话|NPC 对话]]
* [[Lua接口/对话选项|对话选项]]
* [[Lua接口/技能相关|技能相关]]
* [[Lua接口/心法相关|心法相关]]
* [[Lua接口/状态效果|状态效果]]
* [[Lua接口/生活技能|生活技能]]
* [[Lua接口/珍兽查询|珍兽查询]]
* [[Lua接口/珍兽操作|珍兽操作]]

[[Lua接口/服务端调用约定|服务端调用约定]] · [[Lua接口/服务端调用示例|服务端调用示例]] · [[Lua接口/服务端函数索引|服务端函数索引]]

[[Lua接口/函数不存在|函数不存在或提示 nil]] · [[Lua接口/参数类型与顺序|参数类型与顺序]] · [[Lua接口/返回值判断|返回值判断]] · [[Lua接口/对象ID与GUID|对象 ID 与 GUID]]

<div style="margin-top:20px;padding-top:10px;border-top:1px solid #dbe3e6;color:#657078;font-size:12px;">本页函数签名与返回约定依据当前服务端注册表整理；sceneId、selfId 由实际回调提供，业务枚举、属性类型编号与运行效果需要实测。</div>

</div>

←上一版本		2026年9月12日 (六) 13:54的版本
第173行：		第173行：
	* [[Lua接口/时间与计时\|时间与计时]]		* [[Lua接口/时间与计时\|时间与计时]]
	* [[Lua接口/怪物相关\|怪物相关]]		* [[Lua接口/怪物相关\|怪物相关]]
			* [[Lua接口/队伍相关\|队伍相关]]
			* [[Lua接口/帮会相关\|帮会相关]]
			* [[Lua接口/消息与提示\|消息与提示]]
			* [[Lua接口/聊天与公告\|聊天与公告]]

	[[Lua接口/服务端调用约定\|服务端调用约定]] · [[Lua接口/服务端调用示例\|服务端调用示例]] · [[Lua接口/服务端函数索引\|服务端函数索引]]		[[Lua接口/服务端调用约定\|服务端调用约定]] · [[Lua接口/服务端调用示例\|服务端调用示例]] · [[Lua接口/服务端函数索引\|服务端函数索引]]

Lua接口/珍兽查询 - 版本历史

雪舞：​维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

雪舞：​维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

雪舞：​维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

雪舞：维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

雪舞：维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

雪舞：维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例