Lua接口/服务端/GetScriptIDByMissionID

来自雪舞天龙知识库
Waylee​(留言 | 贡献)2026年10月27日 (二) 12:41的版本 (维护服务端 Lua 接口:核对参数、返回值、边界条件与调用示例)
(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)
跳到导航跳到搜索

首页 · 服务端接口 · 任务与对话 · 调用约定

返回玩家指定任务绑定的脚本编号。

Lua 调用

GetScriptIDByMissionID(sceneId, selfId, missionId)

服务端脚本中共出现 23 处调用,实参个数出现过:3 个(23 处)。

实现位于 LuaFnTbl_Mission.h。

参数

序号 参数 / 类型 说明
1 sceneId
number
当前调用所在的场景 ID。
脚本中的实参:sceneId(23 处)
2 selfId
number
当前场景内的对象 ID。玩家接口需传入有效玩家对象;不是角色 GUID。
脚本中的实参:selfId(15 处)、curOwner(8 处)
3 missionId
number
任务编号。
脚本中的实参:mission(2 处)、x000016_g_RSMissionId、x000031_g_RSMissionId

返回值

返回 1 个值。返回类型包括 number。明确的固定返回组合包括 -1。

调用示例

以下取自随包服务端脚本的真实调用,可对照上方参数表确认参数顺序:

-- event/city/ecity_0104collectfoundrymat.lua
GetScriptIDByMissionID(sceneId, curOwner, x600006_g_MissionId)
-- event/city/ecity_0204collectseed.lua
GetScriptIDByMissionID(sceneId, curOwner, x600011_g_MissionId)
-- event/city/ecity_0304findtype.lua
GetScriptIDByMissionID(sceneId, curOwner, x600016_g_MissionId)

注意事项

  • 调用对象必须是当前场景中的有效玩家。