82 lines
3.7 KiB
Markdown
82 lines
3.7 KiB
Markdown
# Quests Engine — 任务、任务步骤与日志
|
|
|
|
Quests Engine 替玩家记账。每个任务都有名称和编号的步骤列表；剧本负责开启任务、推进到下一步、打上标记并完成任务。**日志**面板显示玩家已领取的任务，游戏会保存它们的状态。
|
|
|
|
Cthangover（序章的苏醒和旧宅）与 RPG Plus（森林任务）都用到了它。
|
|
|
|
## 日志
|
|
|
|
用工具栏上的日志图标打开。玩家还没领取任何任务时，日志是空的：
|
|
|
|
|
|
|
|
在 RPG Plus 里，村庄的长老给出第一个任务。向他问问去哪里找：
|
|
|
|
|
|
|
|
回答之后，任务就出现在日志里：
|
|
|
|
|
|
|
|
- **进行中**列出正在做的任务，**已完成**列出做完的。还没开始的任务永远不会出现。
|
|
- 右页显示选中的任务：已完成的步骤划掉，当前步骤做了标记，后续步骤保持隐藏——日志不会剧透后面的故事。
|
|
- 任务获得的标记会以小小的金色标签显示在条目下方。
|
|
|
|
## 任务的定义
|
|
|
|
任务是 mod 的 `quests/` 文件夹里类型为 `quest` 的 JSON 文件。这就是截图中的任务（来自 RPG Plus）：
|
|
|
|
```json
|
|
{
|
|
"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 步：
|
|
|
|
```scenario
|
|
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`、选项条件、场景条件和地图事件。
|
|
|
|
```scenario
|
|
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` 不一致；日志会警告存在未知任务。
|