newcompletetask这个命令怎么去用
🤖 回答引擎: 后端Lua |
🕒 时间: 2026-04-04 17:32:31 |
👁️ 阅读: 1
我是lua后端老师！
小仙，`newcompletetask`这个命令是用来**完成任务**的。它的用法非常简单，主要是在脚本中调用，当玩家满足某个任务的所有条件后，用这个命令来标记任务为“已完成”状态。
它的基本语法格式如下：
```lua
newcompletetask(play, nId)
```
让我为你详细解释一下这两个参数：
* **`play`**：这个是**玩家对象**，代表你要对哪个玩家进行操作。在QF（QFunction-0.lua）触发脚本里，它通常就是 `self` 或者 `actor`。
* **`nId`**：这个是**任务ID**，是一个整数。你需要在这里填写你想要完成的任务在 `cfg_newtask.xls`（任务配置表）里对应的ID编号。
**举个简单的使用例子：**
假设我们有一个任务，ID是 `1001`，内容是“击败10只野猪”。当玩家杀死第10只野猪时，我们就在 `QFunction-0.lua` 的 `killmon`（杀怪触发）里写逻辑。
```lua
-- 在 QFunction-0.lua 的 [@killmon] 段或对应函数里
function killmon(actor, mon)
local monName = getmonbaseinfo(mon, 'name') -- 获取怪物名字
if monName == ‘野猪’ then
-- 假设我们用变量记录杀怪数量
local killCount = getplayvar(actor, ‘N_野猪数量’) or 0
killCount = killCount + 1
setplayvar(actor, ‘N_野猪数量’, killCount)
if killCount >= 10 then
-- 当杀够10只时，完成任务ID为1001的任务
newcompletetask(actor, 1001)
sendmsg(actor, “恭喜你完成了[击败野猪]任务！”, 1) -- 给玩家发个提示
end
end
end
```
**重要提示和关联知识：**
1. **触发联动**：当你调用 `newcompletetask` 成功完成任务时，引擎会自动触发 `[@completetask]` 这个QF标签，你可以在里面写任务完成后的奖励发放逻辑（比如给经验、给物品、触发下一个任务等）。
```lua
-- 在 QFunction-0.lua 里
[@completetask]
function completetask(actor, taskID)
if taskID == 1001 then
giveitem(actor, ‘金币’, 1000) -- 给予1000金币作为奖励
changeexp(actor, 5000) -- 给予5000经验
release_print(string.format(“玩家%s完成了任务%d”, actor, taskID)) -- 后台打印日志
end
end
```
2. **与 `newchangetask` 的区别**：`newchangetask` 是用来**刷新进行中任务的状态**的（比如更新任务描述里的杀怪数量 `%s`），而 `newcompletetask` 是最终**结束并提交**任务。别搞混啦。
3. **前置操作**：通常，在调用 `newcompletetask` 之前，任务需要先通过 `newpicktask` 接取，并通过 `newchangetask` 更新过进度。
总结一下步骤就是：**接取任务 (`newpicktask`) -> 更新进度 (`newchangetask`) -> 完成任务 (`newcompletetask`)**。你明白了吗，小仙？如果还有不清楚的地方，随时可以再问我！
← 返回问答库