Lua接口/任务状态：修订间差异

2026年9月12日 (六) 13:28的版本

查询、接取、完成与删除任务。任务编号（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 读回比较。

@@ 第107行： / 第107行： @@
 * [[Lua接口/NPC对话|NPC 对话]]
 * [[Lua接口/对话选项|对话选项]]
+* [[Lua接口/技能相关|技能相关]]
+* [[Lua接口/心法相关|心法相关]]
+* [[Lua接口/状态效果|状态效果]]
+* [[Lua接口/生活技能|生活技能]]
+* [[Lua接口/珍兽查询|珍兽查询]]
+* [[Lua接口/珍兽操作|珍兽操作]]
 [[Lua接口/服务端调用约定|服务端调用约定]] · [[Lua接口/服务端调用示例|服务端调用示例]] · [[Lua接口/服务端函数索引|服务端函数索引]]