雪舞：整理当前服务端 Lua 接口：注册名称、参数、返回值与调用说明

2026-09-07T11:16:10Z

整理当前服务端 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接口/服务端调用约定|调用约定]]

<div style="padding:14px 0;border-top:3px solid #287568;">战场：35 个接口，35 个调用名称。</div>
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;width:36%;" | 函数 / 别名
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 调用与用途
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CheckPrisonOut|CheckPrisonOut]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">CheckPrisonOut(sceneId, selfId)</code> 检查玩家当前是否满足离开监狱的条件。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetGuildWarApply|GetGuildWarApply]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetGuildWarApply(sceneId, guildID)</code> 读取帮战申请中的申请帮会、被申请帮会和副本场景编号。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetHuashanV|GetHuashanV]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetHuashanV()</code> 返回华山论剑脚本使用的赛季偏移值。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnDeletePet|LuaFnDeletePet]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnDeletePet(sceneId, selfId, nIndex)</code> 删除对应ObjID 的玩家的宠物
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPet_AttrLevel1|LuaFnGetPet_AttrLevel1]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetPet_AttrLevel1(sceneId, selfId, nIndex, nAttr)</code> 获得对应ObjID 的玩家的宠物的基础一级战斗属性
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPet_ConPerception|LuaFnGetPet_ConPerception]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetPet_ConPerception(sceneId, selfId, nIndex)</code> 获得对应ObjID 的玩家的宠物的体力资质
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPet_DataID|LuaFnGetPet_DataID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetPet_DataID(sceneId, selfId, nIndex)</code> 获得对应ObjID 的玩家的宠物的DataID(即怪物表中的号)
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPet_DexPerception|LuaFnGetPet_DexPerception]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetPet_DexPerception(sceneId, selfId, nIndex)</code> 获得对应ObjID 的玩家的宠物的身法资质
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPet_Exp|LuaFnGetPet_Exp]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetPet_Exp(sceneId, selfId, nIndex)</code> 获得对应ObjID 的玩家的宠物的经验值
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPet_Generation|LuaFnGetPet_Generation]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetPet_Generation(sceneId, selfId, nIndex)</code> 获得对应ObjID 的玩家的宠物的代数
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPet_GenGu|LuaFnGetPet_GenGu]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetPet_GenGu(sceneId, selfId, nIndex)</code> 获得对应ObjID 的玩家的宠物的根骨
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPet_Happyness|LuaFnGetPet_Happyness]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetPet_Happyness(sceneId, selfId, nIndex)</code> 获得对应ObjID 的玩家的宠物的快乐度
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPet_HP|LuaFnGetPet_HP]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetPet_HP(sceneId, selfId, nIndex)</code> 获得对应ObjID 的玩家的宠物的HP
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPet_IntPerception|LuaFnGetPet_IntPerception]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetPet_IntPerception(sceneId, selfId, nIndex)</code> 获得对应ObjID 的玩家的宠物的定力资质
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPet_Level|LuaFnGetPet_Level]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetPet_Level(sceneId, selfId, nIndex)</code> 获得对应ObjID 的玩家的宠物的等级
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPet_Life|LuaFnGetPet_Life]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetPet_Life(sceneId, selfId, nIndex)</code> 获得对应ObjID 的玩家的宠物的寿命
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPet_MaxHP|LuaFnGetPet_MaxHP]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetPet_MaxHP(sceneId, selfId, nIndex)</code> 获得对应ObjID 的玩家的宠物的Max HP
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPet_RemainPoint|LuaFnGetPet_RemainPoint]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetPet_RemainPoint(sceneId, selfId, nIndex)</code> 获得对应ObjID 的玩家的宠物的一级属性剩余点数
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPet_Skill|LuaFnGetPet_Skill]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetPet_Skill(sceneId, selfId, nIndex, nSkillIndex)</code> 获得对应ObjID 的玩家的宠物技能
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPet_SprPerception|LuaFnGetPet_SprPerception]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetPet_SprPerception(sceneId, selfId, nIndex)</code> 获得对应ObjID 的玩家的宠物的灵气资质
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPet_StrPerception|LuaFnGetPet_StrPerception]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetPet_StrPerception(sceneId, selfId, nIndex)</code> 获得对应ObjID 的玩家的宠物的力量资质
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPet_TakeLevel|LuaFnGetPet_TakeLevel]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetPet_TakeLevel(sceneId, selfId, nIndex)</code> 获得对应ObjID 的玩家的宠物的携带等级
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPet_Type|LuaFnGetPet_Type]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetPet_Type(sceneId, selfId, nIndex)</code> 获得对应ObjID 的玩家的宠物的类型（宝宝 0，变异 1，野生 2）
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPet_ValidIndex|LuaFnGetPet_ValidIndex]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetPet_ValidIndex(sceneId, selfId, nIndex)</code> 将宠物显示序号转换为宠物容器中的有效索引。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPetCount|LuaFnGetPetCount]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetPetCount(sceneId, selfId)</code> 获得对应ObjID 的玩家的宠物数量
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPetGrowRateByGUID|LuaFnGetPetGrowRateByGUID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetPetGrowRateByGUID(sceneId, selfId, guidPetHigh, guidPetLow)</code> 查询宠物成长率档位，并同步已鉴定标志和成长率详情。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPetTransferByGUID|LuaFnGetPetTransferByGUID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetPetTransferByGUID(sceneId, selfId, guidPetHigh, guidPetLow)</code> 返回指定 GUID 宠物的序列化转移字符串。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnIsCanWashPiont|LuaFnIsCanWashPiont]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnIsCanWashPiont(sceneId, selfId, attrType)</code> 检查指定一级属性或全部一级属性是否存在可洗点数。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnIsPetGrowRateByGUID|LuaFnIsPetGrowRateByGUID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnIsPetGrowRateByGUID(sceneId, selfId, guidPetHigh, guidPetLow)</code> 返回宠物成长率是否已经鉴定。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnWashPoints|LuaFnWashPoints]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnWashPoints(sceneId, selfId)</code> 重置玩家已经分配的一级属性点。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnWashSomePoints|LuaFnWashSomePoints]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnWashSomePoints(sceneId, selfId, attrType, count)</code> 从指定一级属性中洗回一定数量的点数。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/OpenDuelDataInputWnd|OpenDuelDataInputWnd]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">OpenDuelDataInputWnd(sceneId, selfId, npcId, uiIndex)</code> 打开决斗数据输入界面，并将交互 NPC 编号传给客户端。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/PrisonGoOut|PrisonGoOut]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">PrisonGoOut(sceneId, selfId)</code> 将满足条件的玩家送出监狱。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/SetGuildWarApplySceneID|SetGuildWarApplySceneID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">SetGuildWarApplySceneID(sceneId, guildID, copySceneID)</code> 为指定帮会的帮战申请设置副本场景编号。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/TryCreatePet|TryCreatePet]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">TryCreatePet(sceneId, selfId, addNum)</code> 判断玩家是否还能增加指定数量的宠物。
|}
</div>

Lua接口/服务端函数索引/战场 - 版本历史

雪舞：​整理当前服务端 Lua 接口：注册名称、参数、返回值与调用说明

雪舞：整理当前服务端 Lua 接口：注册名称、参数、返回值与调用说明