# benjamarquezvargas09-art/spatium-iv-play architecture

> Architecture diagram of the GitHub repository benjamarquezvargas09-art/spatium-iv-play, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/benjamarquezvargas09-art/spatium-iv-play
- Repository: https://github.com/benjamarquezvargas09-art/spatium-iv-play

## Overview

SPATIUM IV is a Godot lunar-colony mission-training game for children. Players follow a guided campaign, explore and scan the Moon, collect resources, and make interdependent colony decisions about power, food, research, radiation protection, and returning home. The README documents these capabilities and trade-offs, but the supplied tree exposes no individual game scripts, so gameplay nodes use exact enclosing directories and implementation-level links are omitted. Terrain3D is a bundled terrain subsystem; its native implementation is not present in the sampled excerpts.

Main entry points: [`game/addons/terrain_3d/csharp/Terrain3D.cs`](https://github.com/benjamarquezvargas09-art/spatium-iv-play/blob/main/game/addons/terrain_3d/csharp/Terrain3D.cs) (Terrain Engine), [`game/entities/player`](https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/entities/player) (Player Character), [`game/ui/hud`](https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/ui/hud) (Mission Interface), [`game/systems/resources`](https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/systems/resources) (Resource Gathering)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_play["Player Experience"]
  node_menus["Game Menus"]
  node_missionui["Mission Interface"]
  node_campaign["Mission Campaign"]
end

subgraph group_world["Moon Exploration"]
  node_player_entity["Player Character"]
  node_scanner["Scanner System"]
  node_resources["Resource Gathering"]
  node_inventory["Inventory"]
end

subgraph group_colony["Colony Simulation"]
  node_power["Power Budget"]
  node_building["Base Building"]
  node_colony_system["Colony Systems"]
  node_survival["Survival Systems"]
  node_radiation["Radiation Hazards"]
  node_events["Random Events"]
  node_science["Science Research"]
  node_water_fuel["Water And Fuel"]
end

subgraph group_terrain["Terrain Rendering"]
  node_terrain_engine["Terrain Engine<br/>[Terrain3D.cs]"]
  node_terrain_data[("Terrain Regions<br/>[Terrain3DData.cs]")]
  node_terrain_assets[("Terrain Assets<br/>[Terrain3DAssets.cs]")]
  node_terrain_material["Terrain Material"]
  node_terrain_collision["Terrain Collision"]
  node_terrain_instancer["Terrain Instancer"]
  node_terrain_editor["Terrain Editor<br/>[Terrain3DEditor.cs]"]
end

node_player(("Young Astronaut"))

node_player -->|"starts game"| node_menus
node_player -->|"controls"| node_player_entity
node_player -->|"follows guidance"| node_missionui
node_missionui -->|"presents missions"| node_campaign
node_player_entity -->|"scans rocks"| node_scanner
node_player_entity -->|"collects resources"| node_resources
node_resources -.->|"stores items"| node_inventory
node_terrain_engine -->|"uses regions"| node_terrain_data
node_terrain_engine -->|"uses assets"| node_terrain_assets
node_terrain_engine -->|"uses material"| node_terrain_material
node_terrain_engine -->|"uses collision"| node_terrain_collision
node_terrain_engine -->|"uses instancer"| node_terrain_instancer
node_terrain_engine -->|"exposes editor"| node_terrain_editor
node_player -->|"allocates power"| node_power
node_player -->|"builds base"| node_building
node_player -->|"manages colony"| node_colony_system
node_colony_system -.->|"supports survival"| node_survival
node_player -->|"chooses shielding"| node_radiation
node_events -->|"triggers storms"| node_radiation
node_player -->|"pursues research"| node_science
node_player -->|"makes propellant"| node_water_fuel
node_power -->|"powers systems"| node_survival
node_player -->|"responds to events"| node_events

click node_menus "https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/ui/menus"
click node_missionui "https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/ui/hud"
click node_campaign "https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/data/missions"
click node_player_entity "https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/entities/player"
click node_scanner "https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/systems/scanner"
click node_resources "https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/systems/resources"
click node_inventory "https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/systems/inventory"
click node_terrain_engine "https://github.com/benjamarquezvargas09-art/spatium-iv-play/blob/main/game/addons/terrain_3d/csharp/Terrain3D.cs"
click node_terrain_data "https://github.com/benjamarquezvargas09-art/spatium-iv-play/blob/main/game/addons/terrain_3d/csharp/Terrain3DData.cs"
click node_terrain_assets "https://github.com/benjamarquezvargas09-art/spatium-iv-play/blob/main/game/addons/terrain_3d/csharp/Terrain3DAssets.cs"
click node_terrain_material "https://github.com/benjamarquezvargas09-art/spatium-iv-play/blob/main/game/addons/terrain_3d/csharp/Terrain3DMaterial.cs"
click node_terrain_collision "https://github.com/benjamarquezvargas09-art/spatium-iv-play/blob/main/game/addons/terrain_3d/csharp/Terrain3DCollision.cs"
click node_terrain_instancer "https://github.com/benjamarquezvargas09-art/spatium-iv-play/blob/main/game/addons/terrain_3d/csharp/Terrain3DInstancer.cs"
click node_terrain_editor "https://github.com/benjamarquezvargas09-art/spatium-iv-play/blob/main/game/addons/terrain_3d/csharp/Terrain3DEditor.cs"
click node_power "https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/systems/base"
click node_building "https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/systems/building"
click node_colony_system "https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/systems/colony"
click node_survival "https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/systems/survival"
click node_radiation "https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/systems/radiation"
click node_events "https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/systems/events"
click node_science "https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/data/science"
click node_water_fuel "https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/systems/colony"

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_menus,node_missionui,node_campaign toneBlue
class node_player_entity,node_scanner,node_resources,node_inventory toneAmber
class node_power,node_building,node_colony_system,node_survival,node_radiation,node_events,node_science,node_water_fuel toneMint
class node_terrain_engine,node_terrain_data,node_terrain_assets,node_terrain_material,node_terrain_collision,node_terrain_instancer,node_terrain_editor toneRose
class node_player toneIndigo
```

## Components

### Player Experience

- [Game Menus](https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/ui/menus): `game/ui/menus`
- [Mission Interface](https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/ui/hud): `game/ui/hud`
- [Mission Campaign](https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/data/missions): `game/data/missions`

### Moon Exploration

- [Player Character](https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/entities/player): `game/entities/player`
- [Scanner System](https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/systems/scanner): `game/systems/scanner`
- [Resource Gathering](https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/systems/resources): `game/systems/resources`
- [Inventory](https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/systems/inventory): `game/systems/inventory`

### Colony Simulation

- [Power Budget](https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/systems/base): `game/systems/base`
- [Base Building](https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/systems/building): `game/systems/building`
- [Colony Systems](https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/systems/colony): `game/systems/colony`
- [Survival Systems](https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/systems/survival): `game/systems/survival`
- [Radiation Hazards](https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/systems/radiation): `game/systems/radiation`
- [Random Events](https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/systems/events): `game/systems/events`
- [Science Research](https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/data/science): `game/data/science`
- [Water And Fuel](https://github.com/benjamarquezvargas09-art/spatium-iv-play/tree/main/game/systems/colony): `game/systems/colony`

### Terrain Rendering

- [Terrain Engine](https://github.com/benjamarquezvargas09-art/spatium-iv-play/blob/main/game/addons/terrain_3d/csharp/Terrain3D.cs): `game/addons/terrain_3d/csharp/Terrain3D.cs`
- [Terrain Regions](https://github.com/benjamarquezvargas09-art/spatium-iv-play/blob/main/game/addons/terrain_3d/csharp/Terrain3DData.cs): `game/addons/terrain_3d/csharp/Terrain3DData.cs`
- [Terrain Assets](https://github.com/benjamarquezvargas09-art/spatium-iv-play/blob/main/game/addons/terrain_3d/csharp/Terrain3DAssets.cs): `game/addons/terrain_3d/csharp/Terrain3DAssets.cs`
- [Terrain Material](https://github.com/benjamarquezvargas09-art/spatium-iv-play/blob/main/game/addons/terrain_3d/csharp/Terrain3DMaterial.cs): `game/addons/terrain_3d/csharp/Terrain3DMaterial.cs`
- [Terrain Collision](https://github.com/benjamarquezvargas09-art/spatium-iv-play/blob/main/game/addons/terrain_3d/csharp/Terrain3DCollision.cs): `game/addons/terrain_3d/csharp/Terrain3DCollision.cs`
- [Terrain Instancer](https://github.com/benjamarquezvargas09-art/spatium-iv-play/blob/main/game/addons/terrain_3d/csharp/Terrain3DInstancer.cs): `game/addons/terrain_3d/csharp/Terrain3DInstancer.cs`
- [Terrain Editor](https://github.com/benjamarquezvargas09-art/spatium-iv-play/blob/main/game/addons/terrain_3d/csharp/Terrain3DEditor.cs): `game/addons/terrain_3d/csharp/Terrain3DEditor.cs`

### Other components

- **Young Astronaut**

## Connections

- Young Astronaut → Game Menus: starts game (evidence: `README.md`)
- Young Astronaut → Player Character: controls (evidence: `README.md`)
- Young Astronaut → Mission Interface: follows guidance (evidence: `README.md`)
- Mission Interface → Mission Campaign: presents missions (evidence: `README.md`)
- Player Character → Scanner System: scans rocks (evidence: `README.md`)
- Player Character → Resource Gathering: collects resources (evidence: `README.md`)
- Resource Gathering → Inventory: stores items
- Terrain Engine → Terrain Regions: uses regions (evidence: `game/addons/terrain_3d/csharp/Terrain3D.cs`)
- Terrain Engine → Terrain Assets: uses assets (evidence: `game/addons/terrain_3d/csharp/Terrain3D.cs`)
- Terrain Engine → Terrain Material: uses material (evidence: `game/addons/terrain_3d/csharp/Terrain3D.cs`)
- Terrain Engine → Terrain Collision: uses collision (evidence: `game/addons/terrain_3d/csharp/Terrain3D.cs`)
- Terrain Engine → Terrain Instancer: uses instancer (evidence: `game/addons/terrain_3d/csharp/Terrain3D.cs`)
- Terrain Engine → Terrain Editor: exposes editor (evidence: `game/addons/terrain_3d/csharp/Terrain3D.cs`)
- Young Astronaut → Power Budget: allocates power (evidence: `README.md`)
- Young Astronaut → Base Building: builds base (evidence: `README.md`)
- Young Astronaut → Colony Systems: manages colony (evidence: `README.md`)
- Colony Systems → Survival Systems: supports survival
- Young Astronaut → Radiation Hazards: chooses shielding (evidence: `README.md`)
- Random Events → Radiation Hazards: triggers storms (evidence: `README.md`)
- Young Astronaut → Science Research: pursues research (evidence: `README.md`)
- Young Astronaut → Water And Fuel: makes propellant (evidence: `README.md`)
- Power Budget → Survival Systems: powers systems (evidence: `README.md`)
- Young Astronaut → Random Events: responds to events (evidence: `README.md`)
