# voron2010/minecraft-1.7.3-cpp-port architecture

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

- Interactive diagram: https://gitdiagram.com/voron2010/minecraft-1.7.3-cpp-port
- Repository: https://github.com/voron2010/minecraft-1.7.3-cpp-port

## Overview

McBetaCpp is a native C++ port of Minecraft Beta 1.7.3. The main workflow is player input through the game client and game mode into world simulation, followed by rendering, audio, and—when multiplayer is selected—network synchronization. The graph also preserves documented Creative mode, SPC commands, chunk persistence, and texture packs. Relationships are limited to declarations, source-index references, and README statements shown here; unsampled subsystem links are omitted rather than inferred.

Main entry points: [`src/client/Minecraft.h`](https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/client/Minecraft.h) (Game client), [`src/world/level/Level.h`](https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/world/level/Level.h) (World level), [`src/client/particle/ParticleEngine.cpp`](https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/client/particle/ParticleEngine.cpp) (Particle engine), [`src/world/level/chunk/LevelChunk.h`](https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/world/level/chunk/LevelChunk.h) (World chunks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client experience"]
  node_game["Game client<br/>[Minecraft.h]"]
  node_input["Input handlers<br/>[MouseHandler.cpp]"]
  node_screens["Game screens<br/>[Screen.cpp]"]
  node_gamemode["Game modes<br/>[GameMode.cpp]"]
  node_spc["SPC commands<br/>[SPCCommand.cpp]"]
  node_renderer["World renderer<br/>[LevelRenderer.cpp]"]
  node_particles["Particle engine<br/>[ParticleEngine.cpp]"]
  node_sound["Sound engine<br/>[SoundEngine.cpp]"]
end

subgraph group_world["World simulation"]
  node_level["World level<br/>[Level.h]"]
  node_chunks["World chunks<br/>[LevelChunk.h]"]
  node_generation["World generation"]
  node_entities["Entities and mobs<br/>[Entity.h]"]
  node_tiles["Blocks and tiles<br/>[Tile.cpp]"]
end

subgraph group_network["Networking"]
  node_network_client["Client packet handler"]
  node_network_manager["Network transport<br/>[NetworkManager.cpp]"]
end

subgraph group_resources["Resources and persistence"]
  node_texturepacks["Texture packs"]
  node_storage[("Chunk storage")]
  node_legacy_storage[("Legacy chunk storage")]
  node_nbt["NBT tags<br/>[CompoundTag.cpp]"]
end

subgraph group_platform["Native platform"]
  node_main["Application entry<br/>[Main.cpp]"]
  node_sdl_gl["SDL and OpenGL<br/>[GLContext.cpp]"]
end

node_player(("Player"))
node_server(("Beta game server"))

node_player -->|"provides input"| node_input
node_main -->|"starts"| node_game
node_game -->|"owns"| node_input
node_game -->|"owns"| node_screens
node_game -->|"owns"| node_gamemode
node_game -->|"owns"| node_renderer
node_game -->|"owns"| node_particles
node_game -->|"owns"| node_sound
node_game -->|"owns"| node_texturepacks
node_game -->|"holds"| node_level
node_gamemode -.->|"alters blocks"| node_level
node_player -->|"runs commands"| node_spc
node_level -->|"uses chunks"| node_chunks
node_level -.->|"generates terrain"| node_generation
node_level -->|"simulates entities"| node_entities
node_level -->|"reads tiles"| node_tiles
node_particles -->|"reads world"| node_level
node_particles -->|"creates debris"| node_tiles
node_chunks -->|"serialized as"| node_legacy_storage
node_legacy_storage -->|"reads and writes"| node_nbt
node_storage -->|"loads and saves"| node_chunks
node_game -->|"connects via"| node_network_client
node_network_client -->|"uses transport"| node_network_manager
node_network_manager -->|"exchanges packets"| node_server
node_renderer -.->|"renders with"| node_sdl_gl

click node_main "https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/pc/Main.cpp"
click node_game "https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/client/Minecraft.h"
click node_input "https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/client/MouseHandler.cpp"
click node_screens "https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/client/gui/Screen.cpp"
click node_gamemode "https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/client/gamemode/GameMode.cpp"
click node_spc "https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/client/spc/SPCCommand.cpp"
click node_renderer "https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/client/renderer/LevelRenderer.cpp"
click node_particles "https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/client/particle/ParticleEngine.cpp"
click node_sound "https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/client/sound/SoundEngine.cpp"
click node_texturepacks "https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/client/skins/TexturePackRepository.cpp"
click node_level "https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/world/level/Level.h"
click node_chunks "https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/world/level/chunk/LevelChunk.h"
click node_generation "https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/world/level/levelgen/RandomLevelSource.cpp"
click node_entities "https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/world/entity/Entity.h"
click node_tiles "https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/world/level/tile/Tile.cpp"
click node_storage "https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/world/level/chunk/storage/McRegionChunkStorage.cpp"
click node_legacy_storage "https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/world/level/chunk/storage/OldChunkStorage.cpp"
click node_nbt "https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/nbt/CompoundTag.cpp"
click node_network_client "https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/network/NetClientHandler.cpp"
click node_network_manager "https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/network/NetworkManager.cpp"
click node_sdl_gl "https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/pc/lwjgl/GLContext.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_game,node_input,node_screens,node_gamemode,node_spc,node_renderer,node_particles,node_sound toneBlue
class node_level,node_chunks,node_generation,node_entities,node_tiles toneAmber
class node_network_client,node_network_manager,node_server toneMint
class node_texturepacks,node_storage,node_legacy_storage,node_nbt toneRose
class node_main,node_sdl_gl,node_player toneIndigo
```

## Components

### Client experience

- [Game client](https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/client/Minecraft.h): `src/client/Minecraft.h`
- [Input handlers](https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/client/MouseHandler.cpp): `src/client/MouseHandler.cpp`
- [Game screens](https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/client/gui/Screen.cpp): `src/client/gui/Screen.cpp`
- [Game modes](https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/client/gamemode/GameMode.cpp): `src/client/gamemode/GameMode.cpp`
- [SPC commands](https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/client/spc/SPCCommand.cpp): `src/client/spc/SPCCommand.cpp`
- [World renderer](https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/client/renderer/LevelRenderer.cpp): `src/client/renderer/LevelRenderer.cpp`
- [Particle engine](https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/client/particle/ParticleEngine.cpp): `src/client/particle/ParticleEngine.cpp`
- [Sound engine](https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/client/sound/SoundEngine.cpp): `src/client/sound/SoundEngine.cpp`

### World simulation

- [World level](https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/world/level/Level.h): `src/world/level/Level.h`
- [World chunks](https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/world/level/chunk/LevelChunk.h): `src/world/level/chunk/LevelChunk.h`
- [World generation](https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/world/level/levelgen/RandomLevelSource.cpp): `src/world/level/levelgen/RandomLevelSource.cpp`
- [Entities and mobs](https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/world/entity/Entity.h): `src/world/entity/Entity.h`
- [Blocks and tiles](https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/world/level/tile/Tile.cpp): `src/world/level/tile/Tile.cpp`

### Networking

- [Client packet handler](https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/network/NetClientHandler.cpp): `src/network/NetClientHandler.cpp`
- [Network transport](https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/network/NetworkManager.cpp): `src/network/NetworkManager.cpp`

### Resources and persistence

- [Texture packs](https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/client/skins/TexturePackRepository.cpp): `src/client/skins/TexturePackRepository.cpp`
- [Chunk storage](https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/world/level/chunk/storage/McRegionChunkStorage.cpp): `src/world/level/chunk/storage/McRegionChunkStorage.cpp`
- [Legacy chunk storage](https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/world/level/chunk/storage/OldChunkStorage.cpp): `src/world/level/chunk/storage/OldChunkStorage.cpp`
- [NBT tags](https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/nbt/CompoundTag.cpp): `src/nbt/CompoundTag.cpp`

### Native platform

- [Application entry](https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/pc/Main.cpp): `src/pc/Main.cpp`
- [SDL and OpenGL](https://github.com/voron2010/minecraft-1.7.3-cpp-port/blob/master/src/pc/lwjgl/GLContext.cpp): `src/pc/lwjgl/GLContext.cpp`

### Other components

- **Player**
- **Beta game server**

## Connections

- Player → Input handlers: provides input
- Application entry → Game client: starts (evidence: `src/pc/Main.cpp`)
- Game client → Input handlers: owns (evidence: `src/client/Minecraft.h`)
- Game client → Game screens: owns (evidence: `src/client/Minecraft.h`)
- Game client → Game modes: owns (evidence: `src/client/Minecraft.h`)
- Game client → World renderer: owns (evidence: `src/client/Minecraft.h`)
- Game client → Particle engine: owns (evidence: `src/client/Minecraft.h`)
- Game client → Sound engine: owns (evidence: `src/client/Minecraft.h`)
- Game client → Texture packs: owns (evidence: `src/client/Minecraft.h`)
- Game client → World level: holds (evidence: `src/client/Minecraft.h`)
- Game modes → World level: alters blocks
- Player → SPC commands: runs commands
- World level → World chunks: uses chunks (evidence: `src/world/level/Level.h`)
- World level → World generation: generates terrain
- World level → Entities and mobs: simulates entities (evidence: `src/world/level/Level.h`)
- World level → Blocks and tiles: reads tiles (evidence: `src/world/level/Level.h`)
- Particle engine → World level: reads world (evidence: `src/client/particle/ParticleEngine.cpp`)
- Particle engine → Blocks and tiles: creates debris (evidence: `src/client/particle/ParticleEngine.cpp`)
- World chunks → Legacy chunk storage: serialized as (evidence: `src/world/level/chunk/storage/OldChunkStorage.cpp`)
- Legacy chunk storage → NBT tags: reads and writes (evidence: `src/world/level/chunk/storage/OldChunkStorage.cpp`)
- Chunk storage → World chunks: loads and saves (evidence: `src/world/level/chunk/storage/McRegionChunkStorage.cpp`)
- Game client → Client packet handler: connects via (evidence: `src/network/NetClientHandler.cpp`)
- Client packet handler → Network transport: uses transport (evidence: `src/network/NetClientHandler.cpp`)
- Network transport → Beta game server: exchanges packets
- World renderer → SDL and OpenGL: renders with
