# gigores/the-factory-must-grow architecture

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

- Interactive diagram: https://gitdiagram.com/gigores/the-factory-must-grow
- Repository: https://github.com/gigores/the-factory-must-grow

## Overview

TheFactoryMustGrow is a factory-building game centered on exploring and generating a world, collecting resources, crafting and placing production buildings, and expanding an industrial network. The runtime starts in the menu, then runs the game scene with player, inventory, world, entities, and UI state; saves preserve that state. The README highlights realistic metallurgy and chemistry, reflected in the building and recipe systems. Several subsystems are represented by their exact directories because their individual files were not sampled; edges are limited to relationships supported by excerpts, the source index, or documentation.

Main entry points: [`main.py`](https://github.com/gigores/the-factory-must-grow/blob/main/main.py) (Game loop), [`scripts/Scenes/GameScene.py`](https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Scenes/GameScene.py) (Game scene), [`scripts/UI/Components/BaseUIComponents.py`](https://github.com/gigores/the-factory-must-grow/blob/main/scripts/UI/Components/BaseUIComponents.py) (UI components), [`scripts/Managers/SavesManager.py`](https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Managers/SavesManager.py) (Save manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Game runtime"]
  node_game["Game loop<br/>[main.py]"]
  node_menu["Main menu<br/>[MainMenuScene.py]"]
  node_scene["Game scene<br/>[GameScene.py]"]
  node_vector["Vector and rendering helpers<br/>[PgHelp.py]"]
end

subgraph group_world["World and entities"]
  node_player["Player<br/>[Player.py]"]
  node_generator["World generator<br/>[WorldGenerator.py]"]
  node_entitymanager["Entity manager<br/>[EntityManager.py]"]
  node_natural["Natural resources"]
end

subgraph group_production["Factory systems"]
  node_assets["Assets and recipes<br/>[GameAssets.py]"]
  node_items["Item definitions<br/>[ItemClasses.py]"]
  node_buildings["Factory buildings"]
  node_buildingbase["Building behavior<br/>[Building.py]"]
  node_electric["Electric network<br/>[ElectricNode.py]"]
  node_wall["Walls<br/>[Wall.py]"]
  node_entityregistry["Entity registry<br/>[EntityRegistry.py]"]
end

subgraph group_state["Game state"]
  node_inventory["Inventory<br/>[Inventory.py]"]
  node_saves["Save manager<br/>[SavesManager.py]"]
  node_settings["Settings<br/>[SettingsManager.py]"]
  node_achievements["Achievement tracking"]
end

subgraph group_interface["Player interface"]
  node_uis["Building interfaces"]
  node_ui_base["UI components"]
  node_darkui["Dark theme components"]
  node_gameassets["Map and inventory UI<br/>[MapUI.py]"]
  node_terminal["In-game terminal<br/>[Enterpreter.py]"]
end

node_user(("Player"))

node_user -->|"starts game"| node_menu
node_game -->|"runs scene"| node_menu
node_game -->|"runs scene"| node_scene
node_game -->|"loads assets"| node_assets
node_game -->|"creates generator"| node_generator
node_game -->|"creates manager"| node_entitymanager
node_game -->|"creates manager"| node_saves
node_game -->|"creates manager"| node_settings
node_game -->|"creates inventories"| node_inventory
node_game -->|"creates manager"| node_achievements
node_game -->|"creates player"| node_player
node_game -->|"uses helpers"| node_vector
node_scene -->|"imports"| node_wall
node_scene -->|"references"| node_electric
node_scene -->|"uses inventory"| node_inventory
node_scene -->|"uses manager"| node_entitymanager
node_generator -->|"places entities"| node_buildings
node_generator -.->|"generates resources"| node_natural
node_entitymanager -->|"indexes entities"| node_buildingbase
node_entitymanager -->|"groups network nodes"| node_electric
node_buildings -->|"extends behavior"| node_buildingbase
node_buildings -->|"registers classes"| node_entityregistry
node_buildingbase -->|"uses assets"| node_assets
node_buildingbase -->|"uses inventory"| node_inventory
node_assets -->|"loads definitions"| node_items
node_saves -->|"restores state"| node_player
node_saves -->|"restores state"| node_inventory
node_saves -->|"restores state"| node_achievements
node_achievements -->|"renders splash"| node_ui_base
node_uis -->|"uses components"| node_ui_base
node_darkui -->|"extends components"| node_ui_base
node_terminal -->|"uses assets"| node_assets
node_terminal -->|"uses components"| node_ui_base
node_gameassets -.->|"uses components"| node_ui_base

click node_player "https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Entities/Player.py"
click node_game "https://github.com/gigores/the-factory-must-grow/blob/main/main.py"
click node_menu "https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Scenes/MainMenuScene.py"
click node_scene "https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Scenes/GameScene.py"
click node_assets "https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Managers/GameAssets.py"
click node_items "https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Classes/ItemClasses.py"
click node_buildings "https://github.com/gigores/the-factory-must-grow/tree/main/scripts/Entities/Buildings"
click node_buildingbase "https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Entities/ABC/Building.py"
click node_electric "https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Entities/ABC/ElectricNode.py"
click node_wall "https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Entities/ABC/Wall.py"
click node_entityregistry "https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Classes/Registry/EntityRegistry.py"
click node_generator "https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Generators/WorldGenerator.py"
click node_entitymanager "https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Managers/EntityManager.py"
click node_natural "https://github.com/gigores/the-factory-must-grow/tree/main/scripts/Entities/Natural"
click node_inventory "https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Managers/IngameManagers/Inventory.py"
click node_saves "https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Managers/SavesManager.py"
click node_settings "https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Managers/SettingsManager.py"
click node_achievements "https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Managers/IngameManagers/AchievementsVisualsManager.py"
click node_uis "https://github.com/gigores/the-factory-must-grow/tree/main/scripts/UI/Entities"
click node_ui_base "https://github.com/gigores/the-factory-must-grow/blob/main/scripts/UI/Components/BaseUIComponents.py"
click node_darkui "https://github.com/gigores/the-factory-must-grow/blob/main/scripts/UI/Components/DarkThemeComponents.py"
click node_gameassets "https://github.com/gigores/the-factory-must-grow/blob/main/scripts/UI/MapUI.py"
click node_terminal "https://github.com/gigores/the-factory-must-grow/blob/main/scripts/UI/Terminal/Enterpreter.py"
click node_vector "https://github.com/gigores/the-factory-must-grow/blob/main/PgHelp.py"

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_game,node_menu,node_scene,node_vector toneBlue
class node_player,node_generator,node_entitymanager,node_natural toneAmber
class node_assets,node_items,node_buildings,node_buildingbase,node_electric,node_wall,node_entityregistry toneMint
class node_inventory,node_saves,node_settings,node_achievements toneRose
class node_uis,node_ui_base,node_darkui,node_gameassets,node_terminal,node_user toneIndigo
```

## Components

### Game runtime

- [Game loop](https://github.com/gigores/the-factory-must-grow/blob/main/main.py): `main.py`
- [Main menu](https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Scenes/MainMenuScene.py): `scripts/Scenes/MainMenuScene.py`
- [Game scene](https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Scenes/GameScene.py): `scripts/Scenes/GameScene.py`
- [Vector and rendering helpers](https://github.com/gigores/the-factory-must-grow/blob/main/PgHelp.py): `PgHelp.py`

### World and entities

- [Player](https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Entities/Player.py): `scripts/Entities/Player.py`
- [World generator](https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Generators/WorldGenerator.py): `scripts/Generators/WorldGenerator.py`
- [Entity manager](https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Managers/EntityManager.py): `scripts/Managers/EntityManager.py`
- [Natural resources](https://github.com/gigores/the-factory-must-grow/tree/main/scripts/Entities/Natural): `scripts/Entities/Natural`

### Factory systems

- [Assets and recipes](https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Managers/GameAssets.py): `scripts/Managers/GameAssets.py`
- [Item definitions](https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Classes/ItemClasses.py): `scripts/Classes/ItemClasses.py`
- [Factory buildings](https://github.com/gigores/the-factory-must-grow/tree/main/scripts/Entities/Buildings): `scripts/Entities/Buildings`
- [Building behavior](https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Entities/ABC/Building.py): `scripts/Entities/ABC/Building.py`
- [Electric network](https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Entities/ABC/ElectricNode.py): `scripts/Entities/ABC/ElectricNode.py`
- [Walls](https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Entities/ABC/Wall.py): `scripts/Entities/ABC/Wall.py`
- [Entity registry](https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Classes/Registry/EntityRegistry.py): `scripts/Classes/Registry/EntityRegistry.py`

### Game state

- [Inventory](https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Managers/IngameManagers/Inventory.py): `scripts/Managers/IngameManagers/Inventory.py`
- [Save manager](https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Managers/SavesManager.py): `scripts/Managers/SavesManager.py`
- [Settings](https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Managers/SettingsManager.py): `scripts/Managers/SettingsManager.py`
- [Achievement tracking](https://github.com/gigores/the-factory-must-grow/blob/main/scripts/Managers/IngameManagers/AchievementsVisualsManager.py): `scripts/Managers/IngameManagers/AchievementsVisualsManager.py`

### Player interface

- [Building interfaces](https://github.com/gigores/the-factory-must-grow/tree/main/scripts/UI/Entities): `scripts/UI/Entities`
- [UI components](https://github.com/gigores/the-factory-must-grow/blob/main/scripts/UI/Components/BaseUIComponents.py): `scripts/UI/Components/BaseUIComponents.py`
- [Dark theme components](https://github.com/gigores/the-factory-must-grow/blob/main/scripts/UI/Components/DarkThemeComponents.py): `scripts/UI/Components/DarkThemeComponents.py`
- [Map and inventory UI](https://github.com/gigores/the-factory-must-grow/blob/main/scripts/UI/MapUI.py): `scripts/UI/MapUI.py`
- [In-game terminal](https://github.com/gigores/the-factory-must-grow/blob/main/scripts/UI/Terminal/Enterpreter.py): `scripts/UI/Terminal/Enterpreter.py`

### Other components

- **Player**

## Connections

- Player → Main menu: starts game (evidence: `README.md`)
- Game loop → Main menu: runs scene (evidence: `main.py`)
- Game loop → Game scene: runs scene (evidence: `main.py`)
- Game loop → Assets and recipes: loads assets (evidence: `main.py`)
- Game loop → World generator: creates generator (evidence: `main.py`)
- Game loop → Entity manager: creates manager (evidence: `main.py`)
- Game loop → Save manager: creates manager (evidence: `main.py`)
- Game loop → Settings: creates manager (evidence: `main.py`)
- Game loop → Inventory: creates inventories (evidence: `main.py`)
- Game loop → Achievement tracking: creates manager (evidence: `main.py`)
- Game loop → Player: creates player (evidence: `main.py`)
- Game loop → Vector and rendering helpers: uses helpers (evidence: `main.py`)
- Game scene → Walls: imports (evidence: `scripts/Scenes/GameScene.py`)
- Game scene → Electric network: references (evidence: `scripts/Scenes/GameScene.py`)
- Game scene → Inventory: uses inventory (evidence: `main.py`)
- Game scene → Entity manager: uses manager (evidence: `main.py`)
- World generator → Factory buildings: places entities (evidence: `scripts/Generators/WorldGenerator.py`)
- World generator → Natural resources: generates resources
- Entity manager → Building behavior: indexes entities (evidence: `scripts/Managers/EntityManager.py`)
- Entity manager → Electric network: groups network nodes (evidence: `scripts/Managers/EntityManager.py`)
- Factory buildings → Building behavior: extends behavior (evidence: `scripts/Entities/Buildings/Workbench.py`)
- Factory buildings → Entity registry: registers classes (evidence: `scripts/Entities/Buildings/Workbench.py`)
- Building behavior → Assets and recipes: uses assets (evidence: `scripts/Entities/ABC/Building.py`)
- Building behavior → Inventory: uses inventory (evidence: `scripts/Entities/Buildings/Workbench.py`)
- Assets and recipes → Item definitions: loads definitions (evidence: `scripts/Managers/GameAssets.py`)
- Save manager → Player: restores state (evidence: `scripts/Managers/SavesManager.py`)
- Save manager → Inventory: restores state (evidence: `scripts/Managers/SavesManager.py`)
- Save manager → Achievement tracking: restores state (evidence: `scripts/Managers/SavesManager.py`)
- Achievement tracking → UI components: renders splash (evidence: `scripts/Managers/IngameManagers/AchievementsVisualsManager.py`)
- Building interfaces → UI components: uses components (evidence: `scripts/UI/Entities/EngineeringWorkbenchUI.py`)
- Dark theme components → UI components: extends components (evidence: `scripts/UI/Components/DarkThemeComponents.py`)
- In-game terminal → Assets and recipes: uses assets (evidence: `scripts/UI/Terminal/Enterpreter.py`)
- In-game terminal → UI components: uses components (evidence: `scripts/UI/Terminal/__init__.py`)
- Map and inventory UI → UI components: uses components
