# meistertisch/hordefall architecture

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

## Overview

This repository is a Minecraft server plugin workspace, with the game plugin providing the only substantial implemented player workflow: an operator starts and manages a private arena round, the plugin prepares a world, handles player entry, ticks the round, and cleans up. Lobby, proxy, and common modules are present but their sampled implementations are scaffolds. Relationships below are limited to calls shown in excerpts; the README is empty.

Main entry points: [`game/src/main/java/user/meistertisch/de/game/round/Round.java`](https://github.com/meistertisch/hordefall/blob/main/game/src/main/java/user/meistertisch/de/game/round/Round.java) (Round Instance), [`game/src/main/java/user/meistertisch/de/game/round/RoundManager.java`](https://github.com/meistertisch/hordefall/blob/main/game/src/main/java/user/meistertisch/de/game/round/RoundManager.java) (Round Manager), [`game/src/main/java/user/meistertisch/de/game/round/CommandRound.java`](https://github.com/meistertisch/hordefall/blob/main/game/src/main/java/user/meistertisch/de/game/round/CommandRound.java) (Round Command), [`game/src/main/java/user/meistertisch/de/game/Game.java`](https://github.com/meistertisch/hordefall/blob/main/game/src/main/java/user/meistertisch/de/game/Game.java) (Game Plugin)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_round_ops["Round Operations"]
  node_game_plugin["Game Plugin<br/>[Game.java]"]
  node_round_command["Round Command<br/>[CommandRound.java]"]
  node_round_manager["Round Manager<br/>[RoundManager.java]"]
end

subgraph group_gameplay["Round Gameplay"]
  node_round_instance["Round Instance<br/>[Round.java]"]
  node_round_state["Round States<br/>[RoundState.java]"]
  node_world_setup["Arena World Setup<br/>[Round.java]"]
  node_round_tick["Round Tick<br/>[Round.java]"]
  node_round_cleanup["World Cleanup<br/>[Round.java]"]
  node_player_events["Player Events<br/>[EventJoin.java]"]
  node_vanilla_cancel["Vanilla Event Cancel"]
end

subgraph group_platform["Server Plugins"]
  node_lobby_plugin["Lobby Plugin<br/>[Lobby.java]"]
  node_proxy_plugin["Proxy Plugin<br/>[Proxy.java]"]
end

subgraph group_shared["Shared Scaffolds"]
  node_common_core["Common Scaffold<br/>[Main.java]"]
  node_common_paper["Paper Helpers Scaffold<br/>[Main.java]"]
end

node_operator(("Operator"))
node_player(("Player"))

node_operator -->|"runs command"| node_round_command
node_game_plugin -->|"starts and stops"| node_round_manager
node_game_plugin -->|"registers listener"| node_player_events
node_game_plugin -->|"registers listener"| node_vanilla_cancel
node_game_plugin -->|"registers executor"| node_round_command
node_round_command -->|"starts and stops"| node_round_manager
node_round_command -->|"reads and changes"| node_round_instance
node_round_manager -->|"creates and prepares"| node_round_instance
node_round_manager -->|"ticks active rounds"| node_round_tick
node_round_manager -->|"ends on shutdown"| node_round_cleanup
node_round_instance -->|"prepares arena"| node_world_setup
node_round_instance -->|"runs tick logic"| node_round_tick
node_round_instance -->|"cleans world"| node_round_cleanup
node_round_instance -->|"transitions state"| node_round_state
node_round_command -->|"lists states"| node_round_state
node_player_events -->|"looks up round"| node_round_manager
node_player_events -->|"transitions and teleports"| node_round_instance
node_player -->|"joins or loads world"| node_player_events

click node_game_plugin "https://github.com/meistertisch/hordefall/blob/main/game/src/main/java/user/meistertisch/de/game/Game.java"
click node_round_command "https://github.com/meistertisch/hordefall/blob/main/game/src/main/java/user/meistertisch/de/game/round/CommandRound.java"
click node_round_manager "https://github.com/meistertisch/hordefall/blob/main/game/src/main/java/user/meistertisch/de/game/round/RoundManager.java"
click node_round_instance "https://github.com/meistertisch/hordefall/blob/main/game/src/main/java/user/meistertisch/de/game/round/Round.java"
click node_round_state "https://github.com/meistertisch/hordefall/blob/main/game/src/main/java/user/meistertisch/de/game/round/RoundState.java"
click node_world_setup "https://github.com/meistertisch/hordefall/blob/main/game/src/main/java/user/meistertisch/de/game/round/Round.java"
click node_round_tick "https://github.com/meistertisch/hordefall/blob/main/game/src/main/java/user/meistertisch/de/game/round/Round.java"
click node_round_cleanup "https://github.com/meistertisch/hordefall/blob/main/game/src/main/java/user/meistertisch/de/game/round/Round.java"
click node_player_events "https://github.com/meistertisch/hordefall/blob/main/game/src/main/java/user/meistertisch/de/game/round/EventJoin.java"
click node_vanilla_cancel "https://github.com/meistertisch/hordefall/blob/main/game/src/main/java/user/meistertisch/de/game/round/EventVanillaCancel.java"
click node_lobby_plugin "https://github.com/meistertisch/hordefall/blob/main/lobby/src/main/java/user/meistertisch/de/lobby/Lobby.java"
click node_proxy_plugin "https://github.com/meistertisch/hordefall/blob/main/proxy/src/main/java/user/meistertisch/de/proxy/Proxy.java"
click node_common_core "https://github.com/meistertisch/hordefall/blob/main/common/src/main/java/user/meistertisch/de/Main.java"
click node_common_paper "https://github.com/meistertisch/hordefall/blob/main/common-paper/src/main/java/user/meistertisch/de/Main.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_game_plugin,node_round_command,node_round_manager toneBlue
class node_round_instance,node_round_state,node_world_setup,node_round_tick,node_round_cleanup,node_player_events,node_vanilla_cancel toneAmber
class node_lobby_plugin,node_proxy_plugin toneMint
class node_common_core,node_common_paper toneRose
class node_operator,node_player toneIndigo
```

## Components

### Round Operations

- [Game Plugin](https://github.com/meistertisch/hordefall/blob/main/game/src/main/java/user/meistertisch/de/game/Game.java): `game/src/main/java/user/meistertisch/de/game/Game.java`
- [Round Command](https://github.com/meistertisch/hordefall/blob/main/game/src/main/java/user/meistertisch/de/game/round/CommandRound.java): `game/src/main/java/user/meistertisch/de/game/round/CommandRound.java`
- [Round Manager](https://github.com/meistertisch/hordefall/blob/main/game/src/main/java/user/meistertisch/de/game/round/RoundManager.java): `game/src/main/java/user/meistertisch/de/game/round/RoundManager.java`

### Round Gameplay

- [Round Instance](https://github.com/meistertisch/hordefall/blob/main/game/src/main/java/user/meistertisch/de/game/round/Round.java): `game/src/main/java/user/meistertisch/de/game/round/Round.java`
- [Round States](https://github.com/meistertisch/hordefall/blob/main/game/src/main/java/user/meistertisch/de/game/round/RoundState.java): `game/src/main/java/user/meistertisch/de/game/round/RoundState.java`
- [Arena World Setup](https://github.com/meistertisch/hordefall/blob/main/game/src/main/java/user/meistertisch/de/game/round/Round.java): `game/src/main/java/user/meistertisch/de/game/round/Round.java`
- [Round Tick](https://github.com/meistertisch/hordefall/blob/main/game/src/main/java/user/meistertisch/de/game/round/Round.java): `game/src/main/java/user/meistertisch/de/game/round/Round.java`
- [World Cleanup](https://github.com/meistertisch/hordefall/blob/main/game/src/main/java/user/meistertisch/de/game/round/Round.java): `game/src/main/java/user/meistertisch/de/game/round/Round.java`
- [Player Events](https://github.com/meistertisch/hordefall/blob/main/game/src/main/java/user/meistertisch/de/game/round/EventJoin.java): `game/src/main/java/user/meistertisch/de/game/round/EventJoin.java`
- [Vanilla Event Cancel](https://github.com/meistertisch/hordefall/blob/main/game/src/main/java/user/meistertisch/de/game/round/EventVanillaCancel.java): `game/src/main/java/user/meistertisch/de/game/round/EventVanillaCancel.java`

### Server Plugins

- [Lobby Plugin](https://github.com/meistertisch/hordefall/blob/main/lobby/src/main/java/user/meistertisch/de/lobby/Lobby.java): `lobby/src/main/java/user/meistertisch/de/lobby/Lobby.java`
- [Proxy Plugin](https://github.com/meistertisch/hordefall/blob/main/proxy/src/main/java/user/meistertisch/de/proxy/Proxy.java): `proxy/src/main/java/user/meistertisch/de/proxy/Proxy.java`

### Shared Scaffolds

- [Common Scaffold](https://github.com/meistertisch/hordefall/blob/main/common/src/main/java/user/meistertisch/de/Main.java): `common/src/main/java/user/meistertisch/de/Main.java`
- [Paper Helpers Scaffold](https://github.com/meistertisch/hordefall/blob/main/common-paper/src/main/java/user/meistertisch/de/Main.java): `common-paper/src/main/java/user/meistertisch/de/Main.java`

### Other components

- **Operator**
- **Player**

## Connections

- Operator → Round Command: runs command
- Game Plugin → Round Manager: starts and stops (evidence: `game/src/main/java/user/meistertisch/de/game/Game.java`)
- Game Plugin → Player Events: registers listener (evidence: `game/src/main/java/user/meistertisch/de/game/Game.java`)
- Game Plugin → Vanilla Event Cancel: registers listener (evidence: `game/src/main/java/user/meistertisch/de/game/Game.java`)
- Game Plugin → Round Command: registers executor (evidence: `game/src/main/java/user/meistertisch/de/game/Game.java`)
- Round Command → Round Manager: starts and stops (evidence: `game/src/main/java/user/meistertisch/de/game/round/CommandRound.java`)
- Round Command → Round Instance: reads and changes (evidence: `game/src/main/java/user/meistertisch/de/game/round/CommandRound.java`)
- Round Manager → Round Instance: creates and prepares (evidence: `game/src/main/java/user/meistertisch/de/game/round/RoundManager.java`)
- Round Manager → Round Tick: ticks active rounds (evidence: `game/src/main/java/user/meistertisch/de/game/round/RoundManager.java`)
- Round Manager → World Cleanup: ends on shutdown (evidence: `game/src/main/java/user/meistertisch/de/game/round/RoundManager.java`)
- Round Instance → Arena World Setup: prepares arena (evidence: `game/src/main/java/user/meistertisch/de/game/round/Round.java`)
- Round Instance → Round Tick: runs tick logic (evidence: `game/src/main/java/user/meistertisch/de/game/round/Round.java`)
- Round Instance → World Cleanup: cleans world (evidence: `game/src/main/java/user/meistertisch/de/game/round/Round.java`)
- Round Instance → Round States: transitions state (evidence: `game/src/main/java/user/meistertisch/de/game/round/Round.java`)
- Round Command → Round States: lists states (evidence: `game/src/main/java/user/meistertisch/de/game/round/CommandRound.java`)
- Player Events → Round Manager: looks up round (evidence: `game/src/main/java/user/meistertisch/de/game/round/EventJoin.java`)
- Player Events → Round Instance: transitions and teleports (evidence: `game/src/main/java/user/meistertisch/de/game/round/EventJoin.java`)
- Player → Player Events: joins or loads world (evidence: `game/src/main/java/user/meistertisch/de/game/round/EventJoin.java`)
