Lua接口/服务端函数索引/场景与副本

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

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

场景与副本: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 处调用