【后端接口】newpicktask 与 newcompletetask：任务接口的接取与交付

实战应用：用在哪里

任务系统的引擎接口对：newpicktask 接任务、newcompletetask 交任务，任务的数据驱动让策划在任务表里配目标与奖励，后端脚本只负责在正确的时机调这两个接口。任务链的自动化（连续任务、条件解锁）建立在这对接口之上。

接口签名与接取

---接取任务 actor:玩家 nId:任务ID
function newpicktask(actor, nId) end
---完成任务
function newcompletetask(actor, nId) end

-- 击杀触发里推进击杀类任务
function killmon(actor, mon)
    local taskId = activeTaskNeedsKill(actor, mon:GetName())
    if taskId then
        local done = taskKillCount(actor, taskId) >= taskTarget(actor, taskId)
        if done then
            newcompletetask(actor, taskId)
            sendmsg(actor, 1, "任务完成，回师门交任务吧")
        end
    end
end

任务的接取把任务实例挂到玩家身上，完成接口标记任务达成并触发奖励的结算流程。任务的目标达成判定在业务侧：击杀计数、收集计数、对话触发，计数达标后调 newcompletetask 交付，交付的动作让引擎走奖励发放与后续任务的解锁。

条件解锁的链

-- 主线链：完成当前任务自动接下一环
function chainNext(actor, doneTaskId)
    local nextId = TASK_CHAIN[doneTaskId]
    if nextId and taskConditionOk(actor, nextId) then
        newpicktask(actor, nextId)
        local title = taskTitle(nextId)
        sendmsg(actor, 1, "新任务：" .. title)
    end
end

任务链用一张链表驱动：完成当前环查链表的下一环，条件满足自动接取，主线的推进对玩家是无缝的。任务的放弃与重接：放弃接口清掉任务实例与进度，重接从头计数，进度是否保留是任务设计的决策点而不是引擎的默认行为。任务的日志（接取、进度、交付、放弃）是任务卡壳排查的数据基础。

验证与监控

任务的接取与交付漏斗监控，接取多交付少的环节就是卡壳环节。

踩坑记录

任务 ID 的复用曾经让老玩家的历史任务与新任务撞号，完成标记错乱，任务 ID 的全局唯一性分配是任务表管理的第一原则。newcompletetask 的重复调用在部分版本会重复发奖，交付的幂等标记在业务层补了双保险。任务目标的计数场景遗漏过组队击杀的归属：组队时击杀计数只算收尾一击的玩家，共享计数的规则修正后组队任务体验才顺畅。

上线要点

任务接口的调用时机与任务的展示时机要区分：接取接口调用后客户端的任务栏同步展示，接取的时机在对话确认后而不是条件满足瞬间。任务链的环形检测要做，链表配置错误成环会让玩家在两个任务间死循环。任务的奖励发放走引擎的统一结算，奖励表的配置错误在任务交付时暴露，任务表的校验器是上线前的守门员。

本文由 996 技术组基于 996 引擎官方知识库与浮生梦老师课程体系整理。团队长期从事传奇类引擎 Lua 后端逻辑、客户端界面与商业版本交付，内容以官方知识库与真实项目为出处，按版本持续修订。