mod_quests_base/docs/zh.md

Quests Engine — 任务、任务步骤与日志

Quests Engine 替玩家记账。每个任务都有名称和编号的步骤列表；剧本负责开启任务、推进到下一步、打上标记并完成任务。日志面板显示玩家已领取的任务，游戏会保存它们的状态。

Cthangover（序章的苏醒和旧宅）与 RPG Plus（森林任务）都用到了它。

日志

用工具栏上的日志图标打开。玩家还没领取任何任务时，日志是空的：

在 RPG Plus 里，村庄的长老给出第一个任务。向他问问去哪里找：

回答之后，任务就出现在日志里：

• 进行中列出正在做的任务，已完成列出做完的。还没开始的任务永远不会出现。
• 右页显示选中的任务：已完成的步骤划掉，当前步骤做了标记，后续步骤保持隐藏——日志不会剧透后面的故事。
• 任务获得的标记会以小小的金色标签显示在条目下方。

任务的定义

任务是 mod 的 quests/ 文件夹里类型为 quest 的 JSON 文件。这就是截图中的任务（来自 RPG Plus）：

{
  "Kind": "quest",
  "Items": [
    {
      "Id": "woodland_ward",
      "Name": "rpg_plus/quest/ward/name",
      "StatusToDescription": {
        "0": "rpg_plus/quest/ward/0",
        "1": "rpg_plus/quest/ward/1",
        "2": "rpg_plus/quest/ward/2",
        "3": "rpg_plus/quest/ward/3",
        "4": "rpg_plus/quest/ward/4"
      }
    }
  ]
}

Name 和每个步骤都是翻译键。数字就是任务的步骤：在第 1 步时，1 的文本显示为当前步骤，0 则划掉——即截图中的「第 II 条，共 V 条」。

从剧本推进任务

RPG Plus 中长老的回答会开启任务并把它放到第 1 步：

action quest.set_status quest_id=woodland_ward status=Progress
action quest.set_data_status quest_id=woodland_ward level=1

• quest.set_status — 任务的状态：NotStarted、Progress（进行中）或 End（已完成）。
• quest.set_data_status — 当前步骤，level 是它的编号。
• quest.add_tag / quest.remove_tag 配合 tag=… — 记下发生过的事，比如玩家先拿了哪个物品。
• quest.send_notification — 向玩家弹出任务通知；改变任务本身不会触发通知。

检查任务

凡是游戏接受条件的地方都能用任务检查：when、选项条件、场景条件和地图事件。

when "woodland_ward.DataStatus >= 2" -> :lantern

• <quest>.IsActive — 任务正在进行；
• <quest>.Status — 0 未开始，1 进行中，2 已完成；
• <quest>.DataStatus — 当前步骤；
• <quest>.hasTag("tag")、<quest>.notHasTag("tag") — Cthangover 用它们决定场景播放哪段剧本，例如 AwakeningQuest.hasTag("book_taken")。

出问题时

1. 任务不在日志里。 它的状态必须是 Progress（或在「已完成」页签显示则用 End）；只设置步骤是不够的。
2. 日志显示的是键而不是文本。 把步骤的键加进 mod 的 locale 文件。
3. 条件永远为假。 写的任务 id 与任务文件里的 Id 不一致；日志会警告存在未知任务。