# achille010/gemz architecture

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

- Interactive diagram: https://gitdiagram.com/achille010/gemz
- Repository: https://github.com/achille010/gemz

## Overview

This repository bundles five playable games rather than one shared application: Cursor Dash, Drone Sim, Hyper Flight 3D, Strike Team, and Vault Runner. Their main loop is play-specific; Strike Team additionally has a documented launcher-to-Godot mission flow and paired controller pads. Hyper Flight combines flight gameplay, rendering, input, and HUD; Vault Runner includes procedural textures. Several game implementations are monolithic or unsampled, so their internal links are intentionally limited to relationships shown in excerpts or the source index.

Main entry points: [`hyper_flight_3d/hyper_flight_3d.py`](https://github.com/achille010/gemz/blob/main/hyper_flight_3d/hyper_flight_3d.py) (Flight app), [`strike_team/launcher.py`](https://github.com/achille010/gemz/blob/main/strike_team/launcher.py) (Game launcher), [`hyper_flight_3d/main.py`](https://github.com/achille010/gemz/blob/main/hyper_flight_3d/main.py) (Game launcher), [`hyper_flight_3d/engine3d.py`](https://github.com/achille010/gemz/blob/main/hyper_flight_3d/engine3d.py) (3D renderer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cursor["Cursor Dash"]
  node_cursor_game["Cursor game<br/>[cursor_dash.py]"]
end

subgraph group_drone["Drone Sim"]
  node_drone_game["Drone simulator<br/>[drone_sim.py]"]
end

subgraph group_flight["Hyper Flight"]
  node_flight_entry["Game launcher<br/>[main.py]"]
  node_flight_app["Flight app<br/>[hyper_flight_3d.py]"]
  node_flight_input["Flight controls<br/>[controller.py]"]
  node_flight_gameplay["Flight gameplay<br/>[gameplay.py]"]
  node_flight_renderer["3D renderer<br/>[engine3d.py]"]
  node_flight_models["OBJ models<br/>[obj_loader.py]"]
  node_flight_hud["Flight HUD<br/>[hud2d.py]"]
  node_flight_audio["Audio synth<br/>[audio_synth.py]"]
end

subgraph group_strike["Strike Team"]
  node_strike_launcher["Game launcher<br/>[launcher.py]"]
  node_strike_pads["Pad readers<br/>[pads.py]"]
  node_strike_missions["Mission generator<br/>[missions.py]"]
  node_strike_sfx["Sound generator<br/>[sfxgen.py]"]
  node_godot_game["3D battle"]
end

subgraph group_vault["Vault Runner"]
  node_vault_game["Stealth heist<br/>[vault_runner.py]"]
  node_vault_textures["Procedural textures<br/>[textures.py]"]
end

node_player(("Player"))
node_flight_user(("Player"))
node_strike_user(("Player"))
node_vault_user(("Player"))

node_player -.->|"plays"| node_cursor_game
node_player -.->|"plays"| node_drone_game
node_flight_user -.->|"launches"| node_flight_entry
node_flight_entry -->|"starts"| node_flight_app
node_flight_app -.->|"creates"| node_flight_input
node_flight_app -->|"creates"| node_flight_gameplay
node_flight_app -->|"creates"| node_flight_renderer
node_flight_app -->|"creates"| node_flight_hud
node_flight_app -.->|"creates"| node_flight_audio
node_flight_renderer -->|"loads models"| node_flight_models
node_strike_user -.->|"uses"| node_strike_launcher
node_strike_launcher -->|"reads pads"| node_strike_pads
node_strike_launcher -->|"generates missions"| node_strike_missions
node_strike_launcher -->|"uses sounds"| node_strike_sfx
node_strike_launcher -->|"starts battle"| node_godot_game
node_strike_launcher -->|"streams pad input"| node_godot_game
node_vault_user -.->|"plays"| node_vault_game
node_vault_game -->|"generates textures"| node_vault_textures

click node_cursor_game "https://github.com/achille010/gemz/blob/main/cursor_dash/cursor_dash.py"
click node_drone_game "https://github.com/achille010/gemz/blob/main/drone_sim/drone_sim.py"
click node_flight_entry "https://github.com/achille010/gemz/blob/main/hyper_flight_3d/main.py"
click node_flight_app "https://github.com/achille010/gemz/blob/main/hyper_flight_3d/hyper_flight_3d.py"
click node_flight_input "https://github.com/achille010/gemz/blob/main/hyper_flight_3d/controller.py"
click node_flight_gameplay "https://github.com/achille010/gemz/blob/main/hyper_flight_3d/gameplay.py"
click node_flight_renderer "https://github.com/achille010/gemz/blob/main/hyper_flight_3d/engine3d.py"
click node_flight_models "https://github.com/achille010/gemz/blob/main/hyper_flight_3d/obj_loader.py"
click node_flight_hud "https://github.com/achille010/gemz/blob/main/hyper_flight_3d/hud2d.py"
click node_flight_audio "https://github.com/achille010/gemz/blob/main/hyper_flight_3d/audio_synth.py"
click node_strike_launcher "https://github.com/achille010/gemz/blob/main/strike_team/launcher.py"
click node_strike_pads "https://github.com/achille010/gemz/blob/main/strike_team/pads.py"
click node_strike_missions "https://github.com/achille010/gemz/blob/main/strike_team/missions.py"
click node_strike_sfx "https://github.com/achille010/gemz/blob/main/strike_team/sfxgen.py"
click node_godot_game "https://github.com/achille010/gemz/tree/main/strike_team/godot/scripts"
click node_vault_game "https://github.com/achille010/gemz/blob/main/vault_runner/vault_runner.py"
click node_vault_textures "https://github.com/achille010/gemz/blob/main/vault_runner/textures.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_cursor_game toneBlue
class node_drone_game toneAmber
class node_flight_entry,node_flight_app,node_flight_input,node_flight_gameplay,node_flight_renderer,node_flight_models,node_flight_hud,node_flight_audio toneMint
class node_strike_launcher,node_strike_pads,node_strike_missions,node_strike_sfx,node_godot_game toneRose
class node_vault_game,node_vault_textures,node_player,node_flight_user,node_strike_user,node_vault_user toneIndigo
```

## Components

### Cursor Dash

- [Cursor game](https://github.com/achille010/gemz/blob/main/cursor_dash/cursor_dash.py): `cursor_dash/cursor_dash.py`

### Drone Sim

- [Drone simulator](https://github.com/achille010/gemz/blob/main/drone_sim/drone_sim.py): `drone_sim/drone_sim.py`

### Hyper Flight

- [Game launcher](https://github.com/achille010/gemz/blob/main/hyper_flight_3d/main.py): `hyper_flight_3d/main.py`
- [Flight app](https://github.com/achille010/gemz/blob/main/hyper_flight_3d/hyper_flight_3d.py): `hyper_flight_3d/hyper_flight_3d.py`
- [Flight controls](https://github.com/achille010/gemz/blob/main/hyper_flight_3d/controller.py): `hyper_flight_3d/controller.py`
- [Flight gameplay](https://github.com/achille010/gemz/blob/main/hyper_flight_3d/gameplay.py): `hyper_flight_3d/gameplay.py`
- [3D renderer](https://github.com/achille010/gemz/blob/main/hyper_flight_3d/engine3d.py): `hyper_flight_3d/engine3d.py`
- [OBJ models](https://github.com/achille010/gemz/blob/main/hyper_flight_3d/obj_loader.py): `hyper_flight_3d/obj_loader.py`
- [Flight HUD](https://github.com/achille010/gemz/blob/main/hyper_flight_3d/hud2d.py): `hyper_flight_3d/hud2d.py`
- [Audio synth](https://github.com/achille010/gemz/blob/main/hyper_flight_3d/audio_synth.py): `hyper_flight_3d/audio_synth.py`

### Strike Team

- [Game launcher](https://github.com/achille010/gemz/blob/main/strike_team/launcher.py): `strike_team/launcher.py`
- [Pad readers](https://github.com/achille010/gemz/blob/main/strike_team/pads.py): `strike_team/pads.py`
- [Mission generator](https://github.com/achille010/gemz/blob/main/strike_team/missions.py): `strike_team/missions.py`
- [Sound generator](https://github.com/achille010/gemz/blob/main/strike_team/sfxgen.py): `strike_team/sfxgen.py`
- [3D battle](https://github.com/achille010/gemz/tree/main/strike_team/godot/scripts): `strike_team/godot/scripts`

### Vault Runner

- [Stealth heist](https://github.com/achille010/gemz/blob/main/vault_runner/vault_runner.py): `vault_runner/vault_runner.py`
- [Procedural textures](https://github.com/achille010/gemz/blob/main/vault_runner/textures.py): `vault_runner/textures.py`

### Other components

- **Player**
- **Player**
- **Player**
- **Player**

## Connections

- Player → Cursor game: plays
- Player → Drone simulator: plays
- Player → Game launcher: launches
- Game launcher → Flight app: starts (evidence: `hyper_flight_3d/main.py`)
- Flight app → Flight controls: creates
- Flight app → Flight gameplay: creates (evidence: `hyper_flight_3d/hyper_flight_3d.py`)
- Flight app → 3D renderer: creates (evidence: `hyper_flight_3d/hyper_flight_3d.py`)
- Flight app → Flight HUD: creates (evidence: `hyper_flight_3d/hyper_flight_3d.py`)
- Flight app → Audio synth: creates
- 3D renderer → OBJ models: loads models (evidence: `hyper_flight_3d/engine3d.py`)
- Player → Game launcher: uses
- Game launcher → Pad readers: reads pads (evidence: `strike_team/launcher.py`)
- Game launcher → Mission generator: generates missions (evidence: `strike_team/launcher.py`)
- Game launcher → Sound generator: uses sounds (evidence: `strike_team/launcher.py`)
- Game launcher → 3D battle: starts battle (evidence: `strike_team/launcher.py`)
- Game launcher → 3D battle: streams pad input (evidence: `strike_team/launcher.py`)
- Player → Stealth heist: plays
- Stealth heist → Procedural textures: generates textures (evidence: `vault_runner/vault_runner.py`)
