查看“︁Lua接口/服务端函数索引/珍兽”︁的源代码

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead">珍兽：65 个接口，65 个调用名称，其中 59 个在当前脚本中有调用。</div>
{| class="wikitable"
! scope="col" class="lua-w36" | 函数 / 别名
! scope="col" | 调用与用途
|-
| [[Lua接口/服务端/Audit_PetImproveWuxing|Audit_PetImproveWuxing]]
| <code>Audit_PetImproveWuxing(sceneId, selfId, guidPetHigh, guidPetLow, bSuccess, nNewValue)</code><br />记录脚本触发的宠物悟性提升审计日志。<br /><span class="lua-muted">脚本中 2 处调用</span>
|-
| [[Lua接口/服务端/CalcPetDomesticationMoney|CalcPetDomesticationMoney]]
| <code>CalcPetDomesticationMoney(sceneId, humanId, petGUID_H, petGUID_L)</code><br />得到训养宠物所需费用<br /><span class="lua-warn">脚本中未见调用</span>
|-
| [[Lua接口/服务端/GetCostOfGenGuBySavvy|GetCostOfGenGuBySavvy]]
| <code>GetCostOfGenGuBySavvy(sceneId, selfId, nSavvy)</code><br />返回按悟性提升根骨所需费用。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/GetLeveldownOfCompoundBySavvy|GetLeveldownOfCompoundBySavvy]]
| <code>GetLeveldownOfCompoundBySavvy(sceneId, selfId, nSavvy)</code><br />返回宠物融合后按悟性扣减的等级。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/GetPet_ExpByGUID|GetPet_ExpByGUID]]
| <code>GetPet_ExpByGUID(sceneId, selfId, guidPetHigh, guidPetLow)</code><br />返回指定宠物当前经验，宠物不存在时返回 -1。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/GetPetBookSkillID|GetPetBookSkillID]]
| <code>GetPetBookSkillID(sceneId, nBookItemID)</code><br />根据宠物技能书物品编号返回对应技能编号。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/GetPetMaxLevelLimit|GetPetMaxLevelLimit]]
| <code>GetPetMaxLevelLimit()</code><br />返回宠物等级配置表允许的最大等级。<br /><span class="lua-warn">脚本中未见调用</span>
|-
| [[Lua接口/服务端/GetPetMaxLevelToHuman|GetPetMaxLevelToHuman]]
| <code>GetPetMaxLevelToHuman(sceneId, selfId, guidPetHigh, guidPetLow)</code><br />返回宠物相对主人当前允许达到的最高等级。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/GetPetMedicineHCTbl|GetPetMedicineHCTbl]]
| <code>GetPetMedicineHCTbl(sceneId, nMedicineHCID)</code><br />返回宠物药品合成后的物品编号及所需费用。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/GetPetNumExtra|GetPetNumExtra]]
| <code>GetPetNumExtra(sceneId, selfId)</code><br />返回玩家额外增加的宠物栏数量。<br /><span class="lua-muted">脚本中 2 处调用</span>
|-
| [[Lua接口/服务端/GetPetNumMax|GetPetNumMax]]
| <code>GetPetNumMax(sceneId, selfId)</code><br />返回玩家当前允许携带的宠物数量上限。<br /><span class="lua-muted">脚本中 4 处调用</span>
|-
| [[Lua接口/服务端/GetPetPerceptionLevel|GetPetPerceptionLevel]]
| <code>GetPetPerceptionLevel(sceneId, selfId, guidPetHigh, guidPetLow)</code><br />返回宠物资质档位。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/GetPetSavvy|GetPetSavvy]]
| <code>GetPetSavvy(sceneId, selfId, guidPetHigh, guidPetLow)</code><br />返回宠物悟性；宠物不存在时返回 0。<br /><span class="lua-muted">脚本中 4 处调用</span>
|-
| [[Lua接口/服务端/GetPetSkillLevelupTbl|GetPetSkillLevelupTbl]]
| <code>GetPetSkillLevelupTbl(sceneId, selfId, guidPetHigh, guidPetLow, nSkillIndex)</code><br />返回指定宠物技能的升级技能、消耗物品、费用和广播标记。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/GetPetTransString|GetPetTransString]]
| <code>GetPetTransString(sceneId, selfId, guidPetHigh, guidPetLow)</code><br />返回宠物转移字符串；宠物不存在时返回空字符串。<br /><span class="lua-muted">脚本中 11 处调用</span>
|-
| [[Lua接口/服务端/GetSuccrateOfGenGuBySavvy|GetSuccrateOfGenGuBySavvy]]
| <code>GetSuccrateOfGenGuBySavvy(sceneId, selfId, nSavvy)</code><br />返回按悟性提升根骨的成功率。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/IncreaceSavvyByCompound|IncreaceSavvyByCompound]]
| <code>IncreaceSavvyByCompound(sceneId, selfId, destPetHigh, destPetLow, assistantPetHigh, assistantPetLow)</code><br />使用副宠提升目标宠物悟性，并返回本次悟性变化值。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/LuaFnCallPetCompoundUI|LuaFnCallPetCompoundUI]]
| <code>LuaFnCallPetCompoundUI(sceneId, selfId, targetId, nUIIndex)</code><br />打开宠物融合界面，并将目标 NPC 编号作为首个整型参数发送。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/LuaFnCallPetProcreateRegisterUI|LuaFnCallPetProcreateRegisterUI]]
| <code>LuaFnCallPetProcreateRegisterUI(sceneId, selfId, targetId, nUIIndex)</code><br />初始化双方宠物繁殖登记状态，并同时打开登记界面。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/LuaFnCheckCallPetProcreateRegisterUI|LuaFnCheckCallPetProcreateRegisterUI]]
| <code>LuaFnCheckCallPetProcreateRegisterUI(sceneId, selfId, targetId)</code><br />检查两人组队、队长、距离及登记 NPC 是否满足宠物繁殖登记条件。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/LuaFnCheckPetProcreateTakeOut|LuaFnCheckPetProcreateTakeOut]]
| <code>LuaFnCheckPetProcreateTakeOut(sceneId, selfId)</code><br />检查两名队员是否满足领取宠物繁殖结果的条件。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/LuaFnCheckPetShelizi|LuaFnCheckPetShelizi]]
| <code>LuaFnCheckPetShelizi(sceneId, selfId, guidPetHigh, guidPetLow)</code><br />校验指定宠物是否允许使用宠物舍利子。<br /><span class="lua-muted">脚本中 2 处调用</span>
|-
| [[Lua接口/服务端/LuaFnCheckResetPetAttrPt|LuaFnCheckResetPetAttrPt]]
| <code>LuaFnCheckResetPetAttrPt(sceneId, selfId, guidPetHigh, guidPetLow)</code><br />检查指定宠物是否允许重置一级属性点。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/LuaFnCreatePetToHuman|LuaFnCreatePetToHuman]]
| <code>LuaFnCreatePetToHuman(sceneId, selfId, nPetDataID, nPetLevel, nRuler)</code><br />按宠物生成规则向玩家宠物栏创建宠物。<br /><span class="lua-muted">脚本中 9 处调用</span>
|-
| [[Lua接口/服务端/LuaFnDeletePetByGUID|LuaFnDeletePetByGUID]]
| <code>LuaFnDeletePetByGUID(sceneId, selfId, guidPetHigh, guidPetLow)</code><br />按 GUID 删除宠物，并保存删除前完整档案到宠物日志。<br /><span class="lua-muted">脚本中 2 处调用</span>
|-
| [[Lua接口/服务端/LuaFnGetCurrentPetGUID|LuaFnGetCurrentPetGUID]]
| <code>LuaFnGetCurrentPetGUID(sceneId, selfId)</code><br />返回当前召唤宠物的 GUID 高低段；没有召唤宠物时不返回值。<br /><span class="lua-muted">脚本中 5 处调用</span>
|-
| [[Lua接口/服务端/LuaFnGetPetAITypeByGUID|LuaFnGetPetAITypeByGUID]]
| <code>LuaFnGetPetAITypeByGUID(sceneId, selfId, guidPetHigh, guidPetLow)</code><br />返回指定宠物的性格类型。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/LuaFnGetPetDataIDByGUID|LuaFnGetPetDataIDByGUID]]
| <code>LuaFnGetPetDataIDByGUID(sceneId, selfId, guidPetHigh, guidPetLow)</code><br />返回指定宠物的模型数据编号。<br /><span class="lua-muted">脚本中 5 处调用</span>
|-
| [[Lua接口/服务端/LuaFnGetPetGenGuByGUID|LuaFnGetPetGenGuByGUID]]
| <code>LuaFnGetPetGenGuByGUID(sceneId, selfId, guidPetHigh, guidPetLow)</code><br />返回指定宠物的根骨值。<br /><span class="lua-muted">脚本中 2 处调用</span>
|-
| [[Lua接口/服务端/LuaFnGetPetGUID|LuaFnGetPetGUID]]
| <code>LuaFnGetPetGUID(sceneId, selfId, petIndex)</code><br />取得宠物的GUID<br /><span class="lua-muted">脚本中 2 处调用</span>
|-
| [[Lua接口/服务端/LuaFnGetPetHappiness|LuaFnGetPetHappiness]]
| <code>LuaFnGetPetHappiness(sceneId, selfId, petGUID_H, petGUID_L)</code><br />设置宠物快乐度<br /><span class="lua-muted">脚本中 5 处调用</span>
|-
| [[Lua接口/服务端/LuaFnGetPetHP|LuaFnGetPetHP]]
| <code>LuaFnGetPetHP(sceneId, selfId, petGUID_H, petGUID_L)</code><br />设置宠物HP<br /><span class="lua-muted">脚本中 4 处调用</span>
|-
| [[Lua接口/服务端/LuaFnGetPetHuanTongCost|LuaFnGetPetHuanTongCost]]
| <code>LuaFnGetPetHuanTongCost(sceneId, takeLevel)</code><br />返回指定携带等级宠物的还童费用。<br /><span class="lua-muted">脚本中 2 处调用</span>
|-
| [[Lua接口/服务端/LuaFnGetPetLevelByGUID|LuaFnGetPetLevelByGUID]]
| <code>LuaFnGetPetLevelByGUID(sceneId, selfId, guidPetHigh, guidPetLow)</code><br />返回指定宠物的等级。<br /><span class="lua-muted">脚本中 6 处调用</span>
|-
| [[Lua接口/服务端/LuaFnGetPetLife|LuaFnGetPetLife]]
| <code>LuaFnGetPetLife(sceneId, selfId, petGUID_H, petGUID_L)</code><br />设置宠物寿命<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/LuaFnGetPetMaxHP|LuaFnGetPetMaxHP]]
| <code>LuaFnGetPetMaxHP(sceneId, selfId, petGUID_H, petGUID_L)</code><br />设置宠物HP最大值<br /><span class="lua-muted">脚本中 5 处调用</span>
|-
| [[Lua接口/服务端/LuaFnGetPetMaxLife|LuaFnGetPetMaxLife]]
| <code>LuaFnGetPetMaxLife(sceneId, selfId, guidPetHigh, guidPetLow)</code><br />返回指定宠物种类配置的最大寿命。<br /><span class="lua-muted">脚本中 3 处调用</span>
|-
| [[Lua接口/服务端/LuaFnGetPetNameByGUID|LuaFnGetPetNameByGUID]]
| <code>LuaFnGetPetNameByGUID(sceneId, selfId, guidPetHigh, guidPetLow)</code><br />返回指定宠物名称，宠物不存在时返回 -1。<br /><span class="lua-warn">脚本中未见调用</span>
|-
| [[Lua接口/服务端/LuaFnGetPetNeedExp|LuaFnGetPetNeedExp]]
| <code>LuaFnGetPetNeedExp(sceneId, selfId, petLevel)</code><br />返回宠物从指定等级升级所需经验，非正等级返回 0。<br /><span class="lua-muted">脚本中 3 处调用</span>
|-
| [[Lua接口/服务端/LuaFnGetPetObjIdByGUID|LuaFnGetPetObjIdByGUID]]
| <code>LuaFnGetPetObjIdByGUID(sceneId, selfId, guidPetHigh, guidPetLow)</code><br />指定 GUID 的宠物当前已召唤时返回场景对象编号，否则返回 -1。<br /><span class="lua-muted">脚本中 3 处调用</span>
|-
| [[Lua接口/服务端/LuaFnGetPetProcreateInfo|LuaFnGetPetProcreateInfo]]
| <code>LuaFnGetPetProcreateInfo(sceneId, selfId)</code><br />向世界服查询当前玩家的宠物繁殖记录。<br /><span class="lua-muted">脚本中 2 处调用</span>
|-
| [[Lua接口/服务端/LuaFnGetPetSpouseGUIDByGUID|LuaFnGetPetSpouseGUIDByGUID]]
| <code>LuaFnGetPetSpouseGUIDByGUID(sceneId, selfId, guidPetHigh, guidPetLow)</code><br />返回指定宠物配偶 GUID 的高低段；宠物不存在时不返回值。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/LuaFnGetPetTitleAttr|LuaFnGetPetTitleAttr]]
| <code>LuaFnGetPetTitleAttr(sceneId, selfId, arg3, arg4, titleId)</code><br />返回宠物称号的类别、等级、格式和说明。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/LuaFnGetPetTypeByGUID|LuaFnGetPetTypeByGUID]]
| <code>LuaFnGetPetTypeByGUID(sceneId, selfId, guidPetHigh, guidPetLow)</code><br />返回指定宠物的类型（宝宝、变异或野生）。<br /><span class="lua-muted">脚本中 2 处调用</span>
|-
| [[Lua接口/服务端/LuaFnIsPetLockedByGUID|LuaFnIsPetLockedByGUID]]
| <code>LuaFnIsPetLockedByGUID(sceneId, selfId, guidPetHigh, guidPetLow)</code><br />返回指定宠物当前是否被运行时交易锁锁定。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/LuaFnIsPetPWLockedByGUID|LuaFnIsPetPWLockedByGUID]]
| <code>LuaFnIsPetPWLockedByGUID(sceneId, selfId, guidPetHigh, guidPetLow)</code><br />返回宠物是否受二级密码保护；宠物不存在时不返回 Lua 值。<br /><span class="lua-warn">脚本中未见调用</span>
|-
| [[Lua接口/服务端/LuaFnPetCanReturnToChild|LuaFnPetCanReturnToChild]]
| <code>LuaFnPetCanReturnToChild(sceneId, selfId, petGUID_H, petGUID_L, nRuler, nSpecifyPetDataID)</code><br />宠物还童Lua接口<br /><span class="lua-muted">脚本中 4 处调用</span>
|-
| [[Lua接口/服务端/LuaFnPetCanUseFood|LuaFnPetCanUseFood]]
| <code>LuaFnPetCanUseFood(sceneId, selfId, petGUID_H, petGUID_L, nIndex)</code><br />判断物品是否适合宠物食用<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/LuaFnPetProcreateTakeOut|LuaFnPetProcreateTakeOut]]
| <code>LuaFnPetProcreateTakeOut(sceneId, selfId)</code><br />领取两名队员已经完成的宠物繁殖结果。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/LuaFnPetReturnToChild|LuaFnPetReturnToChild]]
| <code>LuaFnPetReturnToChild(sceneId, selfId, petGUID_H, petGUID_L, nRuler, nSpecifyPetDataID)</code><br />宠物还童Lua接口<br /><span class="lua-muted">脚本中 4 处调用</span>
|-
| [[Lua接口/服务端/LuaFnPetSkillUp|LuaFnPetSkillUp]]
| <code>LuaFnPetSkillUp(sceneId, selfId, guidPetHigh, guidPetLow, nSkillIndex, nSkillID)</code><br />将指定宠物技能替换为升级后的技能并发送技能位刷新。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/LuaFnResetPetAttrPt|LuaFnResetPetAttrPt]]
| <code>LuaFnResetPetAttrPt(sceneId, selfId, guidPetHigh, guidPetLow)</code><br />重置指定宠物的一级属性点并刷新宠物详情。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/LuaFnSetPetAITypeByGUID|LuaFnSetPetAITypeByGUID]]
| <code>LuaFnSetPetAITypeByGUID(sceneId, selfId, guidPetHigh, guidPetLow, nAIType)</code><br />设置指定宠物的 AI 性格并刷新宠物详情。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/LuaFnSetPetHappiness|LuaFnSetPetHappiness]]
| <code>LuaFnSetPetHappiness(sceneId, selfId, petGUID_H, petGUID_L, happiness)</code><br />设置宠物快乐度<br /><span class="lua-muted">脚本中 2 处调用</span>
|-
| [[Lua接口/服务端/LuaFnSetPetHP|LuaFnSetPetHP]]
| <code>LuaFnSetPetHP(sceneId, selfId, petGUID_H, petGUID_L, hp)</code><br />设置宠物HP<br /><span class="lua-muted">脚本中 2 处调用</span>
|-
| [[Lua接口/服务端/LuaFnSetPetLife|LuaFnSetPetLife]]
| <code>LuaFnSetPetLife(sceneId, selfId, petGUID_H, petGUID_L, life)</code><br />设置宠物寿命值<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/LuaFnSetPetMaxHP|LuaFnSetPetMaxHP]]
| <code>LuaFnSetPetMaxHP(sceneId, selfId, arg3, arg4, arg5)</code><br />设置宠物HP最大值<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/LuaFnSetPetTitle|LuaFnSetPetTitle]]
| <code>LuaFnSetPetTitle(sceneId, selfId, guidPetHigh, guidPetLow, tTitleID)</code><br />添加并切换宠物称号。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/PetAddExp|PetAddExp]]
| <code>PetAddExp(sceneId, selfId, nExp)</code><br />为当前出战宠物增加经验。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/PetDomestication|PetDomestication]]
| <code>PetDomestication(sceneId, selfId, guidPetHigh, guidPetLow)</code><br />训养宠物<br /><span class="lua-warn">脚本中未见调用</span>
|-
| [[Lua接口/服务端/PetStudySkill|PetStudySkill]]
| <code>PetStudySkill(sceneId, selfId, guidPetHigh, guidPetLow, skillId)</code><br />宠物学习技能<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/PetStudySkill_MenPai|PetStudySkill_MenPai]]
| <code>PetStudySkill_MenPai(sceneId, selfId, arg3, arg4, arg5)</code><br />宠物学习门派技能<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/RecallPet|RecallPet]]
| <code>RecallPet(sceneId, selfId)</code><br />收回玩家当前召唤的宠物。<br /><span class="lua-warn">脚本中未见调用</span>
|-
| [[Lua接口/服务端/SetPetNumExtra|SetPetNumExtra]]
| <code>SetPetNumExtra(sceneId, selfId, yValue)</code><br />设置玩家额外宠物栏数量，允许范围为零至四。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/SetPetSavvy|SetPetSavvy]]
| <code>SetPetSavvy(sceneId, selfId, guidPetHigh, guidPetLow, nSavvyNew)</code><br />设置宠物悟性、写宠物日志并刷新详情。<br /><span class="lua-muted">脚本中 2 处调用</span>
|}
</div>