# dreamrelaxv/rankedbedwarsv2 architecture

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

- Interactive diagram: https://gitdiagram.com/dreamrelaxv/rankedbedwarsv2
- Repository: https://github.com/dreamrelaxv/rankedbedwarsv2

## Overview

Ranked BedWars combines a Discord matchmaking and ranked-game bot, a Minecraft server plugin, and a statistics website. Players enter queues through Discord; the bot coordinates matchmaking and game records with the plugin over WebSocket, while the plugin integrates with supported BedWars server plugins. The bot also serves statistics APIs consumed by the web pages. The README identifies these three product parts; source excerpts confirm selected routing and integration points, but not the full command, protocol, or website-serving setup, so uncertain links are omitted.

Main entry points: [`plugin/src/main/java/com/deyo/rbw/RankedBedwars.java`](https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/plugin/src/main/java/com/deyo/rbw/RankedBedwars.java) (Plugin lifecycle), [`bot/src/Matchmaking/GameManager.ts`](https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/bot/src/Matchmaking/GameManager.ts) (Game lifecycle), [`bot/src/api/ApiManager.ts`](https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/bot/src/api/ApiManager.ts) (Stats API), [`bot/src/managers/CommandManager.ts`](https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/bot/src/managers/CommandManager.ts) (Command routing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_bot["Discord bot"]
  node_commands["Command routing<br/>[CommandManager.ts]"]
  node_queue["Queue matchmaking"]
  node_gameflow["Game lifecycle<br/>[GameManager.ts]"]
  node_wsbot["Bot WebSocket"]
  node_api["Stats API<br/>[ApiManager.ts]"]
  node_seasons["Season management<br/>[SeasonManager.ts]"]
  node_workers["Discord workers<br/>[WorkersManager.ts]"]
  node_config["Bot configuration<br/>[config.ts]"]
end

subgraph group_plugin["Minecraft plugin"]
  node_pluginmain["Plugin lifecycle<br/>[RankedBedwars.java]"]
  node_bedwarsapi["BedWars adapter"]
  node_mapmanager["Arena maps<br/>[MapManager.java]"]
  node_wsp["Plugin WebSocket"]
  node_gamedata["Game data storage"]
  node_apiclient["Server API client<br/>[APIClient.java]"]
end

subgraph group_web["Stats website"]
  node_pages["Stats pages"]
  node_webapi["API client<br/>[api.ts]"]
  node_search["Player search<br/>[SearchBox.tsx]"]
end

subgraph group_domain["Ranked game data"]
  node_games[("Game records<br/>[Game.ts]")]
  node_user[("Player records<br/>[User.ts]")]
  node_seasondata[("Season records<br/>[SeasonGames.ts]")]
end

node_players(("Players and moderators"))
node_discord(("Discord"))
node_minecraft(("Minecraft server"))

node_players -->|"invoke commands"| node_commands
node_commands -.->|"manage queues"| node_queue
node_queue -.->|"create games"| node_gameflow
node_gameflow -->|"records games"| node_games
node_gameflow -->|"creates channels"| node_workers
node_gameflow -.->|"updates players"| node_user
node_queue -.->|"dispatches messages"| node_wsbot
node_wsbot -.->|"WebSocket messages"| node_minecraft
node_minecraft -.->|"WebSocket messages"| node_wsp
node_pluginmain -->|"initializes"| node_wsp
node_pluginmain -->|"initializes"| node_gamedata
node_pluginmain -->|"initializes"| node_mapmanager
node_pluginmain -->|"initializes adapter"| node_bedwarsapi
node_bedwarsapi -->|"detects server plugins"| node_minecraft
node_mapmanager -->|"queries adapter"| node_bedwarsapi
node_gamedata -->|"uses plugin instance"| node_pluginmain
node_wsp -->|"handles game messages"| node_games
node_api -->|"queries players"| node_user
node_api -.->|"serves game data"| node_games
node_api -.->|"serves season data"| node_seasondata
node_seasons -->|"queries season games"| node_seasondata
node_seasons -->|"uses player records"| node_user
node_commands -.->|"routes season commands"| node_seasons
node_pages -->|"requests statistics"| node_webapi
node_search -.->|"searches players"| node_webapi
node_webapi -.->|"HTTP requests"| node_api
node_config -.->|"configures behavior"| node_gameflow

click node_commands "https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/bot/src/managers/CommandManager.ts"
click node_queue "https://github.com/dreamrelaxv/rankedbedwarsv2/tree/main/bot/src/Matchmaking"
click node_gameflow "https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/bot/src/Matchmaking/GameManager.ts"
click node_wsbot "https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/bot/src/websocket/WebSocketManager.ts"
click node_api "https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/bot/src/api/ApiManager.ts"
click node_seasons "https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/bot/src/managers/SeasonManager.ts"
click node_workers "https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/bot/src/managers/WorkersManager.ts"
click node_config "https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/bot/src/config/config.ts"
click node_games "https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/bot/src/models/Game.ts"
click node_user "https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/bot/src/models/User.ts"
click node_seasondata "https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/bot/src/models/SeasonGames.ts"
click node_pluginmain "https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/plugin/src/main/java/com/deyo/rbw/RankedBedwars.java"
click node_bedwarsapi "https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/plugin/src/main/java/com/deyo/rbw/bedwars/BedwarsAPIManager.java"
click node_mapmanager "https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/plugin/src/main/java/com/deyo/rbw/managers/MapManager.java"
click node_wsp "https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/plugin/src/main/java/com/deyo/rbw/managers/WebSocketManager.java"
click node_gamedata "https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/plugin/src/main/java/com/deyo/rbw/managers/GameDataManager.java"
click node_apiclient "https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/plugin/src/main/java/com/deyo/rbw/utils/APIClient.java"
click node_pages "https://github.com/dreamrelaxv/rankedbedwarsv2/tree/main/web/app"
click node_webapi "https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/web/lib/api.ts"
click node_search "https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/web/components/SearchBox.tsx"

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_commands,node_queue,node_gameflow,node_wsbot,node_api,node_seasons,node_workers,node_config toneBlue
class node_pluginmain,node_bedwarsapi,node_mapmanager,node_wsp,node_gamedata,node_apiclient toneAmber
class node_pages,node_webapi,node_search,node_minecraft toneMint
class node_games,node_user,node_seasondata toneRose
class node_players,node_discord toneIndigo
```

## Components

### Discord bot

- [Command routing](https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/bot/src/managers/CommandManager.ts): `bot/src/managers/CommandManager.ts`
- [Queue matchmaking](https://github.com/dreamrelaxv/rankedbedwarsv2/tree/main/bot/src/Matchmaking): `bot/src/Matchmaking`
- [Game lifecycle](https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/bot/src/Matchmaking/GameManager.ts): `bot/src/Matchmaking/GameManager.ts`
- [Bot WebSocket](https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/bot/src/websocket/WebSocketManager.ts): `bot/src/websocket/WebSocketManager.ts`
- [Stats API](https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/bot/src/api/ApiManager.ts): `bot/src/api/ApiManager.ts`
- [Season management](https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/bot/src/managers/SeasonManager.ts): `bot/src/managers/SeasonManager.ts`
- [Discord workers](https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/bot/src/managers/WorkersManager.ts): `bot/src/managers/WorkersManager.ts`
- [Bot configuration](https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/bot/src/config/config.ts): `bot/src/config/config.ts`

### Minecraft plugin

- [Plugin lifecycle](https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/plugin/src/main/java/com/deyo/rbw/RankedBedwars.java): `plugin/src/main/java/com/deyo/rbw/RankedBedwars.java`
- [BedWars adapter](https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/plugin/src/main/java/com/deyo/rbw/bedwars/BedwarsAPIManager.java): `plugin/src/main/java/com/deyo/rbw/bedwars/BedwarsAPIManager.java`
- [Arena maps](https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/plugin/src/main/java/com/deyo/rbw/managers/MapManager.java): `plugin/src/main/java/com/deyo/rbw/managers/MapManager.java`
- [Plugin WebSocket](https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/plugin/src/main/java/com/deyo/rbw/managers/WebSocketManager.java): `plugin/src/main/java/com/deyo/rbw/managers/WebSocketManager.java`
- [Game data storage](https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/plugin/src/main/java/com/deyo/rbw/managers/GameDataManager.java): `plugin/src/main/java/com/deyo/rbw/managers/GameDataManager.java`
- [Server API client](https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/plugin/src/main/java/com/deyo/rbw/utils/APIClient.java): `plugin/src/main/java/com/deyo/rbw/utils/APIClient.java`

### Stats website

- [Stats pages](https://github.com/dreamrelaxv/rankedbedwarsv2/tree/main/web/app): `web/app`
- [API client](https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/web/lib/api.ts): `web/lib/api.ts`
- [Player search](https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/web/components/SearchBox.tsx): `web/components/SearchBox.tsx`

### Ranked game data

- [Game records](https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/bot/src/models/Game.ts): `bot/src/models/Game.ts`
- [Player records](https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/bot/src/models/User.ts): `bot/src/models/User.ts`
- [Season records](https://github.com/dreamrelaxv/rankedbedwarsv2/blob/main/bot/src/models/SeasonGames.ts): `bot/src/models/SeasonGames.ts`

### Other components

- **Players and moderators**
- **Discord**
- **Minecraft server**

## Connections

- Players and moderators → Command routing: invoke commands (evidence: `bot/src/managers/CommandManager.ts`)
- Command routing → Queue matchmaking: manage queues
- Queue matchmaking → Game lifecycle: create games (evidence: `bot/src/Matchmaking/PickingQueueManager.ts`)
- Game lifecycle → Game records: records games (evidence: `bot/src/Matchmaking/GameManager.ts`)
- Game lifecycle → Discord workers: creates channels (evidence: `bot/src/Matchmaking/GameManager.ts`)
- Game lifecycle → Player records: updates players (evidence: `bot/src/Matchmaking/GameManager.ts`)
- Queue matchmaking → Bot WebSocket: dispatches messages (evidence: `bot/src/Matchmaking/GameManager.ts`)
- Bot WebSocket → Minecraft server: WebSocket messages
- Minecraft server → Plugin WebSocket: WebSocket messages
- Plugin lifecycle → Plugin WebSocket: initializes (evidence: `plugin/src/main/java/com/deyo/rbw/RankedBedwars.java`)
- Plugin lifecycle → Game data storage: initializes (evidence: `plugin/src/main/java/com/deyo/rbw/RankedBedwars.java`)
- Plugin lifecycle → Arena maps: initializes (evidence: `plugin/src/main/java/com/deyo/rbw/RankedBedwars.java`)
- Plugin lifecycle → BedWars adapter: initializes adapter (evidence: `plugin/src/main/java/com/deyo/rbw/RankedBedwars.java`)
- BedWars adapter → Minecraft server: detects server plugins (evidence: `plugin/src/main/java/com/deyo/rbw/bedwars/BedwarsAPIManager.java`)
- Arena maps → BedWars adapter: queries adapter (evidence: `plugin/src/main/java/com/deyo/rbw/managers/MapManager.java`)
- Game data storage → Plugin lifecycle: uses plugin instance (evidence: `plugin/src/main/java/com/deyo/rbw/managers/GameDataManager.java`)
- Plugin WebSocket → Game records: handles game messages (evidence: `plugin/src/main/java/com/deyo/rbw/managers/WebSocketManager.java`)
- Stats API → Player records: queries players (evidence: `bot/src/api/ApiManager.ts`)
- Stats API → Game records: serves game data (evidence: `bot/src/api/ApiManager.ts`)
- Stats API → Season records: serves season data (evidence: `bot/src/api/ApiManager.ts`)
- Season management → Season records: queries season games (evidence: `bot/src/managers/SeasonManager.ts`)
- Season management → Player records: uses player records (evidence: `bot/src/managers/SeasonManager.ts`)
- Command routing → Season management: routes season commands
- Stats pages → API client: requests statistics (evidence: `web/app/player/page.tsx`)
- Player search → API client: searches players
- API client → Stats API: HTTP requests
- Bot configuration → Game lifecycle: configures behavior (evidence: `bot/src/Matchmaking/GameManager.ts`)
