---
config:
  layout: elk
  theme: base
  themeCSS: ".cluster-label div { background: #fafbfc; }"
  flowchart:
    htmlLabels: true
    useMaxWidth: false
    curve: linear
    nodeSpacing: 30
    rankSpacing: 55
---
flowchart TB
%% Mode persistence, retirement and historical records | Dwarf Fortress 53.16 | checked 2026-09-19
%% Node sources and edge claims: ../SOURCE-INDEX.md and ../systems-data.json
classDef state fill:#edf4fb,stroke:#557795,color:#152b40;
classDef process fill:#eaf5f0,stroke:#46795f,color:#173c29;
classDef control fill:#f0edfb,stroke:#79619b,color:#332552;
classDef report fill:#f0f1f3,stroke:#7a828a,color:#333b43,stroke-dasharray:3 3;
classDef inferred fill:#fff3da,stroke:#ad6900,color:#633d00,stroke-width:2px,stroke-dasharray:6 4;
classDef uncertain fill:#fff0f1,stroke:#b34150,color:#712631,stroke-width:2px,stroke-dasharray:2 4;
  subgraph sg0["Generation"]
    W_ENV["Local environment"]:::state
  end
  subgraph sg1["World state"]
    W_FIG["Persistent historical figures"]:::state
    W_HISTORY["World history"]:::state
  end
  subgraph sg2["Connections to other panels"]
    W_SITE["Sites and ownership"]:::state
  end
  subgraph sg3["Shared world"]
    W_LOCAL("Load and offload local maps"):::process
    W_EMBARK{{"Choose civilization, site and<br/>supplies"}}:::control
    W_FORT["Active player fortress"]:::state
    W_RETIRE{{"Retire fortress"}}:::control
    W_RUIN{{"Abandon fortress to ruin"}}:::control
    W_RETURN{{"Unretire or reclaim fortress"}}:::control
  end
  subgraph sg4["Knowledge and reports"]
    W_RUMOR["Distributed incident<br/>knowledge"]:::state
    W_INFO[/"World map and news reports"/]:::report
    W_LEGENDS[/"Legends and historical<br/>exports"/]:::report
    W_REVEAL{{"Reveal history setting"}}:::control
  end
  subgraph sg5["Cross-system ports"]
    A_ACTION{{"Adventurer actions"}}:::control
    E_GOODS["Goods and materials"]:::state
    J_SKILL["Skills and experience"]:::state
  end
  W_FIG -->|"retains biographies and deeds"| W_HISTORY
  %% edge 1: WA03
  W_LOCAL -->|"preserves tracked identities"| W_FIG
  %% edge 2: WA03
  W_FIG -->|"reinstantiates persistent<br/>people"| W_LOCAL
  %% edge 3: WA03
  W_EMBARK -->|"creates local expedition"| W_FORT
  %% edge 4: WA07
  W_ENV -->|"constrains site choice"| W_EMBARK
  %% edge 5: WA07
  W_EMBARK -->|"allocates initial supplies"| E_GOODS
  %% edge 6: WA07
  W_EMBARK -->|"assigns starting skills"| J_SKILL
  %% edge 7: WA07
  W_FORT -->|"makes citizens persistent"| W_FIG
  %% edge 8: WA03
  W_FORT -->|"records notable achievements"| W_HISTORY
  %% edge 9: WA06
  W_RETIRE -->|"ends direct control"| W_FORT
  %% edge 10: WA08
  W_RETIRE -->|"leaves inhabited settlement"| W_SITE
  %% edge 11: WA08
  W_RUIN -->|"leaves saved ruins"| W_SITE
  %% edge 12: WA08
  W_RETURN -->|"resumes fort or brings new<br/>settlers"| W_FORT
  %% edge 13: WA07, WA08
  A_ACTION -->|"records notable deeds"| W_HISTORY
  %% edge 14: WA06
  A_ACTION -->|"exploration loads local areas"| W_LOCAL
  %% edge 15: WA03
  W_HISTORY -->|"witnessed events become<br/>rumors"| W_RUMOR
  %% edge 16: WA24
  W_RUMOR -->|"displays received news"| W_INFO
  %% edge 17: WA24
  W_HISTORY -->|"provides recorded events"| W_LEGENDS
  %% edge 18: WA06
  W_REVEAL -->|"controls initial report<br/>visibility"| W_LEGENDS
  %% edge 19: WA06
  click W_ENV "https://dwarffortresswiki.org/index.php/Biome" "W_ENV: Biome" _blank
  click W_FIG "https://dwarffortresswiki.org/index.php/Historical_figure" "W_FIG: Historical figure" _blank
  click W_SITE "https://dwarffortresswiki.org/index.php/Civilization" "W_SITE: Civilization" _blank
  click W_HISTORY "https://dwarffortresswiki.org/index.php/World_generation" "W_HISTORY: World generation" _blank
  click W_LOCAL "https://dwarffortresswiki.org/index.php/Historical_figure" "W_LOCAL: Historical figure" _blank
  click W_EMBARK "https://dwarffortresswiki.org/index.php/Embark" "W_EMBARK: Embark" _blank
  click W_FORT "https://dwarffortresswiki.org/index.php/Fortress_mode" "W_FORT: Dwarf fortress mode" _blank
  click W_RETIRE "https://dwarffortresswiki.org/index.php/Fortress_mode" "W_RETIRE: Dwarf fortress mode" _blank
  click W_RUIN "https://dwarffortresswiki.org/index.php/Fortress_mode" "W_RUIN: Dwarf fortress mode" _blank
  click W_RETURN "https://dwarffortresswiki.org/index.php/Embark" "W_RETURN: Embark" _blank
  click W_RUMOR "https://dwarffortresswiki.org/index.php/Rumor" "W_RUMOR: Rumor" _blank
  click W_INFO "https://dwarffortresswiki.org/index.php/Civilization" "W_INFO: Civilization" _blank
  click W_LEGENDS "https://dwarffortresswiki.org/index.php/Legends" "W_LEGENDS: Legends" _blank
  click W_REVEAL "https://dwarffortresswiki.org/index.php/Legends" "W_REVEAL: Legends" _blank
  click A_ACTION "https://dwarffortresswiki.org/index.php/Adventurer_mode" "A_ACTION: Adventurer mode" _blank
  click E_GOODS "https://dwarffortresswiki.org/index.php/Civilization" "E_GOODS: Civilization" _blank
  click J_SKILL "https://dwarffortresswiki.org/index.php/Embark" "J_SKILL: Embark" _blank