Lua接口/服务端函数索引/珍兽

来自天龙知识库
雪舞​(留言 | 贡献)2026年9月19日 (六) 13:03的版本 (维护服务端 Lua 接口:核对参数、返回值、边界条件与调用示例)
跳到导航跳到搜索

首页 · 服务端接口 · 调用约定

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