# amadejpapez/bomb-it architecture

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

- Interactive diagram: https://gitdiagram.com/amadejpapez/bomb-it
- Repository: https://github.com/amadejpapez/bomb-it

## Overview

Bomb It is a local multiplayer bomber-style game built with libGDX. The main player journey is launch to menu, configure a match, choose characters, play either Arcade or Tile Tag, then view local leaderboard results. Gameplay combines a grid, player movement and bomb effects; the README also documents bots, bonuses, obstacles, respawning, and both mode-specific win conditions. The graph uses the supplied excerpts and SOURCE INDEX; some capability links are documented in the README, while unsampled implementation details are left unasserted.

Main entry points: [`core/src/com/amadejpapez/bombit/screen/GameScreen.java`](https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/screen/GameScreen.java) (Match screen), [`core/src/com/amadejpapez/bombit/Player.java`](https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/Player.java) (Player), [`core/src/com/amadejpapez/bombit/screen/SettingsScreen.java`](https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/screen/SettingsScreen.java) (Match settings), [`core/src/com/amadejpapez/bombit/CellActor.java`](https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/CellActor.java) (Grid cells)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application flow"]
  node_launch["Game bootstrap<br/>[BombIt.java]"]
  node_intro["Intro screen<br/>[IntroScreen.java]"]
  node_menu["Main menu<br/>[MenuScreen.java]"]
  node_settings["Match settings"]
  node_character["Character selection"]
  node_pause["Pause screen<br/>[PauseScreen.java]"]
end

subgraph group_game["Match gameplay"]
  node_player_actor["Player<br/>[Player.java]"]
  node_game_screen["Match screen<br/>[GameScreen.java]"]
  node_grid["Grid cells<br/>[CellActor.java]"]
  node_cell_state["Cell types<br/>[CellState.java]"]
  node_bombs["Bomb mechanics<br/>[Bomb.java]"]
end

subgraph group_state["Game state"]
  node_manager["Match manager<br/>[GameManager.java]"]
  node_config["Game rules<br/>[GameConfig.java]"]
  node_local_prefs[("Local preferences")]
end

subgraph group_presentation["Assets and results"]
  node_leaderboard["Leaderboard screen"]
  node_result["Match result<br/>[Result.java]"]
  node_assets["Game assets<br/>[Assets.java]"]
  node_local_results[("Local leaderboard data")]
end

node_gamer(("Local players"))

node_launch -->|"loads"| node_assets
node_launch -->|"opens"| node_intro
node_intro -->|"opens"| node_menu
node_menu -->|"starts setup"| node_settings
node_menu -.->|"opens"| node_leaderboard
node_settings -->|"updates settings"| node_manager
node_settings -.->|"continues setup"| node_character
node_character -.->|"starts match"| node_game_screen
node_gamer -->|"provides input"| node_game_screen
node_game_screen -->|"reads match state"| node_manager
node_game_screen -->|"routes movement"| node_player_actor
node_player_actor -->|"checks cells"| node_grid
node_player_actor -->|"updates tiles"| node_game_screen
node_game_screen -.->|"updates bombs"| node_bombs
node_bombs -->|"hits players"| node_player_actor
node_bombs -->|"clears obstacles"| node_grid
node_grid -->|"uses states"| node_cell_state
node_game_screen -->|"builds board"| node_config
node_settings -.->|"persists options"| node_local_prefs
node_manager -->|"loads options"| node_local_prefs
node_game_screen -->|"opens pause"| node_pause
node_pause -.->|"resumes match"| node_game_screen
node_leaderboard -->|"creates results"| node_result
node_leaderboard -->|"reads and writes"| node_local_results
node_game_screen -.->|"records finish"| node_leaderboard
node_grid -->|"renders sprites"| node_assets
node_game_screen -->|"uses interface assets"| node_assets
node_player_actor -->|"reads match state"| node_manager

