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

2026-09-07T11:16:09Z

整理当前服务端 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;">动作与技能：36 个接口，37 个调用名称。</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接口/服务端/CreateSpecialObjByDataIndex|CreateSpecialObjByDataIndex]] [[Lua接口/服务端/LuaFnCreateSpecialObjByDataIndex|LuaFnCreateSpecialObjByDataIndex]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">CreateSpecialObjByDataIndex(sceneId, selfId, nDataIndex, fPosX, fPosZ, nDelayTime)</code> 在指定位置创建特殊对象，并注册延迟激活事件。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/IsWaiGuaUser|IsWaiGuaUser]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">IsWaiGuaUser(sceneId, selfId)</code> 返回外挂防御状态；非人物对象返回 0。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnCancelMoveSpeedBuff|LuaFnCancelMoveSpeedBuff]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnCancelMoveSpeedBuff(sceneId, selfId)</code> 取消人物身上的移动速度修正效果。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnCancelSpecificImpact|LuaFnCancelSpecificImpact]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnCancelSpecificImpact(sceneId, nSelfID, nImpactDataIndex)</code> 移除角色身上指定编号的状态效果。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnCanUnitUseSkill|LuaFnCanUnitUseSkill]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnCanUnitUseSkill(sceneId, selfId, nSkillID)</code> 判断指定角色当前是否满足技能、冷却和 AI 状态三项使用条件。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnDepletingUsedItem|LuaFnDepletingUsedItem]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnDepletingUsedItem(sceneId, nSelfID)</code> 消耗本次物品使用流程中记录的道具。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnDispelAllHostileImpacts|LuaFnDispelAllHostileImpacts]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnDispelAllHostileImpacts(sceneId, selfId)</code> 清除指定角色单位身上的全部敌对效果。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnDoAction|LuaFnDoAction]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnDoAction(sceneId, selfId, nActionID, TargetID)</code> 对目标做动作
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetBagIndexOfUsedItem|LuaFnGetBagIndexOfUsedItem]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetBagIndexOfUsedItem(sceneId, selfId)</code> 读取当前物品使用流程记录的消耗物品背包格子。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetHighSectionOfTargetPetGuid|LuaFnGetHighSectionOfTargetPetGuid]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetHighSectionOfTargetPetGuid(sceneId, nSelfID)</code> 读取当前操作目标珍兽 GUID 的高段数值。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetItemIndexOfUsedItem|LuaFnGetItemIndexOfUsedItem]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetItemIndexOfUsedItem(sceneId, selfId)</code> 返回当前脚本消耗物品的物品表索引。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetLowSectionOfTargetPetGuid|LuaFnGetLowSectionOfTargetPetGuid]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetLowSectionOfTargetPetGuid(sceneId, nSelfID)</code> 读取当前操作目标珍兽 GUID 的低段数值。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPositionOfTargetObj|LuaFnGetPositionOfTargetObj]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetPositionOfTargetObj(sceneId, selfId)</code> 返回当前目标对象的 X、Z 坐标。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetScriptDynamicParamByIndex|LuaFnGetScriptDynamicParamByIndex]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetScriptDynamicParamByIndex(sceneId, nSelfID, nIndex)</code> 按索引读取角色当前脚本动态参数。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetTargetBagSlot|LuaFnGetTargetBagSlot]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetTargetBagSlot(sceneId, nSelfID)</code> 读取当前物品使用流程记录的目标背包格子。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetTargetObjID|LuaFnGetTargetObjID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetTargetObjID(sceneId, nSelfID)</code> 读取当前技能或物品使用流程记录的目标对象 ID。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetTargetPosition|LuaFnGetTargetPosition]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetTargetPosition(sceneId, selfId)</code> 返回当前技能或脚本目标位置的 X、Z 坐标。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetTargetPosition_X|LuaFnGetTargetPosition_X]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetTargetPosition_X(sceneId, nSelfID)</code> 读取当前技能或物品使用流程记录的目标 X 坐标。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetTargetPosition_Z|LuaFnGetTargetPosition_Z]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetTargetPosition_Z(sceneId, nSelfID)</code> 读取当前技能或物品使用流程记录的目标 Z 坐标。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnHaveImpactInSpecificCollection|LuaFnHaveImpactInSpecificCollection]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnHaveImpactInSpecificCollection(sceneId, selfId, collectionId)</code> 判断角色是否拥有指定效果集合中的任一效果。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnHaveImpactOfSpecificDataIndex|LuaFnHaveImpactOfSpecificDataIndex]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnHaveImpactOfSpecificDataIndex(sceneId, selfId, dataIndex)</code> 判断角色是否拥有指定数据索引的效果。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnIsCanDoScriptLogic|LuaFnIsCanDoScriptLogic]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnIsCanDoScriptLogic(sceneId, selfId)</code> 判断角色当前是否可以继续执行脚本逻辑；换场景期间返回 0。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnIsModelOrMount|LuaFnIsModelOrMount]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnIsModelOrMount(sceneId, selfId)</code> 判断人物当前是否具有模型替换或坐骑模型修正。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnIsScriptDynamicParamIndexLegal|LuaFnIsScriptDynamicParamIndexLegal]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnIsScriptDynamicParamIndexLegal(sceneId, nSelfID, nIndex)</code> 检查脚本动态参数索引是否有效。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnSendImpactAroundPosition|LuaFnSendImpactAroundPosition]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSendImpactAroundPosition(sceneId, selfId, x, z, radius, standFlag, levelRequire, effectCount, impact, delayTime)</code> 在指定位置按脚本规则筛选角色并施加 Impact。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnSendSpecificImpactBySkillToUnit|LuaFnSendSpecificImpactBySkillToUnit]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSendSpecificImpactBySkillToUnit(sceneId, selfId, senderId, targetId, impactDataIndex, delayTime)</code> 按战斗结算规则向目标施加指定效果。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnSendSpecificImpactToUnit|LuaFnSendSpecificImpactToUnit]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSendSpecificImpactToUnit(sceneId, nSelfID, nSenderID, nTargetID, nImpactDataIndex, nDelayTime)</code> 向指定目标施加指定编号的状态效果。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnSetScriptDynamicParamByIndex|LuaFnSetScriptDynamicParamByIndex]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSetScriptDynamicParamByIndex(sceneId, nSelfID, nIndex, nValue)</code> 按索引设置角色当前脚本动态参数。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnUnitDoEmoteAction|LuaFnUnitDoEmoteAction]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnUnitDoEmoteAction(sceneId, nSelfID, nSkillID, arg4)</code> 使指定角色执行表情动作。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnUnitIsEnemy|LuaFnUnitIsEnemy]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnUnitIsEnemy(sceneId, selfId, targetId)</code> 判断两个角色单位是否为敌对关系。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnUnitIsFriend|LuaFnUnitIsFriend]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnUnitIsFriend(sceneId, selfId, targetId)</code> 判断两个角色单位是否为友方关系。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnUnitIsPartner|LuaFnUnitIsPartner]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnUnitIsPartner(sceneId, selfId, targetId)</code> 判断两个角色单位是否为协作关系。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnUnitUseSkill|LuaFnUnitUseSkill]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnUnitUseSkill(sceneId, nSelfID, nSkillID, nTargetID, fPos_X, fPos_Z, fDir, bPassSkillCheck)</code> 使指定角色按目标对象、位置和朝向使用技能。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnVerifyUsedItem|LuaFnVerifyUsedItem]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnVerifyUsedItem(sceneId, nSelfID)</code> 校验玩家本次物品使用流程中记录的道具。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/MonsterDoAction|MonsterDoAction]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">MonsterDoAction(sceneId, selfId, actionId, targetId)</code> 让指定角色单位对目标执行动作。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/SetWaiGuaData|SetWaiGuaData]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">SetWaiGuaData(sceneId, selfId, nValue)</code> 将外挂防御计数写入角色设置槽 65，并标记设置存档为脏。
|}
</div>

Lua接口/服务端函数索引/动作与技能 - 版本历史

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

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