Lab 2: Signal Race

Lab 2 turns a single linear quest into two independently observable routes. It uses an immediate selector, two fact-listening Pause Conditions, two realtime Pause Conditions, a nested Boolean AND, and an XOR-typed convergence without relying on an untested cancellation claim.

Structurally validated: both checkpoints round-trip with WolvenKit 8.19.0. Follow the test guide for timing, parallel waits, re-entry, and reload.

Follow Author Signal Race in WolvenKit to build the graph from the start checkpoint. Use Test both Signal Race routes to keep the canonical and source-edited candidates, saves, and logs separate.

What the lab demonstrates

The canonical project sets cqa002_test_mode to 2 and takes the stable route:

entry -> completed guard -> test_mode = 2 -> activate quest/objectives
  -> immediate selector chooses False
  -> wait 120 realtime seconds -> signal_stop = 1
  -> waiting AND observes signal_stop > 0 AND test_mode == 2
  -> optional objective succeeds -> XOR-shaped convergence
  -> required objective succeeds -> completed = 1 -> quest succeeds

A controlled source edit changes only node 11 from exact value 2 to 1:

entry -> completed guard -> test_mode = 1 -> activate quest/objectives
  -> immediate selector chooses True
  -> wait 30 realtime seconds -> signal_failed = 1
  -> failure listener continues
  -> optional objective fails -> XOR-shaped convergence
  -> required objective succeeds -> completed = 1 -> quest succeeds

Only the selected writer delay starts in either candidate. The other monitor is still a lifecycle obligation, but its reserved fact has no writer in that variant. The lab therefore does not need to claim that XOR cancels a losing timer. Phase-exit cleanup and arbitrary external fact writes remain Experimental.

Prerequisites and downloads

Complete Lab 1 and read:

• Immediate and waiting conditions;
• Boolean condition trees;
• Signal-flow nodes;
• Parallel monitors and cancellation.

Use Cyberpunk 2077 2.31a, WolvenKit 8.19.0, ArchiveXL 1.27.0, RED4ext 1.30.0, and redscript 0.5.31.

• Download the start checkpoint. It has the journal, localization, registration, and a two-node terminating phase.
• Download the completed checkpoint. It has the exact 21-node graph and its review sources.

Do not install the two checkpoints together. They register the same depot paths. Use separate untouched pre-Lab-2 saves for the mode-2 and mode-1 runtime variants; all five tutorial facts and the journal lifecycle are save-backed.

Resource model

The start checkpoint supplies the same journal and localization content as the completed checkpoint. Its questphase has only Input 0, terminating Output 1, and one ordinary edge. This makes it an executable authoring baseline, not an empty folder or a hidden generator input.

Journal and localization contract

quests
└── minor_quest
    └── cqa002                              gameJournalQuest
        └── cqa002_01                       gameJournalQuestPhase
            ├── cqa002_01_obj_wait          required objective
            └── cqa002_01_obj_stable        optional objective

The stable journal objective has optional: 1. The corresponding questphase journal-node payloads retain their normal type.optional: 0; do not copy the journal entry’s optional flag into that unrelated node field. Every typed path uses fileEntryIndex: 2 because cqa002 is the containing gameJournalQuest at path component two.

Exact questphase

The completed graph has 21 nodes and 22 edges. Compare its IDs, socket names, and connections with your WolvenKit graph.

Every supplied node has one job; no node is a magic template. In particular, ID 16 owns a Boolean condition tree, while ID 25 combines graph signals. They use similar logical vocabulary at different resource layers.

Exact edge contract

The three edges from 14.Out are three connections on one ordinary socket. There is no Hub. The two edges into Output 1.In also share one destination socket; socket count is not connection count.

Fact ownership

These names are reserved to Lab 2. Do not use console writes or another mod to drive them during canonical acceptance; doing so changes which producer owns the result.

Common failure modes

Lab sequence: All labs · Next: Author Signal Race in WolvenKit.