# nulvoramc/nulvorasw architecture

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

- Interactive diagram: https://gitdiagram.com/nulvoramc/nulvorasw
- Repository: https://github.com/nulvoramc/nulvorasw

## Overview

SkyWarsReloaded is a Bukkit/Spigot plugin that runs configurable SkyWars matches on Minecraft servers. The player-facing path is command or menu interaction into arena selection and match management, followed by gameplay, results and statistics persistence. Administrators also configure maps, kits, chests and match options; the repository includes leaderboard, event, world-management and version-specific NMS support. The graph reflects the tree and the supplied excerpts; dashed links indicate plausible runtime wiring that those excerpts do not establish.

Main entry points: [`SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/SkyWarsReloaded.java`](https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/SkyWarsReloaded.java) (Plugin lifecycle), [`SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/managers/MatchManager.java`](https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/managers/MatchManager.java) (Match lifecycle), [`SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/commands/MainCmdManager.java`](https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/commands/MainCmdManager.java) (Command routing), [`SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/database/DataStorage.java`](https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/database/DataStorage.java) (Player data storage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Plugin entry"]
  node_plugin["Plugin lifecycle"]
  node_commands["Command routing"]
  node_basecmd["Command processing<br/>[BaseCmd.java]"]
  node_config["Plugin configuration<br/>[Config.java]"]
end

subgraph group_game["Match runtime"]
  node_maps["Map registry"]
  node_map["Arena map<br/>[GameMap.java]"]
  node_matches["Match lifecycle<br/>[MatchManager.java]"]
  node_match_events["Match events<br/>[MatchEvent.java]"]
  node_player_data["Player state<br/>[PlayerData.java]"]
end

subgraph group_operations["Administration and UI"]
  node_menus["Game menus"]
  node_menu_events["Menu interaction"]
  node_kits["Kit definitions<br/>[GameKit.java]"]
end

subgraph group_platform["Persistence and platform"]
  node_storage["Player data storage<br/>[DataStorage.java]"]
  node_database[("SQL database<br/>[Database.java]")]
  node_stats["Player statistics<br/>[PlayerStat.java]"]
  node_worlds["Slime world adapters"]
  node_nms["Version-specific server access<br/>[NMSHandler.java]"]
  node_leaderboards["Leaderboards<br/>[Leaderboard.java]"]
  node_discord["Discord integration"]
end

node_players(("Players"))

node_players -.->|"invoke"| node_commands
node_commands -->|"dispatches"| node_basecmd
node_plugin -.->|"registers"| node_commands
node_plugin -.->|"loads"| node_config
node_commands -.->|"administers"| node_maps
node_commands -.->|"routes requests"| node_matches
node_players -.->|"selects options"| node_menus
node_menu_events -->|"dispatches clicks"| node_menus
node_maps -.->|"manages"| node_map
node_matches -->|"uses arena"| node_map
node_matches -->|"uses events"| node_match_events
node_matches -.->|"tracks players"| node_player_data
node_matches -->|"uses kits"| node_kits
node_stats -->|"loads stats"| node_storage
node_storage -->|"reads and writes"| node_database
node_storage -->|"loads offline stats"| node_stats
node_plugin -->|"selects adapter"| node_worlds
node_plugin -->|"selects handler"| node_nms
node_leaderboards -.->|"reads results"| node_storage
node_plugin -->|"enables hook"| node_discord

click node_plugin "https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/SkyWarsReloaded.java"
click node_commands "https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/commands/MainCmdManager.java"
click node_basecmd "https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/commands/BaseCmd.java"
click node_config "https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/config/Config.java"
click node_maps "https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/managers/GameMapManager.java"
click node_map "https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/game/GameMap.java"
click node_matches "https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/managers/MatchManager.java"
click node_match_events "https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/matchevents/MatchEvent.java"
click node_player_data "https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/game/PlayerData.java"
click node_menus "https://github.com/nulvoramc/nulvorasw/tree/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/menus"
click node_menu_events "https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/listeners/IconMenuController.java"
click node_kits "https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/menus/gameoptions/objects/GameKit.java"
click node_storage "https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/database/DataStorage.java"
click node_database "https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/database/Database.java"
click node_stats "https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/managers/PlayerStat.java"
click node_worlds "https://github.com/nulvoramc/nulvorasw/blob/master/slime-asp/src/main/java/com/walrusone/skywarsreloaded/managers/worlds/ASPWorldManagerImpl.java"
click node_nms "https://github.com/nulvoramc/nulvorasw/blob/master/v1_8_R3/src/main/java/com/walrusone/skywarsreloaded/nms/v1_8_R3/NMSHandler.java"
click node_leaderboards "https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/managers/Leaderboard.java"
click node_discord "https://github.com/nulvoramc/nulvorasw/blob/master/nulvora-hook/src/main/java/com/walrusone/skywarsreloaded/nulvora/discord/SkywarsDiscordCommand.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_plugin,node_commands,node_basecmd,node_config toneBlue
class node_maps,node_map,node_matches,node_match_events,node_player_data toneAmber
class node_menus,node_menu_events,node_kits toneMint
class node_storage,node_database,node_stats,node_worlds,node_nms,node_leaderboards,node_discord toneRose
class node_players toneIndigo
```

## Components

### Plugin entry

- [Plugin lifecycle](https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/SkyWarsReloaded.java): `SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/SkyWarsReloaded.java`
- [Command routing](https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/commands/MainCmdManager.java): `SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/commands/MainCmdManager.java`
- [Command processing](https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/commands/BaseCmd.java): `SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/commands/BaseCmd.java`
- [Plugin configuration](https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/config/Config.java): `SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/config/Config.java`

### Match runtime

- [Map registry](https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/managers/GameMapManager.java): `SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/managers/GameMapManager.java`
- [Arena map](https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/game/GameMap.java): `SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/game/GameMap.java`
- [Match lifecycle](https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/managers/MatchManager.java): `SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/managers/MatchManager.java`
- [Match events](https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/matchevents/MatchEvent.java): `SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/matchevents/MatchEvent.java`
- [Player state](https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/game/PlayerData.java): `SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/game/PlayerData.java`

### Administration and UI

- [Game menus](https://github.com/nulvoramc/nulvorasw/tree/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/menus): `SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/menus`
- [Menu interaction](https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/listeners/IconMenuController.java): `SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/listeners/IconMenuController.java`
- [Kit definitions](https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/menus/gameoptions/objects/GameKit.java): `SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/menus/gameoptions/objects/GameKit.java`

### Persistence and platform

- [Player data storage](https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/database/DataStorage.java): `SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/database/DataStorage.java`
- [SQL database](https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/database/Database.java): `SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/database/Database.java`
- [Player statistics](https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/managers/PlayerStat.java): `SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/managers/PlayerStat.java`
- [Slime world adapters](https://github.com/nulvoramc/nulvorasw/blob/master/slime-asp/src/main/java/com/walrusone/skywarsreloaded/managers/worlds/ASPWorldManagerImpl.java): `slime-asp/src/main/java/com/walrusone/skywarsreloaded/managers/worlds/ASPWorldManagerImpl.java`
- [Version-specific server access](https://github.com/nulvoramc/nulvorasw/blob/master/v1_8_R3/src/main/java/com/walrusone/skywarsreloaded/nms/v1_8_R3/NMSHandler.java): `v1_8_R3/src/main/java/com/walrusone/skywarsreloaded/nms/v1_8_R3/NMSHandler.java`
- [Leaderboards](https://github.com/nulvoramc/nulvorasw/blob/master/SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/managers/Leaderboard.java): `SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/managers/Leaderboard.java`
- [Discord integration](https://github.com/nulvoramc/nulvorasw/blob/master/nulvora-hook/src/main/java/com/walrusone/skywarsreloaded/nulvora/discord/SkywarsDiscordCommand.java): `nulvora-hook/src/main/java/com/walrusone/skywarsreloaded/nulvora/discord/SkywarsDiscordCommand.java`

### Other components

- **Players**

## Connections

- Players → Command routing: invoke
- Command routing → Command processing: dispatches (evidence: `SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/commands/MainCmdManager.java`)
- Plugin lifecycle → Command routing: registers (evidence: `SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/SkyWarsReloaded.java`)
- Plugin lifecycle → Plugin configuration: loads (evidence: `SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/SkyWarsReloaded.java`)
- Command routing → Map registry: administers
- Command routing → Match lifecycle: routes requests
- Players → Game menus: selects options
- Menu interaction → Game menus: dispatches clicks (evidence: `SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/listeners/IconMenuController.java`)
- Map registry → Arena map: manages
- Match lifecycle → Arena map: uses arena (evidence: `SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/managers/MatchManager.java`)
- Match lifecycle → Match events: uses events (evidence: `SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/managers/MatchManager.java`)
- Match lifecycle → Player state: tracks players (evidence: `SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/managers/MatchManager.java`)
- Match lifecycle → Kit definitions: uses kits (evidence: `SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/managers/MatchManager.java`)
- Player statistics → Player data storage: loads stats (evidence: `SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/managers/PlayerStat.java`)
- Player data storage → SQL database: reads and writes (evidence: `SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/database/DataStorage.java`)
- Player data storage → Player statistics: loads offline stats (evidence: `SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/database/DataStorage.java`)
- Plugin lifecycle → Slime world adapters: selects adapter (evidence: `SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/SkyWarsReloaded.java`)
- Plugin lifecycle → Version-specific server access: selects handler (evidence: `v1_8_R3/src/main/java/com/walrusone/skywarsreloaded/nms/v1_8_R3/NMSHandler.java`)
- Leaderboards → Player data storage: reads results
- Plugin lifecycle → Discord integration: enables hook (evidence: `SkyWarsReloadedCore/src/main/java/com/walrusone/skywarsreloaded/SkyWarsReloaded.java`)
