# allesugo/minecraft-speed-proxy architecture

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

- Interactive diagram: https://gitdiagram.com/allesugo/minecraft-speed-proxy
- Repository: https://github.com/allesugo/minecraft-speed-proxy

## Overview

Minecraft-Speed-Proxy accepts command-line or configuration-file settings, starts a Minecraft server proxy, and exposes server controls through console commands and an optional Web API. Its documented capabilities also include whitelist/ban management, custom MOTD responses, player and traffic information, IPv6, and Forge support. The graph preserves those product areas while grouping shared networking and asynchronous I/O. Several implementation files were not sampled, so some documented connections are shown as unverified rather than asserted as source-confirmed calls.

Main entry points: [`proxy.cpp`](https://github.com/allesugo/minecraft-speed-proxy/blob/master/proxy.cpp) (Minecraft proxy), [`main.cpp`](https://github.com/allesugo/minecraft-speed-proxy/blob/master/main.cpp) (Startup and console), [`WebControl.cpp`](https://github.com/allesugo/minecraft-speed-proxy/blob/master/WebControl.cpp) (Web API), [`config.cpp`](https://github.com/allesugo/minecraft-speed-proxy/blob/master/config.cpp) (Runtime configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime control"]
  node_main["Startup and console<br/>[main.cpp]"]
  node_web["Web API<br/>[WebControl.cpp]"]
end

subgraph group_proxy["Minecraft proxy"]
  node_proxycore["Minecraft proxy<br/>[proxy.cpp]"]
  node_packets["Packet translation<br/>[datapackage.cpp]"]
  node_motd["MOTD customization<br/>[proxy.cpp]"]
  node_players["Player and traffic status<br/>[proxy.cpp]"]
end

subgraph group_support["Configuration and policy"]
  node_settings["Runtime configuration<br/>[config.cpp]"]
  node_allowdeny[("Whitelist and bans<br/>[WhiteBlackList.cpp]")]
  node_json["JSON handling<br/>[CJsonObject.cpp]"]
end

subgraph group_io["Networking and I/O"]
  node_network["TCP networking<br/>[Network.cpp]"]
  node_streams["Network streams<br/>[Streams.cpp]"]
  node_async["Asynchronous I/O"]
end

node_operator(("Operator"))
node_minecraft(("Minecraft client"))
node_server(("Minecraft server"))

node_operator -->|"starts and commands"| node_main
node_main -.->|"loads settings"| node_settings
node_main -.->|"starts proxy"| node_proxycore
node_main -.->|"manages access"| node_allowdeny
node_operator -->|"sends HTTP controls"| node_web
node_web -.->|"controls server"| node_proxycore
node_minecraft -->|"connects through"| node_proxycore
node_proxycore -.->|"forwards traffic"| node_server
node_proxycore -.->|"uses packet handling"| node_packets
node_proxycore -->|"customizes status"| node_motd
node_proxycore -->|"reports status"| node_players
node_proxycore -.->|"uses TCP"| node_network
node_proxycore -->|"uses streams"| node_streams
node_proxycore -->|"uses asynchronous I/O"| node_async
node_settings -.->|"reads configuration"| node_json
node_main -.->|"enables API"| node_web

click node_main "https://github.com/allesugo/minecraft-speed-proxy/blob/master/main.cpp"
click node_web "https://github.com/allesugo/minecraft-speed-proxy/blob/master/WebControl.cpp"
click node_settings "https://github.com/allesugo/minecraft-speed-proxy/blob/master/config.cpp"
click node_allowdeny "https://github.com/allesugo/minecraft-speed-proxy/blob/master/WhiteBlackList.cpp"
click node_json "https://github.com/allesugo/minecraft-speed-proxy/blob/master/json/CJsonObject.cpp"
click node_proxycore "https://github.com/allesugo/minecraft-speed-proxy/blob/master/proxy.cpp"
click node_packets "https://github.com/allesugo/minecraft-speed-proxy/blob/master/datapackage.cpp"
click node_motd "https://github.com/allesugo/minecraft-speed-proxy/blob/master/proxy.cpp"
click node_players "https://github.com/allesugo/minecraft-speed-proxy/blob/master/proxy.cpp"
click node_network "https://github.com/allesugo/minecraft-speed-proxy/blob/master/rbslib/Network.cpp"
click node_streams "https://github.com/allesugo/minecraft-speed-proxy/blob/master/rbslib/Streams.cpp"
click node_async "https://github.com/allesugo/minecraft-speed-proxy/tree/master/asio/include/asio"

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_web,node_minecraft toneBlue
class node_proxycore,node_packets,node_motd,node_players toneAmber
class node_settings,node_allowdeny,node_json,node_server toneMint
class node_network,node_streams,node_async toneRose
class node_operator toneIndigo
```

## Components

### Runtime control

- [Startup and console](https://github.com/allesugo/minecraft-speed-proxy/blob/master/main.cpp): `main.cpp`
- [Web API](https://github.com/allesugo/minecraft-speed-proxy/blob/master/WebControl.cpp): `WebControl.cpp`

### Minecraft proxy

- [Minecraft proxy](https://github.com/allesugo/minecraft-speed-proxy/blob/master/proxy.cpp): `proxy.cpp`
- [Packet translation](https://github.com/allesugo/minecraft-speed-proxy/blob/master/datapackage.cpp): `datapackage.cpp`
- [MOTD customization](https://github.com/allesugo/minecraft-speed-proxy/blob/master/proxy.cpp): `proxy.cpp`
- [Player and traffic status](https://github.com/allesugo/minecraft-speed-proxy/blob/master/proxy.cpp): `proxy.cpp`

### Configuration and policy

- [Runtime configuration](https://github.com/allesugo/minecraft-speed-proxy/blob/master/config.cpp): `config.cpp`
- [Whitelist and bans](https://github.com/allesugo/minecraft-speed-proxy/blob/master/WhiteBlackList.cpp): `WhiteBlackList.cpp`
- [JSON handling](https://github.com/allesugo/minecraft-speed-proxy/blob/master/json/CJsonObject.cpp): `json/CJsonObject.cpp`

### Networking and I/O

- [TCP networking](https://github.com/allesugo/minecraft-speed-proxy/blob/master/rbslib/Network.cpp): `rbslib/Network.cpp`
- [Network streams](https://github.com/allesugo/minecraft-speed-proxy/blob/master/rbslib/Streams.cpp): `rbslib/Streams.cpp`
- [Asynchronous I/O](https://github.com/allesugo/minecraft-speed-proxy/tree/master/asio/include/asio): `asio/include/asio`

### Other components

- **Operator**
- **Minecraft client**
- **Minecraft server**

## Connections

- Operator → Startup and console: starts and commands (evidence: `README.md`)
- Startup and console → Runtime configuration: loads settings
- Startup and console → Minecraft proxy: starts proxy
- Startup and console → Whitelist and bans: manages access
- Operator → Web API: sends HTTP controls (evidence: `README.md`)
- Web API → Minecraft proxy: controls server (evidence: `README.md`)
- Minecraft client → Minecraft proxy: connects through (evidence: `README.md`)
- Minecraft proxy → Minecraft server: forwards traffic (evidence: `README.md`)
- Minecraft proxy → Packet translation: uses packet handling
- Minecraft proxy → MOTD customization: customizes status (evidence: `README.md`)
- Minecraft proxy → Player and traffic status: reports status (evidence: `README.md`)
- Minecraft proxy → TCP networking: uses TCP
- Minecraft proxy → Network streams: uses streams (evidence: `proxy.cpp`)
- Minecraft proxy → Asynchronous I/O: uses asynchronous I/O
- Runtime configuration → JSON handling: reads configuration
- Startup and console → Web API: enables API