click node_player_actor "https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/Player.java"
click node_launch "https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/BombIt.java"
click node_intro "https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/screen/IntroScreen.java"
click node_menu "https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/screen/MenuScreen.java"
click node_settings "https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/screen/SettingsScreen.java"
click node_character "https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/screen/SelectCharacterScreen.java"
click node_game_screen "https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/screen/GameScreen.java"
click node_grid "https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/CellActor.java"
click node_cell_state "https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/CellState.java"
click node_bombs "https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/Bomb.java"
click node_manager "https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/GameManager.java"
click node_config "https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/config/GameConfig.java"
click node_pause "https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/screen/PauseScreen.java"
click node_leaderboard "https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/screen/LeaderboardScreen.java"
click node_result "https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/Result.java"
click node_assets "https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/assets/Assets.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_launch,node_intro,node_menu,node_settings,node_character,node_pause toneBlue
class node_player_actor,node_game_screen,node_grid,node_cell_state,node_bombs toneAmber
class node_manager,node_config,node_local_prefs toneMint
class node_leaderboard,node_result,node_assets,node_local_results toneRose
class node_gamer toneIndigo
```

## Components

### Application flow

- [Game bootstrap](https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/BombIt.java): `core/src/com/amadejpapez/bombit/BombIt.java`
- [Intro screen](https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/screen/IntroScreen.java): `core/src/com/amadejpapez/bombit/screen/IntroScreen.java`
- [Main menu](https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/screen/MenuScreen.java): `core/src/com/amadejpapez/bombit/screen/MenuScreen.java`
- [Match settings](https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/screen/SettingsScreen.java): `core/src/com/amadejpapez/bombit/screen/SettingsScreen.java`
- [Character selection](https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/screen/SelectCharacterScreen.java): `core/src/com/amadejpapez/bombit/screen/SelectCharacterScreen.java`
- [Pause screen](https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/screen/PauseScreen.java): `core/src/com/amadejpapez/bombit/screen/PauseScreen.java`

### Match gameplay

- [Player](https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/Player.java): `core/src/com/amadejpapez/bombit/Player.java`
- [Match screen](https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/screen/GameScreen.java): `core/src/com/amadejpapez/bombit/screen/GameScreen.java`
- [Grid cells](https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/CellActor.java): `core/src/com/amadejpapez/bombit/CellActor.java`
- [Cell types](https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/CellState.java): `core/src/com/amadejpapez/bombit/CellState.java`
- [Bomb mechanics](https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/Bomb.java): `core/src/com/amadejpapez/bombit/Bomb.java`

### Game state

- [Match manager](https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/GameManager.java): `core/src/com/amadejpapez/bombit/GameManager.java`
- [Game rules](https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/config/GameConfig.java): `core/src/com/amadejpapez/bombit/config/GameConfig.java`
- **Local preferences**

### Assets and results

- [Leaderboard screen](https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/screen/LeaderboardScreen.java): `core/src/com/amadejpapez/bombit/screen/LeaderboardScreen.java`
- [Match result](https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/Result.java): `core/src/com/amadejpapez/bombit/Result.java`
- [Game assets](https://github.com/amadejpapez/bomb-it/blob/main/core/src/com/amadejpapez/bombit/assets/Assets.java): `core/src/com/amadejpapez/bombit/assets/Assets.java`
- **Local leaderboard data**

### Other components

- **Local players**

## Connections

- Game bootstrap → Game assets: loads (evidence: `core/src/com/amadejpapez/bombit/BombIt.java`)
- Game bootstrap → Intro screen: opens (evidence: `core/src/com/amadejpapez/bombit/BombIt.java`)
- Intro screen → Main menu: opens (evidence: `core/src/com/amadejpapez/bombit/screen/IntroScreen.java`)
- Main menu → Match settings: starts setup (evidence: `core/src/com/amadejpapez/bombit/screen/MenuScreen.java`)
- Main menu → Leaderboard screen: opens (evidence: `core/src/com/amadejpapez/bombit/screen/MenuScreen.java`)
- Match settings → Match manager: updates settings (evidence: `core/src/com/amadejpapez/bombit/screen/SettingsScreen.java`)
- Match settings → Character selection: continues setup (evidence: `core/src/com/amadejpapez/bombit/screen/SettingsScreen.java`)
- Character selection → Match screen: starts match (evidence: `core/src/com/amadejpapez/bombit/screen/SelectCharacterScreen.java`)
- Local players → Match screen: provides input (evidence: `core/src/com/amadejpapez/bombit/screen/GameScreen.java`)
- Match screen → Match manager: reads match state (evidence: `core/src/com/amadejpapez/bombit/screen/GameScreen.java`)
- Match screen → Player: routes movement (evidence: `core/src/com/amadejpapez/bombit/screen/GameScreen.java`)
- Player → Grid cells: checks cells (evidence: `core/src/com/amadejpapez/bombit/Player.java`)
- Player → Match screen: updates tiles (evidence: `core/src/com/amadejpapez/bombit/Player.java`)
- Match screen → Bomb mechanics: updates bombs (evidence: `core/src/com/amadejpapez/bombit/screen/GameScreen.java`)
- Bomb mechanics → Player: hits players (evidence: `core/src/com/amadejpapez/bombit/Bomb.java`)
- Bomb mechanics → Grid cells: clears obstacles (evidence: `core/src/com/amadejpapez/bombit/Bomb.java`)
- Grid cells → Cell types: uses states (evidence: `core/src/com/amadejpapez/bombit/CellActor.java`)
- Match screen → Game rules: builds board (evidence: `core/src/com/amadejpapez/bombit/screen/GameScreen.java`)
- Match settings → Local preferences: persists options
- Match manager → Local preferences: loads options (evidence: `core/src/com/amadejpapez/bombit/GameManager.java`)
- Match screen → Pause screen: opens pause (evidence: `core/src/com/amadejpapez/bombit/screen/GameScreen.java`)
- Pause screen → Match screen: resumes match (evidence: `core/src/com/amadejpapez/bombit/screen/PauseScreen.java`)
- Leaderboard screen → Match result: creates results (evidence: `core/src/com/amadejpapez/bombit/screen/LeaderboardScreen.java`)
- Leaderboard screen → Local leaderboard data: reads and writes (evidence: `core/src/com/amadejpapez/bombit/screen/LeaderboardScreen.java`)
- Match screen → Leaderboard screen: records finish (evidence: `core/src/com/amadejpapez/bombit/screen/GameScreen.java`)
- Grid cells → Game assets: renders sprites (evidence: `core/src/com/amadejpapez/bombit/CellActor.java`)
- Match screen → Game assets: uses interface assets (evidence: `core/src/com/amadejpapez/bombit/screen/GameScreen.java`)
- Player → Match manager: reads match state (evidence: `core/src/com/amadejpapez/bombit/Player.java`)
