# djazy-faradj/craftmine architecture

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

## Overview

CraftMine is a small LWJGL Minecraft-inspired 3D game. The principal workflow starts with keyboard and mouse events, which update player and camera movement or trigger block interactions; each game tick updates player physics and checks collisions, then the renderer draws the block geometry from the camera view. The graph includes the documented rendering, texturing, block, camera, and physics capabilities. Source excerpts show the main runtime wiring; unsampled interactions are omitted where their direction is not established.

Main entry points: [`CraftMine/src/AppMain.java`](https://github.com/djazy-faradj/craftmine/blob/master/CraftMine/src/AppMain.java) (Game Loop), [`CraftMine/src/Player.java`](https://github.com/djazy-faradj/craftmine/blob/master/CraftMine/src/Player.java) (Player State), [`CraftMine/src/Block.java`](https://github.com/djazy-faradj/craftmine/blob/master/CraftMine/src/Block.java) (Block Geometry), [`CraftMine/src/ShaderProgram.java`](https://github.com/djazy-faradj/craftmine/blob/master/CraftMine/src/ShaderProgram.java) (Shader Program)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Game Runtime"]
  node_app["Game Loop<br/>[AppMain.java]"]
  node_settings["Game Settings<br/>[Settings.java]"]
  node_input["Input Handling<br/>[InputHandler.java]"]
end

subgraph group_gameplay["Player And World"]
  node_player["Player State<br/>[Player.java]"]
  node_camera["Camera<br/>[Camera.java]"]
  node_block["Block Geometry<br/>[Block.java]"]
  node_static_hitbox["Block Hitboxes<br/>[StaticHitbox.java]"]
  node_dynamic_hitbox["Entity Hitboxes<br/>[DynamicHitbox.java]"]
end

subgraph group_rendering["Rendering"]
  node_renderer["Geometry Renderer<br/>[Renderer.java]"]
  node_shader["Shader Program<br/>[ShaderProgram.java]"]
  node_shader_source["Shader Sources<br/>[ShaderSource.java]"]
  node_texture["Texture Loading"]
  node_transform["Model Transform<br/>[Transform.java]"]
end

node_user(("Player"))

node_user -->|"provides input"| node_input
node_app -->|"registers callbacks"| node_input
node_input -->|"updates state"| node_player
node_input -->|"destroys or places"| node_block
node_app -->|"updates each tick"| node_player
node_app -->|"checks collisions"| node_static_hitbox
node_app -->|"creates world blocks"| node_block
node_app -->|"sends render matrices"| node_shader
node_app -->|"renders frame"| node_renderer
node_app -->|"loads shader text"| node_shader_source
node_player -->|"updates movement"| node_camera
node_player -->|"updates hitbox"| node_dynamic_hitbox
node_player -->|"tracks highlighted block"| node_block
node_static_hitbox -->|"resolves collisions"| node_dynamic_hitbox
node_block -->|"creates hitbox"| node_static_hitbox
node_block -->|"uploads vertices"| node_renderer
node_shader -->|"loads and binds"| node_texture
node_shader -->|"reads view matrix"| node_camera
node_shader -->|"reads model matrix"| node_transform

click node_app "https://github.com/djazy-faradj/craftmine/blob/master/CraftMine/src/AppMain.java"
click node_settings "https://github.com/djazy-faradj/craftmine/blob/master/CraftMine/src/Settings.java"
click node_input "https://github.com/djazy-faradj/craftmine/blob/master/CraftMine/src/InputHandler.java"
click node_player "https://github.com/djazy-faradj/craftmine/blob/master/CraftMine/src/Player.java"
click node_camera "https://github.com/djazy-faradj/craftmine/blob/master/CraftMine/src/Camera.java"
click node_block "https://github.com/djazy-faradj/craftmine/blob/master/CraftMine/src/Block.java"
click node_static_hitbox "https://github.com/djazy-faradj/craftmine/blob/master/CraftMine/src/StaticHitbox.java"
click node_dynamic_hitbox "https://github.com/djazy-faradj/craftmine/blob/master/CraftMine/src/DynamicHitbox.java"
click node_renderer "https://github.com/djazy-faradj/craftmine/blob/master/CraftMine/src/Renderer.java"
click node_shader "https://github.com/djazy-faradj/craftmine/blob/master/CraftMine/src/ShaderProgram.java"
click node_shader_source "https://github.com/djazy-faradj/craftmine/blob/master/CraftMine/src/ShaderSource.java"
click node_texture "https://github.com/djazy-faradj/craftmine/blob/master/CraftMine/src/TextureHandler.java"
click node_transform "https://github.com/djazy-faradj/craftmine/blob/master/CraftMine/src/Transform.java"

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_app,node_settings,node_input toneBlue
class node_player,node_camera,node_block,node_static_hitbox,node_dynamic_hitbox toneAmber
class node_renderer,node_shader,node_shader_source,node_texture,node_transform toneMint
class node_user toneIndigo
```

## Components

### Game Runtime

- [Game Loop](https://github.com/djazy-faradj/craftmine/blob/master/CraftMine/src/AppMain.java): `CraftMine/src/AppMain.java`
- [Game Settings](https://github.com/djazy-faradj/craftmine/blob/master/CraftMine/src/Settings.java): `CraftMine/src/Settings.java`
- [Input Handling](https://github.com/djazy-faradj/craftmine/blob/master/CraftMine/src/InputHandler.java): `CraftMine/src/InputHandler.java`

### Player And World

- [Player State](https://github.com/djazy-faradj/craftmine/blob/master/CraftMine/src/Player.java): `CraftMine/src/Player.java`
- [Camera](https://github.com/djazy-faradj/craftmine/blob/master/CraftMine/src/Camera.java): `CraftMine/src/Camera.java`
- [Block Geometry](https://github.com/djazy-faradj/craftmine/blob/master/CraftMine/src/Block.java): `CraftMine/src/Block.java`
- [Block Hitboxes](https://github.com/djazy-faradj/craftmine/blob/master/CraftMine/src/StaticHitbox.java): `CraftMine/src/StaticHitbox.java`
- [Entity Hitboxes](https://github.com/djazy-faradj/craftmine/blob/master/CraftMine/src/DynamicHitbox.java): `CraftMine/src/DynamicHitbox.java`

### Rendering

- [Geometry Renderer](https://github.com/djazy-faradj/craftmine/blob/master/CraftMine/src/Renderer.java): `CraftMine/src/Renderer.java`
- [Shader Program](https://github.com/djazy-faradj/craftmine/blob/master/CraftMine/src/ShaderProgram.java): `CraftMine/src/ShaderProgram.java`
- [Shader Sources](https://github.com/djazy-faradj/craftmine/blob/master/CraftMine/src/ShaderSource.java): `CraftMine/src/ShaderSource.java`
- [Texture Loading](https://github.com/djazy-faradj/craftmine/blob/master/CraftMine/src/TextureHandler.java): `CraftMine/src/TextureHandler.java`
- [Model Transform](https://github.com/djazy-faradj/craftmine/blob/master/CraftMine/src/Transform.java): `CraftMine/src/Transform.java`

### Other components

- **Player**

## Connections

- Player → Input Handling: provides input
- Game Loop → Input Handling: registers callbacks (evidence: `CraftMine/src/AppMain.java`)
- Input Handling → Player State: updates state (evidence: `CraftMine/src/InputHandler.java`)
- Input Handling → Block Geometry: destroys or places (evidence: `CraftMine/src/InputHandler.java`)
- Game Loop → Player State: updates each tick (evidence: `CraftMine/src/AppMain.java`)
- Game Loop → Block Hitboxes: checks collisions (evidence: `CraftMine/src/AppMain.java`)
- Game Loop → Block Geometry: creates world blocks (evidence: `CraftMine/src/AppMain.java`)
- Game Loop → Shader Program: sends render matrices (evidence: `CraftMine/src/AppMain.java`)
- Game Loop → Geometry Renderer: renders frame (evidence: `CraftMine/src/AppMain.java`)
- Game Loop → Shader Sources: loads shader text (evidence: `CraftMine/src/AppMain.java`)
- Player State → Camera: updates movement (evidence: `CraftMine/src/Player.java`)
- Player State → Entity Hitboxes: updates hitbox (evidence: `CraftMine/src/Player.java`)
- Player State → Block Geometry: tracks highlighted block (evidence: `CraftMine/src/Player.java`)
- Block Hitboxes → Entity Hitboxes: resolves collisions (evidence: `CraftMine/src/StaticHitbox.java`)
- Block Geometry → Block Hitboxes: creates hitbox (evidence: `CraftMine/src/Block.java`)
- Block Geometry → Geometry Renderer: uploads vertices (evidence: `CraftMine/src/Block.java`)
- Shader Program → Texture Loading: loads and binds (evidence: `CraftMine/src/ShaderProgram.java`)
- Shader Program → Camera: reads view matrix (evidence: `CraftMine/src/ShaderProgram.java`)
- Shader Program → Model Transform: reads model matrix (evidence: `CraftMine/src/ShaderProgram.java`)
