# glavtoy/glavtoygame architecture

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

- Interactive diagram: https://gitdiagram.com/glavtoy/glavtoygame
- Repository: https://github.com/glavtoy/glavtoygame

## Overview

GlavtoyGame is a Bukkit minigame plugin: players join configured arenas, wait for enough participants, play timed combat rounds, and return to the lobby with results. The map separates arena lifecycle, player interaction, persisted player data, and player-facing presentation. Sampled code shows arena joins, countdown behavior, combat rewards, and round completion; several listener and menu relationships are inferred only from the SOURCE INDEX, so those edges are marked unverified where appropriate.

Main entry points: [`src/main/java/ru/glavtoy/glavtoygame/game/Game.java`](https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/game/Game.java) (Arena State And Rules), [`src/main/java/ru/glavtoy/glavtoygame/GlavtoyGame.java`](https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/GlavtoyGame.java) (Plugin Setup), [`src/main/java/ru/glavtoy/glavtoygame/listener/GameListener.java`](https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/listener/GameListener.java) (Game Events), [`src/main/java/ru/glavtoy/glavtoygame/data/Data.java`](https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/data/Data.java) (Player Statistics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Plugin Runtime"]
  node_plugin["Plugin Setup<br/>[GlavtoyGame.java]"]
end

subgraph group_arenas["Arena Gameplay"]
  node_manager["Arena Registry<br/>[GameManager.java]"]
  node_game["Arena State And Rules<br/>[Game.java]"]
  node_countdown["Round Countdown"]
  node_waiting["Waiting Updates"]
  node_gamerun["Combat Round<br/>[GameRunnable.java]"]
  node_lobbyrun["Main Lobby Updates"]
end

subgraph group_interaction["Player Interaction"]
  node_admin["Admin Commands<br/>[CommandAdmin.java]"]
  node_playcommand["Play Command<br/>[CommandPlay.java]"]
  node_listeners["Game Events<br/>[GameListener.java]"]
  node_lobbyevents["Lobby Events"]
  node_shoplistener["Shop Events"]
  node_otherlisteners["Item And Data Events"]
  node_leaveitem["Leave Item<br/>[LeaveItem.java]"]
  node_shop["Game Shop<br/>[ShopMenu.java]"]
  node_lobbyshop["Lobby Shop"]
  node_shopitems["Shop Items<br/>[OpenShopItem.java]"]
  node_lobbyshopitems["Lobby Shop Items"]
end

subgraph group_state["Player State"]
  node_data["Player Statistics<br/>[Data.java]"]
  node_yaml[("YAML Files")]
  node_level["Level Configuration<br/>[Level.java]"]
end

subgraph group_presentation["Player Presentation"]
  node_gamescore["Game Scoreboard"]
  node_waitscore["Waiting Scoreboard"]
  node_mainscore["Main Lobby Scoreboard"]
  node_colors["Chat Formatting<br/>[ColorUtil.java]"]
end

node_players(("Players"))

node_players -.->|"join via"| node_playcommand
node_players -.->|"trigger events"| node_listeners
node_plugin -.->|"register arenas"| node_manager
node_plugin -->|"initialize"| node_shop
node_plugin -.->|"register command"| node_admin
node_plugin -.->|"register command"| node_playcommand
node_plugin -.->|"register events"| node_listeners
node_playcommand -->|"join arena"| node_game
node_playcommand -->|"find free arena"| node_manager
node_admin -->|"configure arena"| node_game
node_manager -->|"track arenas"| node_game
node_game -->|"start waiting"| node_waiting
node_countdown -->|"restart waiting"| node_waiting
node_countdown -.->|"start round"| node_gamerun
node_gamerun -->|"update round state"| node_game
node_gamerun -->|"award experience"| node_data
node_listeners -->|"update combat state"| node_game
node_listeners -->|"record kills"| node_data
node_listeners -->|"update score snapshots"| node_gamescore
node_lobbyevents -.->|"handle lobby actions"| node_game
node_shoplistener -.->|"handle shop actions"| node_shop
node_shoplistener -.->|"apply purchases"| node_game
node_shop -->|"build menu item"| node_shopitems
node_lobbyshop -->|"use item"| node_lobbyshopitems
node_game -->|"create leave item"| node_leaveitem
node_game -->|"refresh waiting display"| node_waitscore
node_game -.->|"refresh game display"| node_gamescore
node_gamerun -->|"restore lobby display"| node_mainscore
node_waiting -->|"update countdown display"| node_waitscore
node_lobbyrun -.->|"update lobby state"| node_game
node_mainscore -->|"read player stats"| node_data
node_plugin -->|"load and save"| node_yaml
node_data -->|"persist statistics"| node_yaml
node_plugin -.->|"load level settings"| node_level
node_otherlisteners -.->|"handle player data"| node_data
node_game -.->|"format messages"| node_colors
node_shop -->|"format menu text"| node_colors

click node_plugin "https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/GlavtoyGame.java"
click node_admin "https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/command/CommandAdmin.java"
click node_playcommand "https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/command/CommandPlay.java"
click node_listeners "https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/listener/GameListener.java"
click node_lobbyevents "https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/listener/LobbysListener.java"
click node_shoplistener "https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/listener/ShopMenuListener.java"
click node_otherlisteners "https://github.com/glavtoy/glavtoygame/tree/master/src/main/java/ru/glavtoy/glavtoygame/listener"
click node_manager "https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/game/GameManager.java"
click node_game "https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/game/Game.java"
click node_countdown "https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/runnable/CountdownRunnable.java"
click node_waiting "https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/runnable/WaitingRunnable.java"
click node_gamerun "https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/runnable/GameRunnable.java"
click node_lobbyrun "https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/runnable/MainLobbyRunnable.java"
click node_leaveitem "https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/game/LeaveItem.java"
click node_data "https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/data/Data.java"
click node_shop "https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/menu/ShopMenu.java"
click node_lobbyshop "https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/menu/MainLobbyShopMenu.java"
click node_shopitems "https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/menu/OpenShopItem.java"
click node_lobbyshopitems "https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/menu/OpenMainLobbyShopItem.java"
click node_level "https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/level/Level.java"
click node_gamescore "https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/scoreboard/GameScoreboard.java"
click node_waitscore "https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/scoreboard/WaitingLobbyScoreboard.java"
click node_mainscore "https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/scoreboard/MainLobbyScoreboard.java"
click node_colors "https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/util/ColorUtil.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 toneBlue
class node_manager,node_game,node_countdown,node_waiting,node_gamerun,node_lobbyrun toneAmber
class node_admin,node_playcommand,node_listeners,node_lobbyevents,node_shoplistener,node_otherlisteners,node_leaveitem,node_shop,node_lobbyshop,node_shopitems,node_lobbyshopitems toneMint
class node_data,node_yaml,node_level toneRose
class node_gamescore,node_waitscore,node_mainscore,node_colors,node_players toneIndigo
```

## Components

### Plugin Runtime

- [Plugin Setup](https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/GlavtoyGame.java): `src/main/java/ru/glavtoy/glavtoygame/GlavtoyGame.java`

### Arena Gameplay

- [Arena Registry](https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/game/GameManager.java): `src/main/java/ru/glavtoy/glavtoygame/game/GameManager.java`
- [Arena State And Rules](https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/game/Game.java): `src/main/java/ru/glavtoy/glavtoygame/game/Game.java`
- [Round Countdown](https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/runnable/CountdownRunnable.java): `src/main/java/ru/glavtoy/glavtoygame/runnable/CountdownRunnable.java`
- [Waiting Updates](https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/runnable/WaitingRunnable.java): `src/main/java/ru/glavtoy/glavtoygame/runnable/WaitingRunnable.java`
- [Combat Round](https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/runnable/GameRunnable.java): `src/main/java/ru/glavtoy/glavtoygame/runnable/GameRunnable.java`
- [Main Lobby Updates](https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/runnable/MainLobbyRunnable.java): `src/main/java/ru/glavtoy/glavtoygame/runnable/MainLobbyRunnable.java`

### Player Interaction

- [Admin Commands](https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/command/CommandAdmin.java): `src/main/java/ru/glavtoy/glavtoygame/command/CommandAdmin.java`
- [Play Command](https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/command/CommandPlay.java): `src/main/java/ru/glavtoy/glavtoygame/command/CommandPlay.java`
- [Game Events](https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/listener/GameListener.java): `src/main/java/ru/glavtoy/glavtoygame/listener/GameListener.java`
- [Lobby Events](https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/listener/LobbysListener.java): `src/main/java/ru/glavtoy/glavtoygame/listener/LobbysListener.java`
- [Shop Events](https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/listener/ShopMenuListener.java): `src/main/java/ru/glavtoy/glavtoygame/listener/ShopMenuListener.java`
- [Item And Data Events](https://github.com/glavtoy/glavtoygame/tree/master/src/main/java/ru/glavtoy/glavtoygame/listener): `src/main/java/ru/glavtoy/glavtoygame/listener`
- [Leave Item](https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/game/LeaveItem.java): `src/main/java/ru/glavtoy/glavtoygame/game/LeaveItem.java`
- [Game Shop](https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/menu/ShopMenu.java): `src/main/java/ru/glavtoy/glavtoygame/menu/ShopMenu.java`
- [Lobby Shop](https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/menu/MainLobbyShopMenu.java): `src/main/java/ru/glavtoy/glavtoygame/menu/MainLobbyShopMenu.java`
- [Shop Items](https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/menu/OpenShopItem.java): `src/main/java/ru/glavtoy/glavtoygame/menu/OpenShopItem.java`
- [Lobby Shop Items](https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/menu/OpenMainLobbyShopItem.java): `src/main/java/ru/glavtoy/glavtoygame/menu/OpenMainLobbyShopItem.java`

### Player State

- [Player Statistics](https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/data/Data.java): `src/main/java/ru/glavtoy/glavtoygame/data/Data.java`
- **YAML Files**
- [Level Configuration](https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/level/Level.java): `src/main/java/ru/glavtoy/glavtoygame/level/Level.java`

### Player Presentation

- [Game Scoreboard](https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/scoreboard/GameScoreboard.java): `src/main/java/ru/glavtoy/glavtoygame/scoreboard/GameScoreboard.java`
- [Waiting Scoreboard](https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/scoreboard/WaitingLobbyScoreboard.java): `src/main/java/ru/glavtoy/glavtoygame/scoreboard/WaitingLobbyScoreboard.java`
- [Main Lobby Scoreboard](https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/scoreboard/MainLobbyScoreboard.java): `src/main/java/ru/glavtoy/glavtoygame/scoreboard/MainLobbyScoreboard.java`
- [Chat Formatting](https://github.com/glavtoy/glavtoygame/blob/master/src/main/java/ru/glavtoy/glavtoygame/util/ColorUtil.java): `src/main/java/ru/glavtoy/glavtoygame/util/ColorUtil.java`

### Other components

- **Players**

## Connections

- Players → Play Command: join via
- Players → Game Events: trigger events
- Plugin Setup → Arena Registry: register arenas (evidence: `src/main/java/ru/glavtoy/glavtoygame/GlavtoyGame.java`)
- Plugin Setup → Game Shop: initialize (evidence: `src/main/java/ru/glavtoy/glavtoygame/GlavtoyGame.java`)
- Plugin Setup → Admin Commands: register command (evidence: `src/main/java/ru/glavtoy/glavtoygame/GlavtoyGame.java`)
- Plugin Setup → Play Command: register command (evidence: `src/main/java/ru/glavtoy/glavtoygame/GlavtoyGame.java`)
- Plugin Setup → Game Events: register events (evidence: `src/main/java/ru/glavtoy/glavtoygame/GlavtoyGame.java`)
- Play Command → Arena State And Rules: join arena (evidence: `src/main/java/ru/glavtoy/glavtoygame/command/CommandPlay.java`)
- Play Command → Arena Registry: find free arena (evidence: `src/main/java/ru/glavtoy/glavtoygame/command/CommandPlay.java`)
- Admin Commands → Arena State And Rules: configure arena (evidence: `src/main/java/ru/glavtoy/glavtoygame/command/CommandAdmin.java`)
- Arena Registry → Arena State And Rules: track arenas (evidence: `src/main/java/ru/glavtoy/glavtoygame/game/GameManager.java`)
- Arena State And Rules → Waiting Updates: start waiting (evidence: `src/main/java/ru/glavtoy/glavtoygame/game/Game.java`)
- Round Countdown → Waiting Updates: restart waiting (evidence: `src/main/java/ru/glavtoy/glavtoygame/runnable/CountdownRunnable.java`)
- Round Countdown → Combat Round: start round (evidence: `src/main/java/ru/glavtoy/glavtoygame/runnable/CountdownRunnable.java`)
- Combat Round → Arena State And Rules: update round state (evidence: `src/main/java/ru/glavtoy/glavtoygame/runnable/GameRunnable.java`)
- Combat Round → Player Statistics: award experience (evidence: `src/main/java/ru/glavtoy/glavtoygame/runnable/GameRunnable.java`)
- Game Events → Arena State And Rules: update combat state (evidence: `src/main/java/ru/glavtoy/glavtoygame/listener/GameListener.java`)
- Game Events → Player Statistics: record kills (evidence: `src/main/java/ru/glavtoy/glavtoygame/listener/GameListener.java`)
- Game Events → Game Scoreboard: update score snapshots (evidence: `src/main/java/ru/glavtoy/glavtoygame/listener/GameListener.java`)
- Lobby Events → Arena State And Rules: handle lobby actions (evidence: `src/main/java/ru/glavtoy/glavtoygame/listener/LobbysListener.java`)
- Shop Events → Game Shop: handle shop actions
- Shop Events → Arena State And Rules: apply purchases (evidence: `src/main/java/ru/glavtoy/glavtoygame/listener/ShopMenuListener.java`)
- Game Shop → Shop Items: build menu item (evidence: `src/main/java/ru/glavtoy/glavtoygame/menu/ShopMenu.java`)
- Lobby Shop → Lobby Shop Items: use item (evidence: `src/main/java/ru/glavtoy/glavtoygame/menu/MainLobbyShopMenu.java`)
- Arena State And Rules → Leave Item: create leave item (evidence: `src/main/java/ru/glavtoy/glavtoygame/game/Game.java`)
- Arena State And Rules → Waiting Scoreboard: refresh waiting display (evidence: `src/main/java/ru/glavtoy/glavtoygame/game/Game.java`)
- Arena State And Rules → Game Scoreboard: refresh game display (evidence: `src/main/java/ru/glavtoy/glavtoygame/game/Game.java`)
- Combat Round → Main Lobby Scoreboard: restore lobby display (evidence: `src/main/java/ru/glavtoy/glavtoygame/runnable/GameRunnable.java`)
- Waiting Updates → Waiting Scoreboard: update countdown display (evidence: `src/main/java/ru/glavtoy/glavtoygame/runnable/WaitingRunnable.java`)
- Main Lobby Updates → Arena State And Rules: update lobby state (evidence: `src/main/java/ru/glavtoy/glavtoygame/runnable/MainLobbyRunnable.java`)
- Main Lobby Scoreboard → Player Statistics: read player stats (evidence: `src/main/java/ru/glavtoy/glavtoygame/scoreboard/MainLobbyScoreboard.java`)
- Plugin Setup → YAML Files: load and save (evidence: `src/main/java/ru/glavtoy/glavtoygame/GlavtoyGame.java`)
- Player Statistics → YAML Files: persist statistics (evidence: `src/main/java/ru/glavtoy/glavtoygame/data/Data.java`)
- Plugin Setup → Level Configuration: load level settings
- Item And Data Events → Player Statistics: handle player data (evidence: `src/main/java/ru/glavtoy/glavtoygame/listener/GameListener.java`)
- Arena State And Rules → Chat Formatting: format messages (evidence: `src/main/java/ru/glavtoy/glavtoygame/game/Game.java`)
- Game Shop → Chat Formatting: format menu text (evidence: `src/main/java/ru/glavtoy/glavtoygame/menu/ShopMenu.java`)
