# delta203/cloudsystem architecture

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

- Interactive diagram: https://gitdiagram.com/delta203/cloudsystem
- Repository: https://github.com/delta203/cloudsystem

## Overview

Cloud System is a single-root Minecraft cloud manager: Cloud-Master provisions and supervises proxy/server services, while Cloud-API connects those services back to the master and exposes proxy/server integrations. The main workflow is console-driven group/service management, service file preparation and process startup, then socket registration and service coordination. SyncProxy adds proxy/server gameplay features. Wiring beyond the sampled sources is shown only where the README or tree supports the subsystem; unsampled module internals are not assumed.

Main entry points: [`Cloud-Master/src/main/java/de/cloud/master/delta203/core/Service.java`](https://github.com/delta203/cloudsystem/blob/main/Cloud-Master/src/main/java/de/cloud/master/delta203/core/Service.java) (Service lifecycle), [`Cloud-Master/src/main/java/de/cloud/master/delta203/main/processes/Main.java`](https://github.com/delta203/cloudsystem/blob/main/Cloud-Master/src/main/java/de/cloud/master/delta203/main/processes/Main.java) (Console loop), [`Cloud-Master/src/main/java/de/cloud/master/delta203/main/sockets`](https://github.com/delta203/cloudsystem/tree/main/Cloud-Master/src/main/java/de/cloud/master/delta203/main/sockets) (Socket channel), [`Cloud-Master/src/main/java/de/cloud/master/delta203/main/processes`](https://github.com/delta203/cloudsystem/tree/main/Cloud-Master/src/main/java/de/cloud/master/delta203/main/processes) (Setup and start)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_master["Cloud Master"]
  node_main["Console loop<br/>[Main.java]"]
  node_commands["Cloud commands"]
  node_setup["Setup and start"]
  node_groups["Service groups<br/>[Group.java]"]
  node_service["Service lifecycle<br/>[Service.java]"]
  node_files["Service files"]
  node_paths["Path manager<br/>[PathManager.java]"]
  node_mastercomm["Master communication<br/>[Communication.java]"]
  node_socket["Socket channel"]
end

subgraph group_api["Service API"]
  node_apiinstance["Service connection<br/>[CloudInstance.java]"]
  node_apicommunication["API communication"]
  node_proxyapi["Proxy API<br/>[CloudAPI.java]"]
  node_serverapi["Server API<br/>[CloudAPI.java]"]
  node_servermanager["Proxy server registry"]
end

subgraph group_sync["SyncProxy"]
  node_syncproxy["SyncProxy plugin<br/>[SyncProxy.java]"]
  node_syncserver["SyncProxy server<br/>[SyncProxy.java]"]
  node_ping["Proxy ping<br/>[Ping.java]"]
  node_join["Join handling<br/>[Join.java]"]
  node_tab["Player tab list<br/>[TabManager.java]"]
end

node_operator(("Operator"))
node_services["Proxy and servers"]
node_players(("Players"))

node_operator -->|"enters commands"| node_main
node_main -->|"dispatches"| node_commands
node_main -->|"starts or shuts down"| node_setup
node_setup -->|"sets up services"| node_groups
node_groups -->|"runs services"| node_service
node_service -->|"prepares files"| node_files
node_files -->|"copies and deletes"| node_paths
node_service -->|"starts process"| node_socket
node_service -->|"sends packets"| node_mastercomm
node_socket -->|"accepts connections"| node_services
node_services -->|"connects to master"| node_apiinstance
node_apiinstance -->|"uses communication"| node_apicommunication
node_apicommunication -->|"exchanges packets"| node_socket
node_proxyapi -->|"manages proxy servers"| node_servermanager
node_service -->|"provisions processes"| node_services
node_syncproxy -->|"handles proxy events"| node_players
node_syncserver -->|"handles server events"| node_players
node_ping -->|"serves ping requests"| node_players
node_join -->|"handles joins"| node_players
node_tab -->|"updates tab display"| node_players

click node_main "https://github.com/delta203/cloudsystem/blob/main/Cloud-Master/src/main/java/de/cloud/master/delta203/main/processes/Main.java"
click node_commands "https://github.com/delta203/cloudsystem/tree/main/Cloud-Master/src/main/java/de/cloud/master/delta203/main/commands"
click node_setup "https://github.com/delta203/cloudsystem/tree/main/Cloud-Master/src/main/java/de/cloud/master/delta203/main/processes"
click node_groups "https://github.com/delta203/cloudsystem/blob/main/Cloud-Master/src/main/java/de/cloud/master/delta203/core/Group.java"
click node_service "https://github.com/delta203/cloudsystem/blob/main/Cloud-Master/src/main/java/de/cloud/master/delta203/core/Service.java"
click node_files "https://github.com/delta203/cloudsystem/tree/main/Cloud-Master/src/main/java/de/cloud/master/delta203/core/files"
click node_paths "https://github.com/delta203/cloudsystem/blob/main/Cloud-Master/src/main/java/de/cloud/master/delta203/core/files/PathManager.java"
click node_mastercomm "https://github.com/delta203/cloudsystem/blob/main/Cloud-Master/src/main/java/de/cloud/master/delta203/core/handlers/Communication.java"
click node_socket "https://github.com/delta203/cloudsystem/tree/main/Cloud-Master/src/main/java/de/cloud/master/delta203/main/sockets"
click node_apiinstance "https://github.com/delta203/cloudsystem/blob/main/Cloud-API/src/main/java/de/cloud/api/delta203/core/CloudInstance.java"
click node_apicommunication "https://github.com/delta203/cloudsystem/blob/main/Cloud-API/src/main/java/de/cloud/api/delta203/core/handlers/CloudCommunication.java"
click node_proxyapi "https://github.com/delta203/cloudsystem/blob/main/Cloud-API/src/main/java/de/cloud/api/delta203/proxy/CloudAPI.java"
click node_serverapi "https://github.com/delta203/cloudsystem/blob/main/Cloud-API/src/main/java/de/cloud/api/delta203/server/CloudAPI.java"
click node_servermanager "https://github.com/delta203/cloudsystem/blob/main/Cloud-API/src/main/java/de/cloud/api/delta203/proxy/utils/CloudServerManager.java"
click node_syncproxy "https://github.com/delta203/cloudsystem/blob/main/Cloud-Module-SyncProxy/src/main/java/de/cloud/module/syncproxy/delta203/proxy/SyncProxy.java"
click node_syncserver "https://github.com/delta203/cloudsystem/blob/main/Cloud-Module-SyncProxy/src/main/java/de/cloud/module/syncproxy/delta203/server/SyncProxy.java"
click node_ping "https://github.com/delta203/cloudsystem/blob/main/Cloud-Module-SyncProxy/src/main/java/de/cloud/module/syncproxy/delta203/proxy/listeners/Ping.java"
click node_join "https://github.com/delta203/cloudsystem/blob/main/Cloud-Module-SyncProxy/src/main/java/de/cloud/module/syncproxy/delta203/server/listeners/Join.java"
click node_tab "https://github.com/delta203/cloudsystem/blob/main/Cloud-Module-SyncProxy/src/main/java/de/cloud/module/syncproxy/delta203/server/utils/TabManager.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_main,node_commands,node_setup,node_groups,node_service,node_files,node_paths,node_mastercomm,node_socket toneBlue
class node_apiinstance,node_apicommunication,node_proxyapi,node_serverapi,node_servermanager toneAmber
class node_syncproxy,node_syncserver,node_ping,node_join,node_tab,node_services toneMint
class node_operator,node_players toneIndigo
```

## Components

### Cloud Master

- [Console loop](https://github.com/delta203/cloudsystem/blob/main/Cloud-Master/src/main/java/de/cloud/master/delta203/main/processes/Main.java): `Cloud-Master/src/main/java/de/cloud/master/delta203/main/processes/Main.java`
- [Cloud commands](https://github.com/delta203/cloudsystem/tree/main/Cloud-Master/src/main/java/de/cloud/master/delta203/main/commands): `Cloud-Master/src/main/java/de/cloud/master/delta203/main/commands`
- [Setup and start](https://github.com/delta203/cloudsystem/tree/main/Cloud-Master/src/main/java/de/cloud/master/delta203/main/processes): `Cloud-Master/src/main/java/de/cloud/master/delta203/main/processes`
- [Service groups](https://github.com/delta203/cloudsystem/blob/main/Cloud-Master/src/main/java/de/cloud/master/delta203/core/Group.java): `Cloud-Master/src/main/java/de/cloud/master/delta203/core/Group.java`
- [Service lifecycle](https://github.com/delta203/cloudsystem/blob/main/Cloud-Master/src/main/java/de/cloud/master/delta203/core/Service.java): `Cloud-Master/src/main/java/de/cloud/master/delta203/core/Service.java`
- [Service files](https://github.com/delta203/cloudsystem/tree/main/Cloud-Master/src/main/java/de/cloud/master/delta203/core/files): `Cloud-Master/src/main/java/de/cloud/master/delta203/core/files`
- [Path manager](https://github.com/delta203/cloudsystem/blob/main/Cloud-Master/src/main/java/de/cloud/master/delta203/core/files/PathManager.java): `Cloud-Master/src/main/java/de/cloud/master/delta203/core/files/PathManager.java`
- [Master communication](https://github.com/delta203/cloudsystem/blob/main/Cloud-Master/src/main/java/de/cloud/master/delta203/core/handlers/Communication.java): `Cloud-Master/src/main/java/de/cloud/master/delta203/core/handlers/Communication.java`
- [Socket channel](https://github.com/delta203/cloudsystem/tree/main/Cloud-Master/src/main/java/de/cloud/master/delta203/main/sockets): `Cloud-Master/src/main/java/de/cloud/master/delta203/main/sockets`

### Service API

- [Service connection](https://github.com/delta203/cloudsystem/blob/main/Cloud-API/src/main/java/de/cloud/api/delta203/core/CloudInstance.java): `Cloud-API/src/main/java/de/cloud/api/delta203/core/CloudInstance.java`
- [API communication](https://github.com/delta203/cloudsystem/blob/main/Cloud-API/src/main/java/de/cloud/api/delta203/core/handlers/CloudCommunication.java): `Cloud-API/src/main/java/de/cloud/api/delta203/core/handlers/CloudCommunication.java`
- [Proxy API](https://github.com/delta203/cloudsystem/blob/main/Cloud-API/src/main/java/de/cloud/api/delta203/proxy/CloudAPI.java): `Cloud-API/src/main/java/de/cloud/api/delta203/proxy/CloudAPI.java`
- [Server API](https://github.com/delta203/cloudsystem/blob/main/Cloud-API/src/main/java/de/cloud/api/delta203/server/CloudAPI.java): `Cloud-API/src/main/java/de/cloud/api/delta203/server/CloudAPI.java`
- [Proxy server registry](https://github.com/delta203/cloudsystem/blob/main/Cloud-API/src/main/java/de/cloud/api/delta203/proxy/utils/CloudServerManager.java): `Cloud-API/src/main/java/de/cloud/api/delta203/proxy/utils/CloudServerManager.java`

### SyncProxy

- [SyncProxy plugin](https://github.com/delta203/cloudsystem/blob/main/Cloud-Module-SyncProxy/src/main/java/de/cloud/module/syncproxy/delta203/proxy/SyncProxy.java): `Cloud-Module-SyncProxy/src/main/java/de/cloud/module/syncproxy/delta203/proxy/SyncProxy.java`
- [SyncProxy server](https://github.com/delta203/cloudsystem/blob/main/Cloud-Module-SyncProxy/src/main/java/de/cloud/module/syncproxy/delta203/server/SyncProxy.java): `Cloud-Module-SyncProxy/src/main/java/de/cloud/module/syncproxy/delta203/server/SyncProxy.java`
- [Proxy ping](https://github.com/delta203/cloudsystem/blob/main/Cloud-Module-SyncProxy/src/main/java/de/cloud/module/syncproxy/delta203/proxy/listeners/Ping.java): `Cloud-Module-SyncProxy/src/main/java/de/cloud/module/syncproxy/delta203/proxy/listeners/Ping.java`
- [Join handling](https://github.com/delta203/cloudsystem/blob/main/Cloud-Module-SyncProxy/src/main/java/de/cloud/module/syncproxy/delta203/server/listeners/Join.java): `Cloud-Module-SyncProxy/src/main/java/de/cloud/module/syncproxy/delta203/server/listeners/Join.java`
- [Player tab list](https://github.com/delta203/cloudsystem/blob/main/Cloud-Module-SyncProxy/src/main/java/de/cloud/module/syncproxy/delta203/server/utils/TabManager.java): `Cloud-Module-SyncProxy/src/main/java/de/cloud/module/syncproxy/delta203/server/utils/TabManager.java`

### Other components

- **Operator**
- **Proxy and servers**
- **Players**

## Connections

- Operator → Console loop: enters commands
- Console loop → Cloud commands: dispatches
- Console loop → Setup and start: starts or shuts down
- Setup and start → Service groups: sets up services
- Service groups → Service lifecycle: runs services
- Service lifecycle → Service files: prepares files
- Service files → Path manager: copies and deletes
- Service lifecycle → Socket channel: starts process
- Service lifecycle → Master communication: sends packets
- Socket channel → Proxy and servers: accepts connections
- Proxy and servers → Service connection: connects to master
- Service connection → API communication: uses communication
- API communication → Socket channel: exchanges packets
- Proxy API → Proxy server registry: manages proxy servers
- Service lifecycle → Proxy and servers: provisions processes
- SyncProxy plugin → Players: handles proxy events
- SyncProxy server → Players: handles server events
- Proxy ping → Players: serves ping requests
- Join handling → Players: handles joins
- Player tab list → Players: updates tab display