Lua接口/服务端函数索引/场景与副本：修订间差异

来自天龙知识库
跳到导航跳到搜索

Waylee​（留言 | 贡献）

3个用户组
5,114次编辑
雪舞​（留言 | 贡献）
7,476次编辑
整理当前服务端 Lua 接口：注册名称、参数、返回值与调用说明
 
Waylee​（留言 | 贡献）
行政员、​界面管理员、​管理员
5,114次编辑
维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例
 
（未显示另一用户的1个中间版本）
第1行： 第1行：
__NOTOC__
__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;">
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端调用约定|调用约定]]
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端调用约定|调用约定]]


<div style="padding:14px 0;border-top:3px solid #287568;">场景与副本：44 个接口，44 个调用名称。</div>
<div class="lua-lead">场景与副本：44 个接口，44 个调用名称，其中 32 个在当前脚本中有调用。</div>
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
{| class="wikitable"
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;width:36%;" | 函数 / 别名
! scope="col" class="lua-w36" | 函数 / 别名
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 调用与用途
! scope="col" | 调用与用途
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/FindCopySceneIDByCopySceneParams|FindCopySceneIDByCopySceneParams]]
| [[Lua接口/服务端/FindCopySceneIDByCopySceneParams|FindCopySceneIDByCopySceneParams]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">FindCopySceneIDByCopySceneParams(sceneId, copySceneType, checkParamNum, ...)</code><br />按指定的副本参数查找正在运行的副本场景。
| <code>FindCopySceneIDByCopySceneParams(sceneId, copySceneType, checkParamNum, ...)</code><br />按指定的副本参数查找正在运行的副本场景。<br /><span class="lua-muted">脚本中 4 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetMonsterCount|GetMonsterCount]]
| [[Lua接口/服务端/GetMonsterCount|GetMonsterCount]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetMonsterCount(sceneId)</code><br />取得此场景中的怪物数量
| <code>GetMonsterCount(sceneId)</code><br />取得此场景中的怪物数量<br /><span class="lua-muted">脚本中 164 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetMonsterObjID|GetMonsterObjID]]
| [[Lua接口/服务端/GetMonsterObjID|GetMonsterObjID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetMonsterObjID(sceneId, nIndex)</code><br />根据索引号取得怪物的ObjID
| <code>GetMonsterObjID(sceneId, nIndex)</code><br />根据索引号取得怪物的ObjID<br /><span class="lua-muted">脚本中 166 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/IsCanEnterCopyScene|IsCanEnterCopyScene]]
| [[Lua接口/服务端/IsCanEnterCopyScene|IsCanEnterCopyScene]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">IsCanEnterCopyScene(sceneId, guid)</code><br />判断玩家是否可以进入场景sceneId,
| <code>IsCanEnterCopyScene(sceneId, guid)</code><br />判断玩家是否可以进入场景sceneId,<br /><span class="lua-muted">脚本中 22 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LoadMonsterIni|LoadMonsterIni]]
| [[Lua接口/服务端/LoadMonsterIni|LoadMonsterIni]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LoadMonsterIni(sceneId, monsterIni)</code><br />在指定场景执行怪物分布文件。
| <code>LoadMonsterIni(sceneId, monsterIni)</code><br />在指定场景执行怪物分布文件。<br /><span class="lua-warn">脚本中未见调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnAskNpcScriptMail|LuaFnAskNpcScriptMail]]
| [[Lua接口/服务端/LuaFnAskNpcScriptMail|LuaFnAskNpcScriptMail]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnAskNpcScriptMail(sceneId, selfId, scriptType)</code><br />请求世界服务器下发 NPC 脚本邮件。
| <code>LuaFnAskNpcScriptMail(sceneId, selfId, scriptType)</code><br />请求世界服务器下发 NPC 脚本邮件。<br /><span class="lua-muted">脚本中 3 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnCreateCopyScene|LuaFnCreateCopyScene]]
| [[Lua接口/服务端/LuaFnCreateCopyScene|LuaFnCreateCopyScene]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnCreateCopyScene(sceneId)</code><br />根据当前场景已设置的副本创建参数，创建或选择副本场景。
| <code>LuaFnCreateCopyScene(sceneId)</code><br />根据当前场景已设置的副本创建参数，创建或选择副本场景。<br /><span class="lua-muted">脚本中 81 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetCopyScene_HumanCount|LuaFnGetCopyScene_HumanCount]]
| [[Lua接口/服务端/LuaFnGetCopyScene_HumanCount|LuaFnGetCopyScene_HumanCount]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetCopyScene_HumanCount(sceneId)</code><br />返回当前场景里面的玩家数量
| <code>LuaFnGetCopyScene_HumanCount(sceneId)</code><br />返回当前场景里面的玩家数量<br /><span class="lua-muted">脚本中 286 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetCopyScene_HumanObjId|LuaFnGetCopyScene_HumanObjId]]
| [[Lua接口/服务端/LuaFnGetCopyScene_HumanObjId|LuaFnGetCopyScene_HumanObjId]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetCopyScene_HumanObjId(sceneId, uIndex)</code><br />读取场景参数信息
| <code>LuaFnGetCopyScene_HumanObjId(sceneId, uIndex)</code><br />读取场景参数信息<br /><span class="lua-muted">脚本中 336 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetCopySceneData_NoUserCloseTime|LuaFnGetCopySceneData_NoUserCloseTime]]
| [[Lua接口/服务端/LuaFnGetCopySceneData_NoUserCloseTime|LuaFnGetCopySceneData_NoUserCloseTime]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetCopySceneData_NoUserCloseTime(sceneId)</code><br />返回没有人后副本场景自动关闭清除的时间（毫秒）。
| <code>LuaFnGetCopySceneData_NoUserCloseTime(sceneId)</code><br />返回没有人后副本场景自动关闭清除的时间（毫秒）。<br /><span class="lua-warn">脚本中未见调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetCopySceneData_Param|LuaFnGetCopySceneData_Param]]
| [[Lua接口/服务端/LuaFnGetCopySceneData_Param|LuaFnGetCopySceneData_Param]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetCopySceneData_Param(sceneId, uIndex)</code><br />读取场景参数信息
| <code>LuaFnGetCopySceneData_Param(sceneId, uIndex)</code><br />读取场景参数信息<br /><span class="lua-muted">脚本中 1161 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetCopySceneData_TeamLeader|LuaFnGetCopySceneData_TeamLeader]]
| [[Lua接口/服务端/LuaFnGetCopySceneData_TeamLeader|LuaFnGetCopySceneData_TeamLeader]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetCopySceneData_TeamLeader(sceneId)</code><br />返回副本创建数据里的队长GUID，失败－1
| <code>LuaFnGetCopySceneData_TeamLeader(sceneId)</code><br />返回副本创建数据里的队长GUID，失败－1<br /><span class="lua-muted">脚本中 102 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetCopySceneData_Timer|LuaFnGetCopySceneData_Timer]]
| [[Lua接口/服务端/LuaFnGetCopySceneData_Timer|LuaFnGetCopySceneData_Timer]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetCopySceneData_Timer(sceneId)</code><br />读取场景定时器的时间间隔，如果为0表示没有设置。
| <code>LuaFnGetCopySceneData_Timer(sceneId)</code><br />读取场景定时器的时间间隔，如果为0表示没有设置。<br /><span class="lua-warn">脚本中未见调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetCopySceneIDByTeamLeaderGUID|LuaFnGetCopySceneIDByTeamLeaderGUID]]
| [[Lua接口/服务端/LuaFnGetCopySceneIDByTeamLeaderGUID|LuaFnGetCopySceneIDByTeamLeaderGUID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetCopySceneIDByTeamLeaderGUID(sceneId, teamLeaderGUID, copySceneType)</code><br />按队长和副本类型查找正在运行的副本场景。
| <code>LuaFnGetCopySceneIDByTeamLeaderGUID(sceneId, teamLeaderGUID, copySceneType)</code><br />按队长和副本类型查找正在运行的副本场景。<br /><span class="lua-warn">脚本中未见调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetSceneAttr_CanCreateRascalKiller|LuaFnGetSceneAttr_CanCreateRascalKiller]]
| [[Lua接口/服务端/LuaFnGetSceneAttr_CanCreateRascalKiller|LuaFnGetSceneAttr_CanCreateRascalKiller]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetSceneAttr_CanCreateRascalKiller(sceneId)</code><br />返回场景是否允许创建惩罚恶人 NPC，缺少配置时返回 0。
| <code>LuaFnGetSceneAttr_CanCreateRascalKiller(sceneId)</code><br />返回场景是否允许创建惩罚恶人 NPC，缺少配置时返回 0。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetSceneAttr_RandomMonsterDataID|LuaFnGetSceneAttr_RandomMonsterDataID]]
| [[Lua接口/服务端/LuaFnGetSceneAttr_RandomMonsterDataID|LuaFnGetSceneAttr_RandomMonsterDataID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetSceneAttr_RandomMonsterDataID(sceneId)</code><br />从场景配置的候选怪物中随机返回一个数据编号。
| <code>LuaFnGetSceneAttr_RandomMonsterDataID(sceneId)</code><br />从场景配置的候选怪物中随机返回一个数据编号。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetSceneClientResID|LuaFnGetSceneClientResID]]
| [[Lua接口/服务端/LuaFnGetSceneClientResID|LuaFnGetSceneClientResID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetSceneClientResID(sceneId)</code><br />返回场景使用的客户端资源编号。
| <code>LuaFnGetSceneClientResID(sceneId)</code><br />返回场景使用的客户端资源编号。<br /><span class="lua-warn">脚本中未见调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetSceneSafeLevel|LuaFnGetSceneSafeLevel]]
| [[Lua接口/服务端/LuaFnGetSceneSafeLevel|LuaFnGetSceneSafeLevel]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetSceneSafeLevel(sceneId)</code><br />返回场景的安全等级限制。
| <code>LuaFnGetSceneSafeLevel(sceneId)</code><br />返回场景的安全等级限制。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetSceneType|LuaFnGetSceneType]]
| [[Lua接口/服务端/LuaFnGetSceneType|LuaFnGetSceneType]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetSceneType(sceneId)</code><br />返回当前场景的类型，详见:Config/SceneInfo.ini 里Type字段描述
| <code>LuaFnGetSceneType(sceneId)</code><br />返回当前场景的类型，详见:Config/SceneInfo.ini 里Type字段描述<br /><span class="lua-muted">脚本中 92 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetSceneWeather|LuaFnGetSceneWeather]]
| [[Lua接口/服务端/LuaFnGetSceneWeather|LuaFnGetSceneWeather]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetSceneWeather(sceneId)</code><br />返回场景当前天气编号，未设置天气时返回 -1。
| <code>LuaFnGetSceneWeather(sceneId)</code><br />返回场景当前天气编号，未设置天气时返回 -1。<br /><span class="lua-muted">脚本中 2 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnIsCharacterLiving|LuaFnIsCharacterLiving]]
| [[Lua接口/服务端/LuaFnIsCharacterLiving|LuaFnIsCharacterLiving]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnIsCharacterLiving(sceneId, objId)</code><br />判断objId号的Obj是否是活的
| <code>LuaFnIsCharacterLiving(sceneId, objId)</code><br />判断objId号的Obj是否是活的<br /><span class="lua-muted">脚本中 68 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnIsObjValid|LuaFnIsObjValid]]
| [[Lua接口/服务端/LuaFnIsObjValid|LuaFnIsObjValid]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnIsObjValid(sceneId, objId)</code><br />判断是否拥有objId号的Obj
| <code>LuaFnIsObjValid(sceneId, objId)</code><br />判断是否拥有objId号的Obj<br /><span class="lua-muted">脚本中 362 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnSendMailToAllFriend|LuaFnSendMailToAllFriend]]
| [[Lua接口/服务端/LuaFnSendMailToAllFriend|LuaFnSendMailToAllFriend]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSendMailToAllFriend(sceneId, selfId, szMail, numArg, ...)</code><br />给所有好友发送普通邮件
| <code>LuaFnSendMailToAllFriend(sceneId, selfId, szMail, numArg, ...)</code><br />给所有好友发送普通邮件<br /><span class="lua-muted">脚本中 2 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnSendMailToGUID|LuaFnSendMailToGUID]]
| [[Lua接口/服务端/LuaFnSendMailToGUID|LuaFnSendMailToGUID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSendMailToGUID(sceneId, guid, szMail)</code><br />按角色 GUID 发送系统邮件。
| <code>LuaFnSendMailToGUID(sceneId, guid, szMail)</code><br />按角色 GUID 发送系统邮件。<br /><span class="lua-muted">脚本中 37 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnSendNormalMail|LuaFnSendNormalMail]]
| [[Lua接口/服务端/LuaFnSendNormalMail|LuaFnSendNormalMail]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSendNormalMail(sceneId, selfId, szName, szMail)</code><br />发送普通邮件
| <code>LuaFnSendNormalMail(sceneId, selfId, szName, szMail)</code><br />发送普通邮件<br /><span class="lua-warn">脚本中未见调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnSendScriptMail|LuaFnSendScriptMail]]
| [[Lua接口/服务端/LuaFnSendScriptMail|LuaFnSendScriptMail]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSendScriptMail(sceneId, szName, uParam0, uParam1, uParam2, uParam3)</code><br />发送可执行邮件
| <code>LuaFnSendScriptMail(sceneId, szName, uParam0, uParam1, uParam2, uParam3)</code><br />发送可执行邮件<br /><span class="lua-muted">脚本中 11 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnSendSystemMail|LuaFnSendSystemMail]]
| [[Lua接口/服务端/LuaFnSendSystemMail|LuaFnSendSystemMail]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSendSystemMail(sceneId, szName, szMail)</code><br />发送系统邮件
| <code>LuaFnSendSystemMail(sceneId, szName, szMail)</code><br />发送系统邮件<br /><span class="lua-muted">脚本中 79 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnSetCopySceneData_NoUserCloseTime|LuaFnSetCopySceneData_NoUserCloseTime]]
| [[Lua接口/服务端/LuaFnSetCopySceneData_NoUserCloseTime|LuaFnSetCopySceneData_NoUserCloseTime]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSetCopySceneData_NoUserCloseTime(sceneId, closeTime)</code><br />设置副本创建数据里的:没有人后副本场景自动关闭清除的时间。
| <code>LuaFnSetCopySceneData_NoUserCloseTime(sceneId, closeTime)</code><br />设置副本创建数据里的:没有人后副本场景自动关闭清除的时间。<br /><span class="lua-muted">脚本中 81 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnSetCopySceneData_Param|LuaFnSetCopySceneData_Param]]
| [[Lua接口/服务端/LuaFnSetCopySceneData_Param|LuaFnSetCopySceneData_Param]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSetCopySceneData_Param(sceneId, uIndex, nValue)</code><br />设置副本创建数据里的:场景参数信息
| <code>LuaFnSetCopySceneData_Param(sceneId, uIndex, nValue)</code><br />设置副本创建数据里的:场景参数信息<br /><span class="lua-muted">脚本中 2142 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnSetCopySceneData_PvpRuler|LuaFnSetCopySceneData_PvpRuler]]
| [[Lua接口/服务端/LuaFnSetCopySceneData_PvpRuler|LuaFnSetCopySceneData_PvpRuler]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSetCopySceneData_PvpRuler(sceneId, pvpRuler)</code><br />设置副本场景的 PVP 规则。
| <code>LuaFnSetCopySceneData_PvpRuler(sceneId, pvpRuler)</code><br />设置副本场景的 PVP 规则。<br /><span class="lua-muted">脚本中 4 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnSetCopySceneData_TeamLeader|LuaFnSetCopySceneData_TeamLeader]]
| [[Lua接口/服务端/LuaFnSetCopySceneData_TeamLeader|LuaFnSetCopySceneData_TeamLeader]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSetCopySceneData_TeamLeader(sceneId, guidLeader)</code><br />设置副本创建数据里的队长GUID
| <code>LuaFnSetCopySceneData_TeamLeader(sceneId, guidLeader)</code><br />设置副本创建数据里的队长GUID<br /><span class="lua-muted">脚本中 81 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnSetCopySceneData_Timer|LuaFnSetCopySceneData_Timer]]
| [[Lua接口/服务端/LuaFnSetCopySceneData_Timer|LuaFnSetCopySceneData_Timer]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSetCopySceneData_Timer(sceneId, uTime)</code><br />设置副本创建数据里的:场景定时器的时间间隔，如果为0表示没有设置。
| <code>LuaFnSetCopySceneData_Timer(sceneId, uTime)</code><br />设置副本创建数据里的:场景定时器的时间间隔，如果为0表示没有设置。<br /><span class="lua-muted">脚本中 81 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnSetIsCityCopyScene|LuaFnSetIsCityCopyScene]]
| [[Lua接口/服务端/LuaFnSetIsCityCopyScene|LuaFnSetIsCityCopyScene]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSetIsCityCopyScene(sceneId, isCityCopyScene)</code><br />设置场景的城市副本标志。
| <code>LuaFnSetIsCityCopyScene(sceneId, isCityCopyScene)</code><br />设置场景的城市副本标志。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnSetSceneCopySceneCityData|LuaFnSetSceneCopySceneCityData]]
| [[Lua接口/服务端/LuaFnSetSceneCopySceneCityData|LuaFnSetSceneCopySceneCityData]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSetSceneCopySceneCityData(sceneId, destSceneId)</code><br />将源场景的城市初始化数据复制到目标场景。
| <code>LuaFnSetSceneCopySceneCityData(sceneId, destSceneId)</code><br />将源场景的城市初始化数据复制到目标场景。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnSetSceneLoad_Area|LuaFnSetSceneLoad_Area]]
| [[Lua接口/服务端/LuaFnSetSceneLoad_Area|LuaFnSetSceneLoad_Area]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSetSceneLoad_Area(sceneId, areaName)</code><br />设置副本创建选项里的事件区分布文件,类似"*_area.ini",
| <code>LuaFnSetSceneLoad_Area(sceneId, areaName)</code><br />设置副本创建选项里的事件区分布文件,类似"*_area.ini",<br /><span class="lua-muted">脚本中 45 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnSetSceneLoad_GrowPointData|LuaFnSetSceneLoad_GrowPointData]]
| [[Lua接口/服务端/LuaFnSetSceneLoad_GrowPointData|LuaFnSetSceneLoad_GrowPointData]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSetSceneLoad_GrowPointData(sceneId, growpointdataName)</code><br />设置副本创建选项里的生长点分布文件,类似"*_growpoint.ini",
| <code>LuaFnSetSceneLoad_GrowPointData(sceneId, growpointdataName)</code><br />设置副本创建选项里的生长点分布文件,类似"*_growpoint.ini",<br /><span class="lua-warn">脚本中未见调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnSetSceneLoad_GrowPointSetup|LuaFnSetSceneLoad_GrowPointSetup]]
| [[Lua接口/服务端/LuaFnSetSceneLoad_GrowPointSetup|LuaFnSetSceneLoad_GrowPointSetup]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSetSceneLoad_GrowPointSetup(sceneId, growpointsetupName)</code><br />设置副本创建选项里的从生长点里能生成的物品分布文件,类似"*_growpointsetup.ini",
| <code>LuaFnSetSceneLoad_GrowPointSetup(sceneId, growpointsetupName)</code><br />设置副本创建选项里的从生长点里能生成的物品分布文件,类似"*_growpointsetup.ini",<br /><span class="lua-warn">脚本中未见调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnSetSceneLoad_Map|LuaFnSetSceneLoad_Map]]
| [[Lua接口/服务端/LuaFnSetSceneLoad_Map|LuaFnSetSceneLoad_Map]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSetSceneLoad_Map(sceneId, mapName)</code><br />设置副本创建选项里的导航图文件，类似"*.nav", 不需要带路径
| <code>LuaFnSetSceneLoad_Map(sceneId, mapName)</code><br />设置副本创建选项里的导航图文件，类似"*.nav", 不需要带路径<br /><span class="lua-muted">脚本中 83 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnSetSceneLoad_Monster|LuaFnSetSceneLoad_Monster]]
| [[Lua接口/服务端/LuaFnSetSceneLoad_Monster|LuaFnSetSceneLoad_Monster]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSetSceneLoad_Monster(sceneId, monsterName)</code><br />设置副本创建选项里的怪物分布文件,类似"*_monster.ini",
| <code>LuaFnSetSceneLoad_Monster(sceneId, monsterName)</code><br />设置副本创建选项里的怪物分布文件,类似"*_monster.ini",<br /><span class="lua-muted">脚本中 122 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnSetSceneLoad_PatrolPointData|LuaFnSetSceneLoad_PatrolPointData]]
| [[Lua接口/服务端/LuaFnSetSceneLoad_PatrolPointData|LuaFnSetSceneLoad_PatrolPointData]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSetSceneLoad_PatrolPointData(sceneId, patrolpointdataName)</code><br />设置副本创建选项里的巡逻路径分布文件,类似"*_patrolpoint.ini",
| <code>LuaFnSetSceneLoad_PatrolPointData(sceneId, patrolpointdataName)</code><br />设置副本创建选项里的巡逻路径分布文件,类似"*_patrolpoint.ini",<br /><span class="lua-warn">脚本中未见调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnSetSceneLoad_Pet|LuaFnSetSceneLoad_Pet]]
| [[Lua接口/服务端/LuaFnSetSceneLoad_Pet|LuaFnSetSceneLoad_Pet]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSetSceneLoad_Pet(sceneId, petName)</code><br />设置副本创建选项里的宠物分布文件,类似"*_pet.ini",
| <code>LuaFnSetSceneLoad_Pet(sceneId, petName)</code><br />设置副本创建选项里的宠物分布文件,类似"*_pet.ini",<br /><span class="lua-warn">脚本中未见调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnSetSceneLoad_Platform|LuaFnSetSceneLoad_Platform]]
| [[Lua接口/服务端/LuaFnSetSceneLoad_Platform|LuaFnSetSceneLoad_Platform]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSetSceneLoad_Platform(sceneId, platformName)</code><br />设置副本创建选项里的操作台分布文件,类似"*_platform.ini",
| <code>LuaFnSetSceneLoad_Platform(sceneId, platformName)</code><br />设置副本创建选项里的操作台分布文件,类似"*_platform.ini",<br /><span class="lua-warn">脚本中未见调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnSetSceneSafeLevel|LuaFnSetSceneSafeLevel]]
| [[Lua接口/服务端/LuaFnSetSceneSafeLevel|LuaFnSetSceneSafeLevel]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSetSceneSafeLevel(sceneId, safeLevel)</code><br />设置场景的安全等级限制。
| <code>LuaFnSetSceneSafeLevel(sceneId, safeLevel)</code><br />设置场景的安全等级限制。<br /><span class="lua-warn">脚本中未见调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnSetSceneWeather|LuaFnSetSceneWeather]]
| [[Lua接口/服务端/LuaFnSetSceneWeather|LuaFnSetSceneWeather]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSetSceneWeather(sceneId, weather, leftTime)</code><br />设置场景天气及其剩余持续时间（毫秒）。
| <code>LuaFnSetSceneWeather(sceneId, weather, leftTime)</code><br />设置场景天气及其剩余持续时间（毫秒）。<br /><span class="lua-muted">脚本中 8 处调用</span>
|}
|}
</div>
</div>

