查看“︁Lua接口/服务端函数索引/场景与副本”︁的源代码

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

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