91 lines
4.2 KiB
Plaintext
91 lines
4.2 KiB
Plaintext
// Shared declarations for the whole project.
|
|
//
|
|
// This node is never played. Declaring every variable in one place means the
|
|
// compiler catches typos ("$reputaton") instead of silently creating a second
|
|
// variable at runtime.
|
|
//
|
|
// Writing rules the code deliberately does not enforce (Skill Bible §7 / refactor plan §2.1):
|
|
// - Wrong Truth failures carry no failure signal in the prose — the UI banner is the only tell.
|
|
// - Documentary routes are gated on Act and errand state, never on a voice.
|
|
//
|
|
// Modifier Yarn commands (see YarnSkillCommands):
|
|
// <<skill_mod scene facework 2>> — source key "scene" = situational; clear on scene exit
|
|
// <<clear_skill_mods scene>>
|
|
// Other source keys (drunk, injured, …) are state buckets.
|
|
|
|
title: Declarations
|
|
---
|
|
// How much the door staff likes you.
|
|
<<declare $reputation = 0 as number>>
|
|
|
|
// Set when the player has tried the "I'm on the list" line at least once.
|
|
<<declare $claimed_to_be_on_list = false as bool>>
|
|
|
|
// The bouncer's verdict, read by the scene that called him.
|
|
<<declare $went_inside = false as bool>>
|
|
|
|
// Smart variable: derived, not stored. Can never drift out of sync with
|
|
// $reputation, so there's nothing to remember to update.
|
|
<<declare $is_vip = $reputation > 10>>
|
|
|
|
// Written by <<check>> (YarnSkillCommands). Never <<set>> these by hand.
|
|
<<declare $check_result = false as bool>>
|
|
<<declare $check_roll = 0 as number>>
|
|
<<declare $check_total = 0 as number>>
|
|
<<declare $check_dc = 0 as number>>
|
|
<<declare $check_modifier = 0 as number>>
|
|
<<declare $check_degree = "" as string>>
|
|
<<declare $check_skill = "" as string>>
|
|
|
|
// Candidate lean. Three permanently-live readings of who the PC is; they are
|
|
// not mutually exclusive and never resolve. Writers <<set>> these; no code
|
|
// reads them. There is deliberately NO derived "winning candidate" variable —
|
|
// see docs/candidate-system-implementation-plan.md §6.
|
|
<<declare $self_lean_made_asset = 0 as number>>
|
|
<<declare $self_lean_journalist = 0 as number>>
|
|
<<declare $self_lean_inheritor = 0 as number>>
|
|
|
|
// Scene witnessed. Convention: $seen_<scene_id>.
|
|
<<declare $seen_sc_101 = false as bool>>
|
|
|
|
// Clue coverage flags. One per registry clue id ($found_<clue_id>). Writers
|
|
// <<set>> these at the discovery beat alongside the lean write. Lean tracks
|
|
// belief (and can move on a Wrong Truth failure); $found_* tracks coverage.
|
|
// No code reads these.
|
|
<<declare $found_made_asset_object = false as bool>>
|
|
<<declare $found_made_asset_testimony = false as bool>>
|
|
<<declare $found_made_asset_document = false as bool>>
|
|
<<declare $found_made_asset_intuition = false as bool>>
|
|
<<declare $found_journalist_object = false as bool>>
|
|
<<declare $found_journalist_testimony = false as bool>>
|
|
<<declare $found_journalist_document = false as bool>>
|
|
<<declare $found_journalist_intuition = false as bool>>
|
|
<<declare $found_inheritor_object = false as bool>>
|
|
<<declare $found_inheritor_testimony = false as bool>>
|
|
<<declare $found_inheritor_document = false as bool>>
|
|
<<declare $found_inheritor_intuition = false as bool>>
|
|
|
|
// Exploration gating. Clue availability is exploration-gated, never skill-gated.
|
|
// Convention: $visited_<location_id> on first arrival; $errand_<errand_id> when
|
|
// an errand reaches the state that matters. Writers <<set>> these from scene
|
|
// content. unlockFlag fields in candidates.json may only name these families.
|
|
<<declare $visited_desk = false as bool>>
|
|
<<declare $visited_back_office = false as bool>>
|
|
<<declare $visited_archives = false as bool>>
|
|
<<declare $visited_coat_check = false as bool>>
|
|
<<declare $visited_press_room = false as bool>>
|
|
<<declare $visited_private_box = false as bool>>
|
|
<<declare $visited_membership_ledger = false as bool>>
|
|
<<declare $errand_door_list = false as bool>>
|
|
<<declare $errand_find_contact = false as bool>>
|
|
<<declare $errand_ask_about_name = false as bool>>
|
|
|
|
// Player name substitution. Uppercase [PC] in the Skill Bible means the full,
|
|
// formal form (STANDING ORDER, PROVENANCE); lowercase [pc] means the familiar
|
|
// short form (CONFLUENCE, FACEWORK). Two variables, not one — collapsing them
|
|
// loses a characterisation rule the bible states for four separate voices.
|
|
// Defaults are placeholders; naming the PC is design's call.
|
|
<<declare $player_name = "Vesper" as string>>
|
|
<<declare $player_name_full = "Vesper Adaire" as string>>
|
|
===
|