Response Quest — Know What To Do

For editors

Write a quest

A quest is data, not code: a graph of nodes, choices, effects and citation keys. Paste one below and it is checked against the same rules the build enforces — including that every citation resolves to an entry in the book’s own reference list, which is what stops the game from contradicting the book.

The rules a quest has to pass: exactly one correct choice per turn; every node reachable from the start; every branch ends; at least one ending; every role you list holds at least one turn; a correct answer is never also marked late; and a perfect run scores well above a wrong one. The format is documented in docs/AUTHORING.md.

68 references are available to cite. A citation number means the same thing here as on the page of the book it came from.

Quest JSON

{
  "slug": "new-quest",
  "number": 90,
  "title": "A new quest",
  "subtitle": "Replace this with your own scenario",
  "hazard": "landslide",
  "ladder": "NBRO Level 1 → 3",
  "setting": "Fictional households. Real Divisional Secretariat divisions appear only as the places a warning names.",
  "briefing": {
    "place": "Somewhere with a slope above it and one road out.",
    "season": "South-west monsoon.",
    "time": "Evening.",
    "households": 3,
    "lines": [
      "Describe the households in the player's care, and who among them needs more time to move.",
      "Name the one thing that will go wrong if they wait."
    ]
  },
  "roles": [
    "warning_decoder",
    "evacuation_lead"
  ],
  "clock": {
    "startLabel": "18:00",
    "stepMinutes": 60
  },
  "meters": {
    "safety": 100,
    "trust": 70,
    "water": 80,
    "battery": 80,
    "cash": 70,
    "fuel": 70
  },
  "start": "s1_open",
  "unlockedBy": null,
  "lessons": [
    "One lesson per line, as the quest card shows them",
    "Each one should be something the book actually says"
  ],
  "nodes": [
    {
      "id": "s1_open",
      "kind": "beat",
      "clock": "18:00",
      "escalation": "NBRO Level 1 · Yellow",
      "eyebrow": "Opening",
      "title": "The warning arrives",
      "incoming": [
        {
          "kind": "radio",
          "source": "Regional service",
          "level": "yellow",
          "text": "A Level 1 landslide warning — yellow, be aware — for the named Divisional Secretariat divisions."
        }
      ],
      "situation": [
        "A beat has no decision in it. Use one to set a scene, to let time pass, or to deliver news."
      ],
      "next": "s2_decode"
    },
    {
      "id": "s2_decode",
      "kind": "choice",
      "clock": "18:40",
      "escalation": "NBRO Level 1 · Yellow",
      "eyebrow": "Warning Decoder",
      "title": "What does Level 1 mean tonight?",
      "role": "warning_decoder",
      "situation": [
        "Each choice needs feedback and a book note. Exactly one is correct."
      ],
      "prompt": "What do you do?",
      "choices": [
        {
          "id": "a",
          "label": "Do the Level 1 jobs now, while there is still light.",
          "verdict": "correct",
          "feedback": "Say what just happened and why the book puts this action at this level. Feedback on a correct choice still has to teach.",
          "book": {
            "quote": "Charge phones and power banks. Move valuables and documents into one bag.",
            "source": "When a landslide warning is issued for my area — Level 1 · Yellow",
            "page": "right-now/landslide-warning",
            "cites": [
              1
            ]
          },
          "timing": "early",
          "points": 25,
          "effects": [
            {
              "type": "flag",
              "flag": "prepared_early",
              "value": true
            },
            {
              "type": "meter",
              "meter": "trust",
              "delta": 5
            }
          ],
          "next": "s3_move"
        },
        {
          "id": "b",
          "label": "Wait and see whether it goes up a level.",
          "verdict": "wrong",
          "feedback": "Name the mistake and the page that warns against it. A wrong choice with no feedback teaches nothing, and the validator rejects it.",
          "book": {
            "source": "When a landslide warning is issued for my area — Level 1 · Yellow",
            "page": "right-now/landslide-warning",
            "cites": [
              1
            ]
          },
          "timing": "late",
          "points": 0,
          "effects": [
            {
              "type": "meter",
              "meter": "safety",
              "delta": -25
            },
            {
              "type": "delay",
              "id": "nothing_charged",
              "inTurns": 2,
              "unless": "prepared_early",
              "title": "A consequence arrives two turns later",
              "body": [
                "A delayed event is how a decision comes back. `unless` names a flag that cancels it, so a player who corrects the mistake is not punished for it."
              ],
              "effects": [
                {
                  "type": "meter",
                  "meter": "battery",
                  "delta": -40
                }
              ],
              "book": {
                "source": "When a landslide warning is issued for my area — Level 1 · Yellow",
                "page": "right-now/landslide-warning",
                "cites": [
                  1
                ]
              }
            }
          ],
          "next": "s3_move"
        }
      ]
    },
    {
      "id": "s3_move",
      "kind": "choice",
      "clock": "21:30",
      "escalation": "NBRO Level 2 · Amber",
      "eyebrow": "Evacuation Lead",
      "title": "Amber, and someone in the house needs help to move",
      "role": "evacuation_lead",
      "situation": [
        "Every role you list in `roles` has to hold at least one turn."
      ],
      "prompt": "Who goes, and when?",
      "choices": [
        {
          "id": "a",
          "label": "Anyone who needs help to move goes now. Everyone else: packed and dressed.",
          "verdict": "correct",
          "feedback": "Amber means packed and dressed, and the people who need more time go now.",
          "book": {
            "quote": "Anyone who needs help to move goes NOW, not at Level 3.",
            "source": "When a landslide warning is issued for my area — Level 2 · Amber",
            "page": "right-now/landslide-warning",
            "cites": [
              1
            ]
          },
          "timing": "early",
          "points": 25,
          "effects": [
            {
              "type": "meter",
              "meter": "safety",
              "delta": 5
            }
          ],
          "next": "s4_end"
        },
        {
          "id": "b",
          "label": "Everyone waits and leaves together if it reaches Level 3.",
          "verdict": "wrong",
          "feedback": "Level 3 means leave immediately, which assumes everyone can. The ladder gives the Amber step to the people for whom immediately is not possible.",
          "book": {
            "source": "When a landslide warning is issued for my area — Level 2 · Amber",
            "page": "right-now/landslide-warning",
            "cites": [
              1
            ]
          },
          "timing": "late",
          "points": 0,
          "effects": [
            {
              "type": "meter",
              "meter": "safety",
              "delta": -25
            }
          ],
          "next": "s4_end"
        }
      ]
    },
    {
      "id": "s4_end",
      "kind": "ending",
      "clock": "07:00",
      "eyebrow": "Morning",
      "title": "The rain eases",
      "ending": {
        "outcome": "all_clear",
        "body": [
          "An ending closes the scenario. A quest needs at least one, and every branch has to reach one.",
          "Use `continuesTo` to chain the recovery quest onto the end of this one."
        ]
      }
    }
  ]
}

230 lines · 7.0 KB · Tab indents, Shift+Tab leaves the field

Starts with a skeleton you can edit. Replace it with your own, or paste a quest file from src/content/quests to work from one that already passes.

Passes A new quest — 4 nodes, 2 decisions, best run 92%, worst run 31%.

A published quest is read by every player, so the content rules in section 7 of the game plan apply to it: no outcome may invent a fact the book does not contain, characters and places are fictional, real DS division names appear only as the places a warning names, and the open clinical questions stay out of scored turns.