Lua接口/任务状态

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

查询、接取、完成与删除任务。任务编号（misId）来自任务表，不是任务索引（misIndex）。

查询

接口	参数与返回
GetMission	sceneId, selfId, misId → 任务值（做过/正在做/未做）；失败 -1。
IsMissionHaveDone	sceneId, selfId, misId → 是否做过；失败 -1。
IsHaveMission	sceneId, selfId, misId → 是否正在做；失败 -1。
GetMissionCount	sceneId, selfId → 已接任务数量；失败 -1。
IsMissionFull	sceneId, selfId → 任务列表是否已满；失败 -1。
GetMissionIndexByID	sceneId, selfId, misId → 任务索引；失败 -1。
GetScriptIDByMissionID	sceneId, selfId, missionId → 任务绑定的脚本编号；失败 -1。

GetMission 返回的任务值含义按本服约定（做过/正在做/未做的编号不同），失败返回 -1。IsMissionHaveDone 与 IsHaveMission 语义不同：前者查是否做过，后者查是否正在做。任务编号（misId）与任务索引（misIndex，见 任务变量）不同。

接取与删除

接口	参数与返回
AddMission	sceneId, selfId, misId, scriptId, killObjEvent, enterAreaEvent, itemChangedEvent → 6 个参数；返回值；失败 -1。
AddMissionEx	sceneId, selfId, misId, scriptId → 4 个参数；返回值；失败 -1。
DelMission	sceneId, selfId, misId → 1 成功、-1 失败。
DelAllMission	sceneId, selfId → 1 成功、-1 失败。
MissionCom	sceneId, selfId, misId；无返回值。

AddMission 需要 6 个参数（含杀怪、进入区域、物品变化事件标志），AddMissionEx 简化为 4 个参数（只传脚本编号）。MissionCom 无返回值，赋值接收得到 nil，不能据此判断是否完成。

事件标志

接口	参数与返回
SetMissionEvent	sceneId, selfId, misId, eventId → 返回值；失败 -1。
ResetMissionEvent	sceneId, selfId, missionId, eventId → 返回值；失败 -1。
StartMissionTimer	sceneId, selfId, missionId → 返回值；失败 -1。
StopMissionTimer	sceneId, selfId, missionId → 返回值；失败 -1。

SetMissionEvent 设置任务事件标志，ResetMissionEvent 清除。定时器事件由 StartMissionTimer / StopMissionTimer 控制。

检查任务状态

local done = IsMissionHaveDone(sceneId, selfId, misId)
if type(done) == "number" and done ~= -1 then
    -- 取得任务完成状态
end

IsMissionHaveDone 失败返回 -1，先判类型再判数值（见 返回值判断）。

接取任务

local result = AddMissionEx(sceneId, selfId, misId, scriptId)
if type(result) == "number" and result ~= -1 then
    -- 任务接取流程报告成功
end

AddMissionEx 返回值含义按本服约定，失败 -1。AddMission 的 6 参数版本还需要杀怪、进入区域、物品变化事件标志。

完成任务

MissionCom(sceneId, selfId, misId)
-- 无返回值；不能写 if MissionCom(...) then 判断
-- 想确认应改读 IsMissionHaveDone 回比

MissionCom 无返回值。需要确认任务是否完成，应在调用后用 IsMissionHaveDone 读回比较。

相关主题

• 角色信息
• 属性读取与修改
• 等级与经验
• 货币相关
• 物品查询
• 物品发放与扣除
• 背包空间
• 装备操作
• 任务状态
• 任务变量
• NPC 对话
• 对话选项
• 技能相关
• 心法相关
• 状态效果
• 生活技能
• 珍兽查询
• 珍兽操作
• 场景查询
• 坐标与传送
• 副本相关
• 活动相关
• 时间与计时
• 怪物相关
• 队伍相关
• 帮会相关
• 消息与提示
• 聊天与公告

服务端调用约定 · 服务端调用示例 · 服务端函数索引

函数不存在或提示 nil · 参数类型与顺序 · 返回值判断 · 对象 ID 与 GUID