# saaayurii/ashes-of-eden architecture

> Architecture diagram of the GitHub repository saaayurii/ashes-of-eden, 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/saaayurii/ashes-of-eden
- Repository: https://github.com/saaayurii/ashes-of-eden

## Overview

Ashes of Eden is a Godot 2D action roguelite. The player starts from the main menu, begins a story run, fights through rooms, chooses gifts and dialogue responses, and reaches an ending shaped by remembered choices. The README also documents co-op and duel modes, persistent bestiary progress, multilingual story content, and data-driven modding. The map follows those documented capabilities; runtime source excerpts were not provided, so connections are based on README statements rather than inspected call sites.

Main entry points: [`scenes/ui`](https://github.com/saaayurii/ashes-of-eden/tree/main/scenes/ui) (Main menu), [`scenes/rooms`](https://github.com/saaayurii/ashes-of-eden/tree/main/scenes/rooms) (Rooms and areas), [`scripts/combat`](https://github.com/saaayurii/ashes-of-eden/tree/main/scripts/combat) (Combat), [`data/items`](https://github.com/saaayurii/ashes-of-eden/tree/main/data/items) (Gifts and relics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_play["Play flow"]
  node_menu["Main menu"]
  node_run["Story run"]
  node_rooms["Rooms and areas"]
  node_co_op["Online co-op"]
  node_duel["One-on-one duel"]
end

subgraph group_world["World and story"]
  node_dialogue["Dialogue choices"]
  node_story_state["Story counters"]
  node_endings["Chapter endings"]
  node_npcs["NPCs and world"]
end

subgraph group_systems["Game systems"]
  node_combat["Combat"]
  node_player_char["Player movement"]
  node_enemies["Enemies"]
  node_gifts["Gifts and relics"]
  node_resonances["Resonances"]
  node_bestiary["Persistent bestiary"]
end

subgraph group_content["Content and presentation"]
  node_game_content["Data-driven content"]
  node_localization["Four languages"]
  node_audio["Music and voice"]
end

node_player(("Player"))

node_player -->|"opens"| node_menu
node_menu -->|"starts story"| node_run
node_run -->|"enters rooms"| node_rooms
node_player -->|"controls"| node_player_char
node_rooms -->|"triggers fights"| node_combat
node_combat -->|"fights"| node_enemies
node_rooms -->|"meets"| node_npcs
node_player -->|"chooses"| node_gifts
node_gifts -->|"shifts counters"| node_story_state
node_player -->|"answers"| node_dialogue
node_dialogue -->|"shifts counters"| node_story_state
node_story_state -->|"shapes ending"| node_endings
node_menu -->|"starts co-op"| node_co_op
node_menu -->|"starts duel"| node_duel
node_combat -->|"records encounters"| node_bestiary
node_player -->|"plays content"| node_game_content
node_player -->|"reads language"| node_localization
node_player -->|"hears audio"| node_audio
node_gifts -.->|"supports builds"| node_resonances

click node_menu "https://github.com/saaayurii/ashes-of-eden/tree/main/scenes/ui"
click node_run "https://github.com/saaayurii/ashes-of-eden/tree/main/scripts/run"
click node_rooms "https://github.com/saaayurii/ashes-of-eden/tree/main/scenes/rooms"
click node_combat "https://github.com/saaayurii/ashes-of-eden/tree/main/scripts/combat"
click node_player_char "https://github.com/saaayurii/ashes-of-eden/tree/main/scripts/player"
click node_enemies "https://github.com/saaayurii/ashes-of-eden/tree/main/scripts/enemies"
click node_gifts "https://github.com/saaayurii/ashes-of-eden/tree/main/data/items"
click node_resonances "https://github.com/saaayurii/ashes-of-eden/tree/main/data/resonances"
click node_dialogue "https://github.com/saaayurii/ashes-of-eden/tree/main/data/dialogues"
click node_story_state "https://github.com/saaayurii/ashes-of-eden/tree/main/scripts/meta"
click node_endings "https://github.com/saaayurii/ashes-of-eden/tree/main/data/chapters"
click node_npcs "https://github.com/saaayurii/ashes-of-eden/tree/main/data/npcs"
click node_co_op "https://github.com/saaayurii/ashes-of-eden/tree/main/scripts/pvp"
click node_duel "https://github.com/saaayurii/ashes-of-eden/tree/main/scenes/pvp"
click node_bestiary "https://github.com/saaayurii/ashes-of-eden/tree/main/scripts/meta"
click node_game_content "https://github.com/saaayurii/ashes-of-eden/tree/main/data"
click node_localization "https://github.com/saaayurii/ashes-of-eden/tree/main/localization"
click node_audio "https://github.com/saaayurii/ashes-of-eden/tree/main/assets/audio"

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_menu,node_run,node_rooms,node_co_op,node_duel toneBlue
class node_dialogue,node_story_state,node_endings,node_npcs toneAmber
class node_combat,node_player_char,node_enemies,node_gifts,node_resonances,node_bestiary toneMint
class node_game_content,node_localization,node_audio toneRose
class node_player toneIndigo
```

## Components

### Play flow

- [Main menu](https://github.com/saaayurii/ashes-of-eden/tree/main/scenes/ui): `scenes/ui`
- [Story run](https://github.com/saaayurii/ashes-of-eden/tree/main/scripts/run): `scripts/run`
- [Rooms and areas](https://github.com/saaayurii/ashes-of-eden/tree/main/scenes/rooms): `scenes/rooms`
- [Online co-op](https://github.com/saaayurii/ashes-of-eden/tree/main/scripts/pvp): `scripts/pvp`
- [One-on-one duel](https://github.com/saaayurii/ashes-of-eden/tree/main/scenes/pvp): `scenes/pvp`

### World and story

- [Dialogue choices](https://github.com/saaayurii/ashes-of-eden/tree/main/data/dialogues): `data/dialogues`
- [Story counters](https://github.com/saaayurii/ashes-of-eden/tree/main/scripts/meta): `scripts/meta`
- [Chapter endings](https://github.com/saaayurii/ashes-of-eden/tree/main/data/chapters): `data/chapters`
- [NPCs and world](https://github.com/saaayurii/ashes-of-eden/tree/main/data/npcs): `data/npcs`

### Game systems

- [Combat](https://github.com/saaayurii/ashes-of-eden/tree/main/scripts/combat): `scripts/combat`
- [Player movement](https://github.com/saaayurii/ashes-of-eden/tree/main/scripts/player): `scripts/player`
- [Enemies](https://github.com/saaayurii/ashes-of-eden/tree/main/scripts/enemies): `scripts/enemies`
- [Gifts and relics](https://github.com/saaayurii/ashes-of-eden/tree/main/data/items): `data/items`
- [Resonances](https://github.com/saaayurii/ashes-of-eden/tree/main/data/resonances): `data/resonances`
- [Persistent bestiary](https://github.com/saaayurii/ashes-of-eden/tree/main/scripts/meta): `scripts/meta`

### Content and presentation

- [Data-driven content](https://github.com/saaayurii/ashes-of-eden/tree/main/data): `data`
- [Four languages](https://github.com/saaayurii/ashes-of-eden/tree/main/localization): `localization`
- [Music and voice](https://github.com/saaayurii/ashes-of-eden/tree/main/assets/audio): `assets/audio`

### Other components

- **Player**

## Connections

- Player → Main menu: opens (evidence: `README.md`)
- Main menu → Story run: starts story (evidence: `README.md`)
- Story run → Rooms and areas: enters rooms (evidence: `README.md`)
- Player → Player movement: controls (evidence: `README.md`)
- Rooms and areas → Combat: triggers fights (evidence: `README.md`)
- Combat → Enemies: fights (evidence: `README.md`)
- Rooms and areas → NPCs and world: meets (evidence: `README.md`)
- Player → Gifts and relics: chooses (evidence: `README.md`)
- Gifts and relics → Story counters: shifts counters (evidence: `README.md`)
- Player → Dialogue choices: answers (evidence: `README.md`)
- Dialogue choices → Story counters: shifts counters (evidence: `README.md`)
- Story counters → Chapter endings: shapes ending (evidence: `README.md`)
- Main menu → Online co-op: starts co-op (evidence: `README.md`)
- Main menu → One-on-one duel: starts duel (evidence: `README.md`)
- Combat → Persistent bestiary: records encounters (evidence: `README.md`)
- Player → Data-driven content: plays content (evidence: `README.md`)
- Player → Four languages: reads language (evidence: `README.md`)
- Player → Music and voice: hears audio (evidence: `README.md`)
- Gifts and relics → Resonances: supports builds
