# gambursuluk/final-showdown architecture

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

## Overview

MyCraft is a voxel-world game: the player moves a camera through a procedurally generated, chunked world and can place or remove blocks. The main loop updates and renders the world; chunk terrain generation, mesh rebuilding, and block editing are distinct stages. The tree contains duplicate root-level and MyCraft/ copies; the graph follows the sampled root-level implementation. The README is empty, so unsampled capabilities and relationships are not inferred.

Main entry points: [`main.cpp`](https://github.com/gambursuluk/final-showdown/blob/master/main.cpp) (Game Loop), [`World.cpp`](https://github.com/gambursuluk/final-showdown/blob/master/World.cpp) (World Manager), [`Chunk.cpp`](https://github.com/gambursuluk/final-showdown/blob/master/Chunk.cpp) (Chunk Meshing), [`VBO.cpp`](https://github.com/gambursuluk/final-showdown/blob/master/VBO.cpp) (Vertex Buffer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gameplay["Gameplay"]
  node_main["Game Loop<br/>[main.cpp]"]
  node_camera["Camera Controls<br/>[Camera.cpp]"]
  node_block_edit["Block Editing<br/>[main.cpp]"]
end

subgraph group_world["World Simulation"]
  node_world["World Manager<br/>[World.cpp]"]
  node_chunk["Chunk Data<br/>[Chunk.cpp]"]
  node_mesh["Chunk Meshing<br/>[Chunk.cpp]"]
end

subgraph group_graphics["Rendering"]
  node_chunk_render["Chunk Renderer<br/>[Chunk.cpp]"]
  node_shader["Shader Program<br/>[ShaderClass.cpp]"]
  node_texture["Texture Binding<br/>[Texture.cpp]"]
  node_vao["Vertex Array<br/>[VAO.cpp]"]
  node_vbo["Vertex Buffer<br/>[VBO.cpp]"]
  node_ebo["Index Buffer<br/>[EBO.cpp]"]
end

subgraph group_noise["Terrain Generation"]
  node_terrain["Terrain Generation<br/>[Chunk.cpp]"]
  node_noise_lib["Noise Library<br/>[FastNoiseLite.h]"]
end

node_player(("Player"))
node_gl["OpenGL"]

node_player -->|"starts"| node_main
node_main -->|"updates input"| node_camera
node_main -->|"updates"| node_world
node_main -->|"renders"| node_world
node_main -->|"rebuilds dirty"| node_mesh
node_main -->|"renders chunks"| node_chunk_render
node_main -->|"dispatches keys"| node_block_edit
node_block_edit -->|"queries and edits"| node_world
node_world -->|"loads chunks"| node_chunk
node_world -.->|"queries blocks"| node_chunk
node_chunk -->|"generates"| node_terrain
node_terrain -->|"samples noise"| node_noise_lib
node_mesh -->|"checks neighbors"| node_world
node_mesh -.->|"uploads buffers"| node_gl
node_chunk_render -.->|"draws mesh"| node_gl
node_main -->|"creates and activates"| node_shader
node_main -->|"binds texture"| node_texture
node_main -->|"configures"| node_vao
node_main -->|"creates"| node_vbo
node_main -->|"creates"| node_ebo
node_vao -->|"links attributes"| node_vbo
node_vbo -.->|"manages buffer"| node_gl
node_ebo -.->|"manages buffer"| node_gl

click node_main "https://github.com/gambursuluk/final-showdown/blob/master/main.cpp"
click node_camera "https://github.com/gambursuluk/final-showdown/blob/master/Camera.cpp"
click node_block_edit "https://github.com/gambursuluk/final-showdown/blob/master/main.cpp"
click node_world "https://github.com/gambursuluk/final-showdown/blob/master/World.cpp"
click node_chunk "https://github.com/gambursuluk/final-showdown/blob/master/Chunk.cpp"
click node_terrain "https://github.com/gambursuluk/final-showdown/blob/master/Chunk.cpp"
click node_noise_lib "https://github.com/gambursuluk/final-showdown/blob/master/FastNoiseLite.h"
click node_mesh "https://github.com/gambursuluk/final-showdown/blob/master/Chunk.cpp"
click node_chunk_render "https://github.com/gambursuluk/final-showdown/blob/master/Chunk.cpp"
click node_shader "https://github.com/gambursuluk/final-showdown/blob/master/ShaderClass.cpp"
click node_texture "https://github.com/gambursuluk/final-showdown/blob/master/Texture.cpp"
click node_vao "https://github.com/gambursuluk/final-showdown/blob/master/VAO.cpp"
click node_vbo "https://github.com/gambursuluk/final-showdown/blob/master/VBO.cpp"
click node_ebo "https://github.com/gambursuluk/final-showdown/blob/master/EBO.cpp"

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_main,node_camera,node_block_edit toneBlue
class node_world,node_chunk,node_mesh toneAmber
class node_chunk_render,node_shader,node_texture,node_vao,node_vbo,node_ebo toneMint
class node_terrain,node_noise_lib toneRose
class node_player,node_gl toneIndigo
```

## Components

### Gameplay

- [Game Loop](https://github.com/gambursuluk/final-showdown/blob/master/main.cpp): `main.cpp`
- [Camera Controls](https://github.com/gambursuluk/final-showdown/blob/master/Camera.cpp): `Camera.cpp`
- [Block Editing](https://github.com/gambursuluk/final-showdown/blob/master/main.cpp): `main.cpp`

### World Simulation

- [World Manager](https://github.com/gambursuluk/final-showdown/blob/master/World.cpp): `World.cpp`
- [Chunk Data](https://github.com/gambursuluk/final-showdown/blob/master/Chunk.cpp): `Chunk.cpp`
- [Chunk Meshing](https://github.com/gambursuluk/final-showdown/blob/master/Chunk.cpp): `Chunk.cpp`

### Rendering

- [Chunk Renderer](https://github.com/gambursuluk/final-showdown/blob/master/Chunk.cpp): `Chunk.cpp`
- [Shader Program](https://github.com/gambursuluk/final-showdown/blob/master/ShaderClass.cpp): `ShaderClass.cpp`
- [Texture Binding](https://github.com/gambursuluk/final-showdown/blob/master/Texture.cpp): `Texture.cpp`
- [Vertex Array](https://github.com/gambursuluk/final-showdown/blob/master/VAO.cpp): `VAO.cpp`
- [Vertex Buffer](https://github.com/gambursuluk/final-showdown/blob/master/VBO.cpp): `VBO.cpp`
- [Index Buffer](https://github.com/gambursuluk/final-showdown/blob/master/EBO.cpp): `EBO.cpp`

### Terrain Generation

- [Terrain Generation](https://github.com/gambursuluk/final-showdown/blob/master/Chunk.cpp): `Chunk.cpp`
- [Noise Library](https://github.com/gambursuluk/final-showdown/blob/master/FastNoiseLite.h): `FastNoiseLite.h`

### Other components

- **Player**
- **OpenGL**

## Connections

- Player → Game Loop: starts
- Game Loop → Camera Controls: updates input (evidence: `main.cpp`)
- Game Loop → World Manager: updates (evidence: `main.cpp`)
- Game Loop → World Manager: renders (evidence: `main.cpp`)
- Game Loop → Chunk Meshing: rebuilds dirty (evidence: `main.cpp`)
- Game Loop → Chunk Renderer: renders chunks (evidence: `main.cpp`)
- Game Loop → Block Editing: dispatches keys (evidence: `main.cpp`)
- Block Editing → World Manager: queries and edits (evidence: `main.cpp`)
- World Manager → Chunk Data: loads chunks (evidence: `World.cpp`)
- World Manager → Chunk Data: queries blocks
- Chunk Data → Terrain Generation: generates (evidence: `Chunk.cpp`)
- Terrain Generation → Noise Library: samples noise (evidence: `Chunk.cpp`)
- Chunk Meshing → World Manager: checks neighbors (evidence: `Chunk.cpp`)
- Chunk Meshing → OpenGL: uploads buffers
- Chunk Renderer → OpenGL: draws mesh
- Game Loop → Shader Program: creates and activates (evidence: `main.cpp`)
- Game Loop → Texture Binding: binds texture (evidence: `main.cpp`)
- Game Loop → Vertex Array: configures (evidence: `main.cpp`)
- Game Loop → Vertex Buffer: creates (evidence: `main.cpp`)
- Game Loop → Index Buffer: creates (evidence: `main.cpp`)
- Vertex Array → Vertex Buffer: links attributes
- Vertex Buffer → OpenGL: manages buffer
- Index Buffer → OpenGL: manages buffer
