The Quest Journal: Missions and Checkpoints

Dialogues (stages) are what the player sees and clicks on. But a story chapter has another layer — the quest journal (missions), which shows the player their current tasks regardless of which dialogue stage they're on. This is handy for tasks like "bring 5 bloodsucker hides," which are completed not through dialogue but through actions out in the open world.

Structure

"missions": [
  {
    "title": "Loot from the Cordon",
    "name": "quest_sidorovich_hunt",
    "checkpoints": [
      {
        "title": "Find the stash near the checkpoint",
        "parameter": "cordon_stash_found",
        "type": "FIND_ITEM",
        "condition": { "has": ["cordon_stash_found"] },
        "actions": { "openNotification": ["Task", "Stash found!"] }
      }
    ]
  }
]

• title — the mission's name, as seen by the player in the journal.
• name — the mission's internal identifier (slug).
• checkpoints — an ordered list of steps; each one closes when its condition is satisfied.

Checkpoint types

Type	Meaning	Status
FIND_ITEM	The step closes when a flag/item named in parameter appears on the player	Confirmed to be used in real content — the main working type
KILL	Presumably tracks kills	Present in the data types, but not found in the content examined — treat as experimental, confirm the behavior with the developers before using it
TRAVEL	Presumably tracks movement/visiting a location	Same as KILL — not found in real stories, confirm before using

Practical advice

The most reliable, proven pattern is driving checkpoints through the same flag as your dialogue:

1. An action somewhere in the world (a point on the map or a squad) grants a flag via add once a condition is met.
2. A FIND_ITEM checkpoint with that same name in parameter closes automatically.
3. A dialogue in another stage checks the same flag via has to show the NPC's reaction.

This way a single flag drives both the dialogue and the quest journal at once — no need to duplicate logic.

Next

• Actions — which commands grant flags/items for checkpoints.
• Points on the Map — how to tie a checkpoint to a specific place in the world.