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

来自天龙知识库
雪舞留言 | 贡献2026年9月7日 (一) 19:16的版本 (整理当前服务端 Lua 接口:注册名称、参数、返回值与调用说明)
(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)
跳到导航跳到搜索

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

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