# bondegaard/02104-breakout architecture

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

- Interactive diagram: https://gitdiagram.com/bondegaard/02104-breakout
- Repository: https://github.com/bondegaard/02104-breakout

## Overview

This JavaFX repository contains two Breakout games: a basic implementation and a feature-rich advanced one. In both, a player starts a game, steers the paddle, and bounces a ball to clear blocks; the advanced game adds levels, power-ups, settings, and persistent scores. The graph shows the main gameplay and advanced features, with the basic variant kept separate. Relationships are limited to calls or references visible in the supplied excerpts, SOURCE INDEX, or README; unsampled menu and gameplay details are not inferred.

Main entry points: [`breakout-advance/src/breakoutadvance/persistentdata/DataManager.java`](https://github.com/bondegaard/02104-breakout/blob/main/breakout-advance/src/breakoutadvance/persistentdata/DataManager.java) (Saved scores and settings), [`breakout-basic/src/breakoutbasic/scenes/PlayScene.java`](https://github.com/bondegaard/02104-breakout/blob/main/breakout-basic/src/breakoutbasic/scenes/PlayScene.java) (Basic play scene), [`breakout-advance/src/breakoutadvance/Breakout.java`](https://github.com/bondegaard/02104-breakout/blob/main/breakout-advance/src/breakoutadvance/Breakout.java) (Advanced app), [`breakout-advance/src/breakoutadvance/core/Game.java`](https://github.com/bondegaard/02104-breakout/blob/main/breakout-advance/src/breakoutadvance/core/Game.java) (Game state and rules)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_basic["Basic game"]
  node_basic_app["Basic app<br/>[Breakout.java]"]
  node_basic_loop["Basic game loop<br/>[GameLoop.java]"]
  node_basic_play["Basic play scene<br/>[PlayScene.java]"]
  node_basic_grid["Basic block grid<br/>[Grid.java]"]
  node_basic_ball["Basic ball<br/>[Ball.java]"]
  node_basic_outcomes["Basic end scenes"]
end

subgraph group_advanced["Advanced game"]
  node_advance_app["Advanced app<br/>[Breakout.java]"]
  node_menus["Menus and settings"]
end

subgraph group_gameplay["Advanced gameplay"]
  node_advance_play["Advanced play scene<br/>[PlayScene.java]"]
  node_game["Game state and rules<br/>[Game.java]"]
  node_grid["Block grid<br/>[Grid.java]"]
  node_ball["Ball and entities<br/>[Ball.java]"]
  node_blocks["Blocks<br/>[Block.java]"]
end

subgraph group_content["Levels and effects"]
  node_levels["Level progression<br/>[LevelManager.java]"]
  node_level_data["Level definitions<br/>[Level.java]"]
  node_powerups["Power-up effects<br/>[PowerupType.java]"]
end

subgraph group_support["Persistence and assets"]
  node_persistence["Saved scores and settings<br/>[DataManager.java]"]
  node_saved_data["Persistent data model<br/>[Data.java]"]
  node_assets["Audio and visual assets<br/>[Images.java]"]
end

node_player(("Player"))
node_gson["Gson"]
node_save_file[("data/data.json")]

node_player -->|"plays"| node_basic_play
node_basic_app -->|"starts loop"| node_basic_loop
node_basic_app -->|"shows scene"| node_basic_play
node_basic_play -->|"creates grid"| node_basic_grid
node_basic_play -->|"creates and ticks"| node_basic_ball
node_basic_play -->|"selects outcome"| node_basic_outcomes
node_player -->|"navigates"| node_menus
node_advance_app -->|"shows menu"| node_menus
node_advance_app -->|"loads levels"| node_levels
node_advance_app -->|"loads data"| node_persistence
node_advance_app -->|"loads assets"| node_assets
node_player -->|"plays"| node_advance_play
node_advance_play -->|"updates gameplay"| node_game
node_game -->|"creates balls"| node_ball
node_game -->|"spawns effects"| node_powerups
node_game -->|"records high score"| node_persistence
node_levels -->|"gets Gson"| node_persistence
node_levels -->|"parses levels"| node_level_data
node_persistence -->|"serializes data"| node_saved_data
node_persistence -->|"uses"| node_gson
node_persistence -->|"reads and writes"| node_save_file

click node_basic_app "https://github.com/bondegaard/02104-breakout/blob/main/breakout-basic/src/breakoutbasic/Breakout.java"
click node_basic_loop "https://github.com/bondegaard/02104-breakout/blob/main/breakout-basic/src/breakoutbasic/loop/GameLoop.java"
click node_basic_play "https://github.com/bondegaard/02104-breakout/blob/main/breakout-basic/src/breakoutbasic/scenes/PlayScene.java"
click node_basic_grid "https://github.com/bondegaard/02104-breakout/blob/main/breakout-basic/src/breakoutbasic/grid/Grid.java"
click node_basic_ball "https://github.com/bondegaard/02104-breakout/blob/main/breakout-basic/src/breakoutbasic/objects/Ball.java"
click node_basic_outcomes "https://github.com/bondegaard/02104-breakout/tree/main/breakout-basic/src/breakoutbasic/scenes"
click node_advance_app "https://github.com/bondegaard/02104-breakout/blob/main/breakout-advance/src/breakoutadvance/Breakout.java"
click node_menus "https://github.com/bondegaard/02104-breakout/tree/main/breakout-advance/src/breakoutadvance/scenes/menus"
click node_advance_play "https://github.com/bondegaard/02104-breakout/blob/main/breakout-advance/src/breakoutadvance/scenes/PlayScene.java"
click node_game "https://github.com/bondegaard/02104-breakout/blob/main/breakout-advance/src/breakoutadvance/core/Game.java"
click node_grid "https://github.com/bondegaard/02104-breakout/blob/main/breakout-advance/src/breakoutadvance/core/Grid.java"
click node_ball "https://github.com/bondegaard/02104-breakout/blob/main/breakout-advance/src/breakoutadvance/objects/Ball.java"
click node_blocks "https://github.com/bondegaard/02104-breakout/blob/main/breakout-advance/src/breakoutadvance/objects/Block.java"
click node_levels "https://github.com/bondegaard/02104-breakout/blob/main/breakout-advance/src/breakoutadvance/levels/LevelManager.java"
click node_level_data "https://github.com/bondegaard/02104-breakout/blob/main/breakout-advance/src/breakoutadvance/levels/Level.java"
click node_powerups "https://github.com/bondegaard/02104-breakout/blob/main/breakout-advance/src/breakoutadvance/objects/powerups/PowerupType.java"
click node_persistence "https://github.com/bondegaard/02104-breakout/blob/main/breakout-advance/src/breakoutadvance/persistentdata/DataManager.java"
click node_saved_data "https://github.com/bondegaard/02104-breakout/blob/main/breakout-advance/src/breakoutadvance/persistentdata/data/Data.java"
click node_assets "https://github.com/bondegaard/02104-breakout/blob/main/breakout-advance/src/breakoutadvance/utils/Images.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_basic_app,node_basic_loop,node_basic_play,node_basic_grid,node_basic_ball,node_basic_outcomes toneBlue
class node_advance_app,node_menus,node_save_file toneAmber
class node_advance_play,node_game,node_grid,node_ball,node_blocks toneMint
class node_levels,node_level_data,node_powerups toneRose
class node_persistence,node_saved_data,node_assets,node_player,node_gson toneIndigo
```

## Components

### Basic game

- [Basic app](https://github.com/bondegaard/02104-breakout/blob/main/breakout-basic/src/breakoutbasic/Breakout.java): `breakout-basic/src/breakoutbasic/Breakout.java`
- [Basic game loop](https://github.com/bondegaard/02104-breakout/blob/main/breakout-basic/src/breakoutbasic/loop/GameLoop.java): `breakout-basic/src/breakoutbasic/loop/GameLoop.java`
- [Basic play scene](https://github.com/bondegaard/02104-breakout/blob/main/breakout-basic/src/breakoutbasic/scenes/PlayScene.java): `breakout-basic/src/breakoutbasic/scenes/PlayScene.java`
- [Basic block grid](https://github.com/bondegaard/02104-breakout/blob/main/breakout-basic/src/breakoutbasic/grid/Grid.java): `breakout-basic/src/breakoutbasic/grid/Grid.java`
- [Basic ball](https://github.com/bondegaard/02104-breakout/blob/main/breakout-basic/src/breakoutbasic/objects/Ball.java): `breakout-basic/src/breakoutbasic/objects/Ball.java`
- [Basic end scenes](https://github.com/bondegaard/02104-breakout/tree/main/breakout-basic/src/breakoutbasic/scenes): `breakout-basic/src/breakoutbasic/scenes`

### Advanced game

- [Advanced app](https://github.com/bondegaard/02104-breakout/blob/main/breakout-advance/src/breakoutadvance/Breakout.java): `breakout-advance/src/breakoutadvance/Breakout.java`
- [Menus and settings](https://github.com/bondegaard/02104-breakout/tree/main/breakout-advance/src/breakoutadvance/scenes/menus): `breakout-advance/src/breakoutadvance/scenes/menus`

### Advanced gameplay

- [Advanced play scene](https://github.com/bondegaard/02104-breakout/blob/main/breakout-advance/src/breakoutadvance/scenes/PlayScene.java): `breakout-advance/src/breakoutadvance/scenes/PlayScene.java`
- [Game state and rules](https://github.com/bondegaard/02104-breakout/blob/main/breakout-advance/src/breakoutadvance/core/Game.java): `breakout-advance/src/breakoutadvance/core/Game.java`
- [Block grid](https://github.com/bondegaard/02104-breakout/blob/main/breakout-advance/src/breakoutadvance/core/Grid.java): `breakout-advance/src/breakoutadvance/core/Grid.java`
- [Ball and entities](https://github.com/bondegaard/02104-breakout/blob/main/breakout-advance/src/breakoutadvance/objects/Ball.java): `breakout-advance/src/breakoutadvance/objects/Ball.java`
- [Blocks](https://github.com/bondegaard/02104-breakout/blob/main/breakout-advance/src/breakoutadvance/objects/Block.java): `breakout-advance/src/breakoutadvance/objects/Block.java`

### Levels and effects

- [Level progression](https://github.com/bondegaard/02104-breakout/blob/main/breakout-advance/src/breakoutadvance/levels/LevelManager.java): `breakout-advance/src/breakoutadvance/levels/LevelManager.java`
- [Level definitions](https://github.com/bondegaard/02104-breakout/blob/main/breakout-advance/src/breakoutadvance/levels/Level.java): `breakout-advance/src/breakoutadvance/levels/Level.java`
- [Power-up effects](https://github.com/bondegaard/02104-breakout/blob/main/breakout-advance/src/breakoutadvance/objects/powerups/PowerupType.java): `breakout-advance/src/breakoutadvance/objects/powerups/PowerupType.java`

### Persistence and assets

- [Saved scores and settings](https://github.com/bondegaard/02104-breakout/blob/main/breakout-advance/src/breakoutadvance/persistentdata/DataManager.java): `breakout-advance/src/breakoutadvance/persistentdata/DataManager.java`
- [Persistent data model](https://github.com/bondegaard/02104-breakout/blob/main/breakout-advance/src/breakoutadvance/persistentdata/data/Data.java): `breakout-advance/src/breakoutadvance/persistentdata/data/Data.java`
- [Audio and visual assets](https://github.com/bondegaard/02104-breakout/blob/main/breakout-advance/src/breakoutadvance/utils/Images.java): `breakout-advance/src/breakoutadvance/utils/Images.java`

### Other components

- **Player**
- **Gson**
- **data/data.json**

## Connections

- Player → Basic play scene: plays (evidence: `breakout-basic/src/breakoutbasic/scenes/PlayScene.java`)
- Basic app → Basic game loop: starts loop (evidence: `breakout-basic/src/breakoutbasic/Breakout.java`)
- Basic app → Basic play scene: shows scene (evidence: `breakout-basic/src/breakoutbasic/Breakout.java`)
- Basic play scene → Basic block grid: creates grid (evidence: `breakout-basic/src/breakoutbasic/scenes/PlayScene.java`)
- Basic play scene → Basic ball: creates and ticks (evidence: `breakout-basic/src/breakoutbasic/scenes/PlayScene.java`)
- Basic play scene → Basic end scenes: selects outcome (evidence: `breakout-basic/src/breakoutbasic/scenes/PlayScene.java`)
- Player → Menus and settings: navigates
- Advanced app → Menus and settings: shows menu (evidence: `breakout-advance/src/breakoutadvance/Breakout.java`)
- Advanced app → Level progression: loads levels (evidence: `breakout-advance/src/breakoutadvance/Breakout.java`)
- Advanced app → Saved scores and settings: loads data (evidence: `breakout-advance/src/breakoutadvance/Breakout.java`)
- Advanced app → Audio and visual assets: loads assets (evidence: `breakout-advance/src/breakoutadvance/Breakout.java`)
- Player → Advanced play scene: plays (evidence: `breakout-advance/src/breakoutadvance/scenes/PlayScene.java`)
- Advanced play scene → Game state and rules: updates gameplay (evidence: `breakout-advance/src/breakoutadvance/scenes/PlayScene.java`)
- Game state and rules → Ball and entities: creates balls (evidence: `breakout-advance/src/breakoutadvance/core/Game.java`)
- Game state and rules → Power-up effects: spawns effects (evidence: `breakout-advance/src/breakoutadvance/core/Game.java`)
- Game state and rules → Saved scores and settings: records high score (evidence: `breakout-advance/src/breakoutadvance/core/Game.java`)
- Level progression → Saved scores and settings: gets Gson (evidence: `breakout-advance/src/breakoutadvance/levels/LevelManager.java`)
- Level progression → Level definitions: parses levels (evidence: `breakout-advance/src/breakoutadvance/levels/LevelManager.java`)
- Saved scores and settings → Persistent data model: serializes data (evidence: `breakout-advance/src/breakoutadvance/persistentdata/DataManager.java`)
- Saved scores and settings → Gson: uses (evidence: `breakout-advance/src/breakoutadvance/persistentdata/DataManager.java`)
- Saved scores and settings → data/data.json: reads and writes (evidence: `breakout-advance/src/breakoutadvance/persistentdata/DataManager.java`)
