# deploychef/they_will_descend architecture

> Architecture diagram of the GitHub repository deploychef/they_will_descend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/deploychef/they_will_descend
- Repository: https://github.com/deploychef/they_will_descend

## Overview

They Will Descend is a Unity city-survival game: the player manages a Maya settlement under a divine end-of-world countdown, balancing logistics, heat, faith, and costly decisions. The README identifies a Unity/DOTS architecture, shell FSM, and ECS write model, with workers, building, time, wood/food, and save/load in the current slice; needs, pressure, and win/lose are planned. Its listed campaign, laws, weather/crises, hope, and discontent are also represented. No runtime source was sampled, so relationships beyond README statements are marked unverified rather than inferred as concrete calls.

Main entry points: [`TheyWillDescend`](https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend) (ECS Write Model), [`Audio_FMOD/they will desend`](https://github.com/deploychef/they_will_descend/tree/main/Audio_FMOD/they%20will%20desend) (FMOD Audio Assets)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Player Experience"]
  node_shell["Game Shell"]
  node_settlement_ui["Settlement Interface"]
  node_camera_scene["Settlement View"]
  node_fmod["FMOD Audio Assets"]
end

subgraph group_simulation["Settlement Simulation"]
  node_ecs["ECS Write Model"]
  node_workers["Workers"]
  node_construction["Construction"]
  node_resources["Wood And Food"]
  node_heat["Heat"]
  node_game_time["Game Time"]
  node_needs["Needs"]
end

subgraph group_pressure["Survival Pressure"]
  node_faith["Faith And Gods"]
  node_tribute["Tribute"]
  node_edicts["Edicts And Laws"]
  node_weather["Weather And Crises"]
  node_morale["Hope And Discontent"]
  node_countdown["End Countdown"]
end

subgraph group_persistence["Campaign State"]
  node_campaign["Campaign"]
  node_outcomes["Win And Lose"]
  node_save_load["Save And Load"]
end

node_player(("Player"))

node_player -->|"manages settlement"| node_settlement_ui
node_settlement_ui -.->|"uses game shell"| node_shell
node_shell -.->|"runs simulation"| node_ecs
node_ecs -.->|"simulates"| node_workers
node_ecs -.->|"simulates"| node_construction
node_ecs -.->|"tracks"| node_resources
node_ecs -.->|"tracks"| node_heat
node_ecs -.->|"advances"| node_game_time
node_ecs -.->|"simulates"| node_needs
node_game_time -.->|"advances"| node_countdown
node_player -->|"chooses edicts"| node_edicts
node_player -->|"offers tribute"| node_tribute
node_tribute -->|"buys time"| node_countdown
node_edicts -->|"incurs costs"| node_resources
node_weather -.->|"affects settlement"| node_ecs
node_morale -.->|"reflects pressure"| node_ecs
node_campaign -.->|"structures play"| node_shell
node_ecs -.->|"determines outcome"| node_outcomes
node_save_load -.->|"persists state"| node_ecs
node_camera_scene -.->|"presents settlement"| node_settlement_ui
node_fmod -.->|"provides audio"| node_shell

click node_shell "https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend"
click node_settlement_ui "https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend"
click node_camera_scene "https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend"
click node_ecs "https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend"
click node_workers "https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend"
click node_construction "https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend"
click node_resources "https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend"
click node_heat "https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend"
click node_game_time "https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend"
click node_needs "https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend"
click node_faith "https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend"
click node_tribute "https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend"
click node_edicts "https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend"
click node_weather "https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend"
click node_morale "https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend"
click node_countdown "https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend"
click node_campaign "https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend"
click node_outcomes "https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend"
click node_save_load "https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend"
click node_fmod "https://github.com/deploychef/they_will_descend/tree/main/Audio_FMOD/they%20will%20desend"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_shell,node_settlement_ui,node_camera_scene,node_fmod toneBlue
class node_ecs,node_workers,node_construction,node_resources,node_heat,node_game_time,node_needs toneAmber
class node_faith,node_tribute,node_edicts,node_weather,node_morale,node_countdown toneMint
class node_campaign,node_outcomes,node_save_load toneRose
class node_player toneIndigo
```

## Components

### Player Experience

- [Game Shell](https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend): `TheyWillDescend`
- [Settlement Interface](https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend): `TheyWillDescend`
- [Settlement View](https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend): `TheyWillDescend`
- [FMOD Audio Assets](https://github.com/deploychef/they_will_descend/tree/main/Audio_FMOD/they%20will%20desend): `Audio_FMOD/they will desend`

### Settlement Simulation

- [ECS Write Model](https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend): `TheyWillDescend`
- [Workers](https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend): `TheyWillDescend`
- [Construction](https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend): `TheyWillDescend`
- [Wood And Food](https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend): `TheyWillDescend`
- [Heat](https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend): `TheyWillDescend`
- [Game Time](https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend): `TheyWillDescend`
- [Needs](https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend): `TheyWillDescend`

### Survival Pressure

- [Faith And Gods](https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend): `TheyWillDescend`
- [Tribute](https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend): `TheyWillDescend`
- [Edicts And Laws](https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend): `TheyWillDescend`
- [Weather And Crises](https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend): `TheyWillDescend`
- [Hope And Discontent](https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend): `TheyWillDescend`
- [End Countdown](https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend): `TheyWillDescend`

### Campaign State

- [Campaign](https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend): `TheyWillDescend`
- [Win And Lose](https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend): `TheyWillDescend`
- [Save And Load](https://github.com/deploychef/they_will_descend/tree/main/TheyWillDescend): `TheyWillDescend`

### Other components

- **Player**

## Connections

- Player → Settlement Interface: manages settlement (evidence: `README.md`)
- Settlement Interface → Game Shell: uses game shell
- Game Shell → ECS Write Model: runs simulation
- ECS Write Model → Workers: simulates
- ECS Write Model → Construction: simulates
- ECS Write Model → Wood And Food: tracks
- ECS Write Model → Heat: tracks
- ECS Write Model → Game Time: advances
- ECS Write Model → Needs: simulates
- Game Time → End Countdown: advances
- Player → Edicts And Laws: chooses edicts (evidence: `README.md`)
- Player → Tribute: offers tribute (evidence: `README.md`)
- Tribute → End Countdown: buys time (evidence: `README.md`)
- Edicts And Laws → Wood And Food: incurs costs (evidence: `README.md`)
- Weather And Crises → ECS Write Model: affects settlement
- Hope And Discontent → ECS Write Model: reflects pressure
- Campaign → Game Shell: structures play
- ECS Write Model → Win And Lose: determines outcome
- Save And Load → ECS Write Model: persists state
- Settlement View → Settlement Interface: presents settlement
- FMOD Audio Assets → Game Shell: provides audio
