# bomsboom12/genworld architecture

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

## Overview

Genworld appears to be a Godot ecosystem simulation game: players manage a species-filled board over game time, with supporting contracts, research, and a species journal. The tree identifies these product areas but provides no README content or source excerpts, so runtime call relationships cannot be verified; edges are omitted rather than inferred. The map emphasizes distinct gameplay stages and domain systems, not assets or development infrastructure.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gameplay["Game flow"]
  node_controller["Main controller<br/>[MainController.gd]"]
  node_clock["Game clock<br/>[GameClock.gd]"]
  node_simulation_manager["Simulation manager"]
end

subgraph group_ecosystem["Ecosystem simulation"]
  node_board["Board state<br/>[CellState.gd]"]
  node_placement["Species placement"]
  node_topology["Grid topology<br/>[GridTopology.gd]"]
  node_ecosystem_init["Ecosystem setup"]
  node_species_sim["Species simulation"]
  node_energy_rules["Energy rules"]
  node_spawn_rules["Spawn rules"]
  node_bacteria["Bacteria system<br/>[BacteriaSystem.gd]"]
  node_death["Cell death"]
  node_budget["Budget calculation"]
  node_events[("Simulation events<br/>[EventRepository.gd]")]
end

subgraph group_progression["Player progression"]
  node_contracts["Contract system"]
  node_contract_data[("Contract data")]
  node_research["Research manager<br/>[ResearchManager.gd]"]
  node_journal[("Species journal")]
  node_journal_conditions["Journal conditions"]
  node_save["Save service<br/>[SaveGameService.gd]"]
end

subgraph group_presentation["Game presentation"]
  node_board_view["Board presentation<br/>[BoardBuilder.gd]"]
  node_board_input["Board input"]
  node_screen["Game screen"]
  node_hud["Game HUD"]
end

node_player(("Player"))

