# aurel-2/spacebobble architecture

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

- Interactive diagram: https://gitdiagram.com/aurel-2/spacebobble
- Repository: https://github.com/aurel-2/spacebobble

## Overview

SpaceBobble is a JavaFX platform game prototype with solo, versus, cooperative multiplayer, and leaderboard screens. The main local-play path starts at the menu, enters a mode controller, and runs a world simulation; cooperative play instead connects a client to a socket server and exchanges game state. The graph retains documented game entities, level generation, scoring, and networking. Some controllers and networking code were only partially sampled, so uncertain links are omitted or shown as unverified.

Main entry points: [`src/main/java/com/bobble/spacebobble/core/GameWorld.java`](https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/core/GameWorld.java) (Game world), [`src/main/java/com/bobble/spacebobble/core/GameClient.java`](https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/core/GameClient.java) (Co-op game client), [`src/main/java/com/bobble/spacebobble/controller/SoloController.java`](https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/controller/SoloController.java) (Solo controller), [`src/main/java/com/bobble/spacebobble/controller/CoopController.java`](https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/controller/CoopController.java) (Co-op controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application and UI"]
  node_main["JavaFX entry<br/>[Main.java]"]
  node_menu["Main menu<br/>[MainMenu.java]"]
  node_menu_ctrl["Menu controller"]
  node_solo_ui["Solo screen<br/>[Solo.java]"]
  node_vs_ui["Versus screen<br/>[VS.java]"]
  node_coop_ui["Co-op screen<br/>[Coop.java]"]
  node_lb_ui["Leaderboard screen<br/>[Leaderboard.java]"]
  node_solo_ctrl["Solo controller"]
  node_vs_ctrl["Versus controller<br/>[VSController.java]"]
  node_coop_ctrl["Co-op controller"]
  node_lb_ctrl["Leaderboard controller"]
  node_visual["Visual manager<br/>[VisualManager.java]"]
end

subgraph group_play["Game simulation"]
  node_world["Game world<br/>[GameWorld.java]"]
  node_generator["Level generator"]
  node_bobble["Player character<br/>[Bobble.java]"]
  node_entities["Aliens and survivors"]
  node_blocks["Blocks and traps<br/>[Block.java]"]
end

subgraph group_support["Scores and resources"]
  node_score["Score model<br/>[Score.java]"]
  node_leaderboard["Leaderboard data<br/>[Leaderboard.java]"]
  node_resources["Resource manager"]
end

subgraph group_network["Co-op networking"]
  node_client["Co-op game client<br/>[GameClient.java]"]
  node_input["Co-op input<br/>[ClientInput.java]"]
  node_server["Game server<br/>[Server.java]"]
  node_handler["Client handler<br/>[ClientHandler.java]"]
  node_packets["Game packets<br/>[GamePacket.java]"]
end

node_player(("Player"))
node_remote(("Co-op server"))

node_player -->|"launches"| node_main
node_main -->|"shows"| node_menu
node_solo_ctrl -->|"runs"| node_world
node_vs_ctrl -->|"runs"| node_world
node_world -->|"creates levels"| node_generator
node_world -->|"creates"| node_bobble
node_world -->|"uses level blocks"| node_blocks
node_world -->|"updates"| node_score
node_solo_ctrl -->|"renders"| node_visual
node_visual -->|"loads leaderboard"| node_resources
node_resources -->|"loads and saves"| node_leaderboard
node_coop_ctrl -->|"creates"| node_client
node_coop_ctrl -.->|"connects to"| node_remote
node_input -->|"sends controls"| node_client
node_client -->|"exchanges state"| node_packets
node_server -->|"creates handlers"| node_handler
node_handler -->|"handles"| node_packets
node_client -.->|"communicates with"| node_server
node_world -.->|"updates"| node_entities

click node_main "https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/Main.java"
click node_menu "https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/ui/MainMenu.java"
click node_menu_ctrl "https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/controller/MenuController.java"
click node_solo_ui "https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/ui/Solo.java"
click node_vs_ui "https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/ui/VS.java"
click node_coop_ui "https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/ui/Coop.java"
click node_lb_ui "https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/ui/Leaderboard.java"
click node_solo_ctrl "https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/controller/SoloController.java"
click node_vs_ctrl "https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/controller/VSController.java"
click node_coop_ctrl "https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/controller/CoopController.java"
click node_lb_ctrl "https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/controller/LeaderboardController.java"
click node_visual "https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/gestion/VisualManager.java"
click node_world "https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/core/GameWorld.java"
click node_generator "https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/gestion/WorldGenerator.java"
click node_bobble "https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/core/entities/Bobble.java"
click node_entities "https://github.com/aurel-2/spacebobble/tree/main/src/main/java/com/bobble/spacebobble/core/entities"
click node_blocks "https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/core/world/Block.java"
click node_score "https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/core/scores/Score.java"
click node_leaderboard "https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/core/scores/Leaderboard.java"
click node_resources "https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/gestion/ResourceManager.java"
click node_client "https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/core/GameClient.java"
click node_input "https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/controller/service/ClientInput.java"
click node_server "https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/network/Server.java"
click node_handler "https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/network/ClientHandler.java"
click node_packets "https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/network/Packet/GamePacket.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_main,node_menu,node_menu_ctrl,node_solo_ui,node_vs_ui,node_coop_ui,node_lb_ui,node_solo_ctrl,node_vs_ctrl,node_coop_ctrl,node_lb_ctrl,node_visual toneBlue
class node_world,node_generator,node_bobble,node_entities,node_blocks toneAmber
class node_score,node_leaderboard,node_resources,node_remote toneMint
class node_client,node_input,node_server,node_handler,node_packets toneRose
class node_player toneIndigo
```

## Components

### Application and UI

- [JavaFX entry](https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/Main.java): `src/main/java/com/bobble/spacebobble/Main.java`
- [Main menu](https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/ui/MainMenu.java): `src/main/java/com/bobble/spacebobble/ui/MainMenu.java`
- [Menu controller](https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/controller/MenuController.java): `src/main/java/com/bobble/spacebobble/controller/MenuController.java`
- [Solo screen](https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/ui/Solo.java): `src/main/java/com/bobble/spacebobble/ui/Solo.java`
- [Versus screen](https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/ui/VS.java): `src/main/java/com/bobble/spacebobble/ui/VS.java`
- [Co-op screen](https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/ui/Coop.java): `src/main/java/com/bobble/spacebobble/ui/Coop.java`
- [Leaderboard screen](https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/ui/Leaderboard.java): `src/main/java/com/bobble/spacebobble/ui/Leaderboard.java`
- [Solo controller](https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/controller/SoloController.java): `src/main/java/com/bobble/spacebobble/controller/SoloController.java`
- [Versus controller](https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/controller/VSController.java): `src/main/java/com/bobble/spacebobble/controller/VSController.java`
- [Co-op controller](https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/controller/CoopController.java): `src/main/java/com/bobble/spacebobble/controller/CoopController.java`
- [Leaderboard controller](https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/controller/LeaderboardController.java): `src/main/java/com/bobble/spacebobble/controller/LeaderboardController.java`
- [Visual manager](https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/gestion/VisualManager.java): `src/main/java/com/bobble/spacebobble/gestion/VisualManager.java`

### Game simulation

- [Game world](https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/core/GameWorld.java): `src/main/java/com/bobble/spacebobble/core/GameWorld.java`
- [Level generator](https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/gestion/WorldGenerator.java): `src/main/java/com/bobble/spacebobble/gestion/WorldGenerator.java`
- [Player character](https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/core/entities/Bobble.java): `src/main/java/com/bobble/spacebobble/core/entities/Bobble.java`
- [Aliens and survivors](https://github.com/aurel-2/spacebobble/tree/main/src/main/java/com/bobble/spacebobble/core/entities): `src/main/java/com/bobble/spacebobble/core/entities`
- [Blocks and traps](https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/core/world/Block.java): `src/main/java/com/bobble/spacebobble/core/world/Block.java`

### Scores and resources

- [Score model](https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/core/scores/Score.java): `src/main/java/com/bobble/spacebobble/core/scores/Score.java`
- [Leaderboard data](https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/core/scores/Leaderboard.java): `src/main/java/com/bobble/spacebobble/core/scores/Leaderboard.java`
- [Resource manager](https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/gestion/ResourceManager.java): `src/main/java/com/bobble/spacebobble/gestion/ResourceManager.java`

### Co-op networking

- [Co-op game client](https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/core/GameClient.java): `src/main/java/com/bobble/spacebobble/core/GameClient.java`
- [Co-op input](https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/controller/service/ClientInput.java): `src/main/java/com/bobble/spacebobble/controller/service/ClientInput.java`
- [Game server](https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/network/Server.java): `src/main/java/com/bobble/spacebobble/network/Server.java`
- [Client handler](https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/network/ClientHandler.java): `src/main/java/com/bobble/spacebobble/network/ClientHandler.java`
- [Game packets](https://github.com/aurel-2/spacebobble/blob/main/src/main/java/com/bobble/spacebobble/network/Packet/GamePacket.java): `src/main/java/com/bobble/spacebobble/network/Packet/GamePacket.java`

### Other components

- **Player**
- **Co-op server**

## Connections

- Player → JavaFX entry: launches (evidence: `src/main/java/com/bobble/spacebobble/Main.java`)
- JavaFX entry → Main menu: shows (evidence: `src/main/java/com/bobble/spacebobble/Main.java`)
- Solo controller → Game world: runs (evidence: `src/main/java/com/bobble/spacebobble/controller/SoloController.java`)
- Versus controller → Game world: runs (evidence: `src/main/java/com/bobble/spacebobble/controller/VSController.java`)
- Game world → Level generator: creates levels (evidence: `src/main/java/com/bobble/spacebobble/core/GameWorld.java`)
- Game world → Player character: creates (evidence: `src/main/java/com/bobble/spacebobble/core/GameWorld.java`)
- Game world → Blocks and traps: uses level blocks (evidence: `src/main/java/com/bobble/spacebobble/core/GameWorld.java`)
- Game world → Score model: updates (evidence: `src/main/java/com/bobble/spacebobble/core/GameWorld.java`)
- Solo controller → Visual manager: renders (evidence: `src/main/java/com/bobble/spacebobble/controller/SoloController.java`)
- Visual manager → Resource manager: loads leaderboard (evidence: `src/main/java/com/bobble/spacebobble/gestion/VisualManager.java`)
- Resource manager → Leaderboard data: loads and saves (evidence: `src/main/java/com/bobble/spacebobble/gestion/ResourceManager.java`)
- Co-op controller → Co-op game client: creates (evidence: `src/main/java/com/bobble/spacebobble/controller/CoopController.java`)
- Co-op controller → Co-op server: connects to
- Co-op input → Co-op game client: sends controls (evidence: `src/main/java/com/bobble/spacebobble/controller/service/ClientInput.java`)
- Co-op game client → Game packets: exchanges state (evidence: `src/main/java/com/bobble/spacebobble/core/GameClient.java`)
- Game server → Client handler: creates handlers (evidence: `src/main/java/com/bobble/spacebobble/network/Server.java`)
- Client handler → Game packets: handles (evidence: `src/main/java/com/bobble/spacebobble/network/ClientHandler.java`)
- Co-op game client → Game server: communicates with (evidence: `src/main/java/com/bobble/spacebobble/core/GameClient.java`)
- Game world → Aliens and survivors: updates (evidence: `src/main/java/com/bobble/spacebobble/core/GameWorld.java`)