2026年9月19日 (六) 16:59的最新版本

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

场景与副本：44 个接口，44 个调用名称，其中 32 个在当前脚本中有调用。
函数 / 别名 调用与用途
FindCopySceneIDByCopySceneParams FindCopySceneIDByCopySceneParams(sceneId, copySceneType, checkParamNum, ...)
按指定的副本参数查找正在运行的副本场景。
脚本中 4 处调用
GetMonsterCount GetMonsterCount(sceneId)
取得此场景中的怪物数量
脚本中 164 处调用
GetMonsterObjID GetMonsterObjID(sceneId, nIndex)
根据索引号取得怪物的ObjID
脚本中 166 处调用
IsCanEnterCopyScene IsCanEnterCopyScene(sceneId, guid)
判断玩家是否可以进入场景sceneId,
脚本中 22 处调用
LoadMonsterIni LoadMonsterIni(sceneId, monsterIni)
在指定场景执行怪物分布文件。
脚本中未见调用
LuaFnAskNpcScriptMail LuaFnAskNpcScriptMail(sceneId, selfId, scriptType)
请求世界服务器下发 NPC 脚本邮件。
脚本中 3 处调用
LuaFnCreateCopyScene LuaFnCreateCopyScene(sceneId)
根据当前场景已设置的副本创建参数，创建或选择副本场景。
脚本中 81 处调用
LuaFnGetCopyScene_HumanCount LuaFnGetCopyScene_HumanCount(sceneId)
返回当前场景里面的玩家数量
脚本中 286 处调用
LuaFnGetCopyScene_HumanObjId LuaFnGetCopyScene_HumanObjId(sceneId, uIndex)
读取场景参数信息
脚本中 336 处调用
LuaFnGetCopySceneData_NoUserCloseTime LuaFnGetCopySceneData_NoUserCloseTime(sceneId)
返回没有人后副本场景自动关闭清除的时间（毫秒）。
脚本中未见调用
LuaFnGetCopySceneData_Param LuaFnGetCopySceneData_Param(sceneId, uIndex)
读取场景参数信息
脚本中 1161 处调用
LuaFnGetCopySceneData_TeamLeader LuaFnGetCopySceneData_TeamLeader(sceneId)
返回副本创建数据里的队长GUID，失败－1
脚本中 102 处调用
LuaFnGetCopySceneData_Timer LuaFnGetCopySceneData_Timer(sceneId)
读取场景定时器的时间间隔，如果为0表示没有设置。
脚本中未见调用
LuaFnGetCopySceneIDByTeamLeaderGUID LuaFnGetCopySceneIDByTeamLeaderGUID(sceneId, teamLeaderGUID, copySceneType)
按队长和副本类型查找正在运行的副本场景。
脚本中未见调用
LuaFnGetSceneAttr_CanCreateRascalKiller LuaFnGetSceneAttr_CanCreateRascalKiller(sceneId)
返回场景是否允许创建惩罚恶人 NPC，缺少配置时返回 0。
脚本中 1 处调用
LuaFnGetSceneAttr_RandomMonsterDataID LuaFnGetSceneAttr_RandomMonsterDataID(sceneId)
从场景配置的候选怪物中随机返回一个数据编号。
脚本中 1 处调用
LuaFnGetSceneClientResID LuaFnGetSceneClientResID(sceneId)
返回场景使用的客户端资源编号。
脚本中未见调用
LuaFnGetSceneSafeLevel LuaFnGetSceneSafeLevel(sceneId)
返回场景的安全等级限制。
脚本中 1 处调用
LuaFnGetSceneType LuaFnGetSceneType(sceneId)
返回当前场景的类型，详见:Config/SceneInfo.ini 里Type字段描述
脚本中 92 处调用
LuaFnGetSceneWeather LuaFnGetSceneWeather(sceneId)
返回场景当前天气编号，未设置天气时返回 -1。
脚本中 2 处调用
LuaFnIsCharacterLiving LuaFnIsCharacterLiving(sceneId, objId)
判断objId号的Obj是否是活的
脚本中 68 处调用
LuaFnIsObjValid LuaFnIsObjValid(sceneId, objId)
判断是否拥有objId号的Obj
脚本中 362 处调用
LuaFnSendMailToAllFriend LuaFnSendMailToAllFriend(sceneId, selfId, szMail, numArg, ...)
给所有好友发送普通邮件
脚本中 2 处调用
LuaFnSendMailToGUID LuaFnSendMailToGUID(sceneId, guid, szMail)
按角色 GUID 发送系统邮件。
脚本中 37 处调用
LuaFnSendNormalMail LuaFnSendNormalMail(sceneId, selfId, szName, szMail)
发送普通邮件
脚本中未见调用
LuaFnSendScriptMail LuaFnSendScriptMail(sceneId, szName, uParam0, uParam1, uParam2, uParam3)
发送可执行邮件
脚本中 11 处调用
LuaFnSendSystemMail LuaFnSendSystemMail(sceneId, szName, szMail)
发送系统邮件
脚本中 79 处调用
LuaFnSetCopySceneData_NoUserCloseTime LuaFnSetCopySceneData_NoUserCloseTime(sceneId, closeTime)
设置副本创建数据里的:没有人后副本场景自动关闭清除的时间。
脚本中 81 处调用
LuaFnSetCopySceneData_Param LuaFnSetCopySceneData_Param(sceneId, uIndex, nValue)
设置副本创建数据里的:场景参数信息
脚本中 2142 处调用
LuaFnSetCopySceneData_PvpRuler LuaFnSetCopySceneData_PvpRuler(sceneId, pvpRuler)
设置副本场景的 PVP 规则。
脚本中 4 处调用
LuaFnSetCopySceneData_TeamLeader LuaFnSetCopySceneData_TeamLeader(sceneId, guidLeader)
设置副本创建数据里的队长GUID
脚本中 81 处调用
LuaFnSetCopySceneData_Timer LuaFnSetCopySceneData_Timer(sceneId, uTime)
设置副本创建数据里的:场景定时器的时间间隔，如果为0表示没有设置。
脚本中 81 处调用
LuaFnSetIsCityCopyScene LuaFnSetIsCityCopyScene(sceneId, isCityCopyScene)
设置场景的城市副本标志。
脚本中 1 处调用
LuaFnSetSceneCopySceneCityData LuaFnSetSceneCopySceneCityData(sceneId, destSceneId)
将源场景的城市初始化数据复制到目标场景。
脚本中 1 处调用
LuaFnSetSceneLoad_Area LuaFnSetSceneLoad_Area(sceneId, areaName)
设置副本创建选项里的事件区分布文件,类似"*_area.ini",
脚本中 45 处调用
LuaFnSetSceneLoad_GrowPointData LuaFnSetSceneLoad_GrowPointData(sceneId, growpointdataName)
设置副本创建选项里的生长点分布文件,类似"*_growpoint.ini",
脚本中未见调用
LuaFnSetSceneLoad_GrowPointSetup LuaFnSetSceneLoad_GrowPointSetup(sceneId, growpointsetupName)
设置副本创建选项里的从生长点里能生成的物品分布文件,类似"*_growpointsetup.ini",
脚本中未见调用
LuaFnSetSceneLoad_Map LuaFnSetSceneLoad_Map(sceneId, mapName)
设置副本创建选项里的导航图文件，类似"*.nav", 不需要带路径
脚本中 83 处调用
LuaFnSetSceneLoad_Monster LuaFnSetSceneLoad_Monster(sceneId, monsterName)
设置副本创建选项里的怪物分布文件,类似"*_monster.ini",
脚本中 122 处调用
LuaFnSetSceneLoad_PatrolPointData LuaFnSetSceneLoad_PatrolPointData(sceneId, patrolpointdataName)
设置副本创建选项里的巡逻路径分布文件,类似"*_patrolpoint.ini",
脚本中未见调用
LuaFnSetSceneLoad_Pet LuaFnSetSceneLoad_Pet(sceneId, petName)
设置副本创建选项里的宠物分布文件,类似"*_pet.ini",
脚本中未见调用
LuaFnSetSceneLoad_Platform LuaFnSetSceneLoad_Platform(sceneId, platformName)
设置副本创建选项里的操作台分布文件,类似"*_platform.ini",
脚本中未见调用
LuaFnSetSceneSafeLevel LuaFnSetSceneSafeLevel(sceneId, safeLevel)
设置场景的安全等级限制。
脚本中未见调用
LuaFnSetSceneWeather LuaFnSetSceneWeather(sceneId, weather, leftTime)
设置场景天气及其剩余持续时间（毫秒）。
脚本中 8 处调用
检索自“https://www.waylee.net/index.php?title=Lua接口/服务端函数索引/场景与副本&oldid=8636”