click node_controller "https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/main/MainController.gd"
click node_clock "https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/time/GameClock.gd"
click node_simulation_manager "https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/simulation/simulationManager.gd"
click node_board "https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/board/CellState.gd"
click node_placement "https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/board/SpeciesPlacementService.gd"
click node_topology "https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/grid/GridTopology.gd"
click node_ecosystem_init "https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/simulation/EcosystemInitializer.gd"
click node_species_sim "https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/simulation/SpeciesSimulationSystem.gd"
click node_energy_rules "https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/simulation/SpeciesEnergyRules.gd"
click node_spawn_rules "https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/simulation/EcologicalSpawnRules.gd"
click node_bacteria "https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/simulation/BacteriaSystem.gd"
click node_death "https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/simulation/CellDeathService.gd"
click node_budget "https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/budget/BudgetCalculator.gd"
click node_events "https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/budget/EventRepository.gd"
click node_contracts "https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/contracts/ContractEvaluator.gd"
click node_contract_data "https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/contracts/ContractRepository.gd"
click node_research "https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/research/ResearchManager.gd"
click node_journal "https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/journal/SpeciesJournalRepository.gd"
click node_journal_conditions "https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/journal/JournalConditionEvaluator.gd"
click node_save "https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/services/SaveGameService.gd"
click node_board_view "https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/presentation/board/BoardBuilder.gd"
click node_board_input "https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/presentation/input/BoardInputController.gd"
click node_screen "https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/presentation/ui/GameScreenPresenter.gd"
click node_hud "https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/presentation/ui/GameHudPresenter.gd"

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_controller,node_clock,node_simulation_manager toneBlue
class node_board,node_placement,node_topology,node_ecosystem_init,node_species_sim,node_energy_rules,node_spawn_rules,node_bacteria,node_death,node_budget,node_events toneAmber
class node_contracts,node_contract_data,node_research,node_journal,node_journal_conditions,node_save toneMint
class node_board_view,node_board_input,node_screen,node_hud toneRose
class node_player toneIndigo
```

## Components

### Game flow

- [Main controller](https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/main/MainController.gd): `genworld-0.22(after-ai)/scripts/main/MainController.gd`
- [Game clock](https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/time/GameClock.gd): `genworld-0.22(after-ai)/scripts/domain/time/GameClock.gd`
- [Simulation manager](https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/simulation/simulationManager.gd): `genworld-0.22(after-ai)/scripts/simulation/simulationManager.gd`

### Ecosystem simulation

- [Board state](https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/board/CellState.gd): `genworld-0.22(after-ai)/scripts/domain/board/CellState.gd`
- [Species placement](https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/board/SpeciesPlacementService.gd): `genworld-0.22(after-ai)/scripts/domain/board/SpeciesPlacementService.gd`
- [Grid topology](https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/grid/GridTopology.gd): `genworld-0.22(after-ai)/scripts/domain/grid/GridTopology.gd`
- [Ecosystem setup](https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/simulation/EcosystemInitializer.gd): `genworld-0.22(after-ai)/scripts/domain/simulation/EcosystemInitializer.gd`
- [Species simulation](https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/simulation/SpeciesSimulationSystem.gd): `genworld-0.22(after-ai)/scripts/domain/simulation/SpeciesSimulationSystem.gd`
- [Energy rules](https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/simulation/SpeciesEnergyRules.gd): `genworld-0.22(after-ai)/scripts/domain/simulation/SpeciesEnergyRules.gd`
- [Spawn rules](https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/simulation/EcologicalSpawnRules.gd): `genworld-0.22(after-ai)/scripts/domain/simulation/EcologicalSpawnRules.gd`
- [Bacteria system](https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/simulation/BacteriaSystem.gd): `genworld-0.22(after-ai)/scripts/domain/simulation/BacteriaSystem.gd`
- [Cell death](https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/simulation/CellDeathService.gd): `genworld-0.22(after-ai)/scripts/domain/simulation/CellDeathService.gd`
- [Budget calculation](https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/budget/BudgetCalculator.gd): `genworld-0.22(after-ai)/scripts/domain/budget/BudgetCalculator.gd`
- [Simulation events](https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/budget/EventRepository.gd): `genworld-0.22(after-ai)/scripts/domain/budget/EventRepository.gd`

### Player progression

- [Contract system](https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/contracts/ContractEvaluator.gd): `genworld-0.22(after-ai)/scripts/domain/contracts/ContractEvaluator.gd`
- [Contract data](https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/contracts/ContractRepository.gd): `genworld-0.22(after-ai)/scripts/domain/contracts/ContractRepository.gd`
- [Research manager](https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/research/ResearchManager.gd): `genworld-0.22(after-ai)/scripts/research/ResearchManager.gd`
- [Species journal](https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/journal/SpeciesJournalRepository.gd): `genworld-0.22(after-ai)/scripts/domain/journal/SpeciesJournalRepository.gd`
- [Journal conditions](https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/domain/journal/JournalConditionEvaluator.gd): `genworld-0.22(after-ai)/scripts/domain/journal/JournalConditionEvaluator.gd`
- [Save service](https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/services/SaveGameService.gd): `genworld-0.22(after-ai)/scripts/services/SaveGameService.gd`

### Game presentation

- [Board presentation](https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/presentation/board/BoardBuilder.gd): `genworld-0.22(after-ai)/scripts/presentation/board/BoardBuilder.gd`
- [Board input](https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/presentation/input/BoardInputController.gd): `genworld-0.22(after-ai)/scripts/presentation/input/BoardInputController.gd`
- [Game screen](https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/presentation/ui/GameScreenPresenter.gd): `genworld-0.22(after-ai)/scripts/presentation/ui/GameScreenPresenter.gd`
- [Game HUD](https://github.com/bomsboom12/genworld/blob/main/genworld-0.22(after-ai)/scripts/presentation/ui/GameHudPresenter.gd): `genworld-0.22(after-ai)/scripts/presentation/ui/GameHudPresenter.gd`

### Other components

- **Player**
