# deety-dino/btloop architecture

> Architecture diagram of the GitHub repository deety-dino/btloop, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-11-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/deety-dino/btloop
- Repository: https://github.com/deety-dino/btloop

## Overview

##### Project type and purpose
- This is a Java-based desktop game (an Arkanoid/brick-breaker clone) built on JavaFX.
- The entry points are in src/main (Arkanoid.java, Main.java), and resources include graphics (sprites, UI assets), sound effects, stylesheets, and FXML layouts.

##### File structure
- Top‐level source packages:
- src/main – application bootstrap
- src/controller – UI controllers, data handlers, and FXML files
- src/gameobjects – core game entities (Ball, Paddle, Brick variants, PowerUp) plus a BrickFactory
- src/mng – gameManager (the core game loop and state manager)
- src/user – user data model (User.java)
- resources/ contains all static assets:
- gfx/ (images for game objects and menus)
- sfx/ (soundtracks and effects)
- style.css, TTF fonts
- FXML layouts under src/controller/fxml define the three main scenes: login, levelSelection, and play.

##### (minimal) README
- Confirms project name “BTLOOP” but lacks architectural notes—so we infer a layered MVC-style design from the structure.

##### Detailed breakdown of components
- JavaFX Application (Main)
- Scene Graphs (login.fxml, etc.)
- Controllers: login.java, levelSelection.java, Play.java
- dat package: dat.java (generic data carrier), IngameData.java (game state)
- User model: User.java
- gameManager: starts/stops loop, collision detection, scoring
- gameobjects: abstract GameObject, concrete Ball, Paddle, Brick variants, PowerUp, BrickFactory
- ResourceLoader: loads images, sounds, fonts, CSS

## Diagram (Mermaid)

```mermaid
graph TD
    %% Presentation Layer
    subgraph "Presentation Layer (JavaFX)" 
        direction TB
        Arkanoid["Arkanoid (JavaFX Entry)"]:::green
        Main["Main (Startup)"]:::green
        loginFXML["login.fxml"]:::blue
        levelSelectionFXML["levelSelection.fxml"]:::blue
        playFXML["play.fxml"]:::blue
    end

    %% Controllers
    subgraph "Controllers (Orchestration)" 
        direction TB
        LoginController["LoginController"]:::green
        LevelSelectionController["LevelSelectionController"]:::green
        PlayController["PlayController"]:::green
        DatCarrier["dat (Data Carrier)"]:::purple
        IngameData["IngameData (Game State)"]:::purple
    end

    %% Game Logic Layer
    subgraph "Game Logic Layer" 
        direction TB
        GameManager["gameManager"]:::orange
        subgraph "Game Objects" 
            direction TB
            GameObject["GameObject (Abstract)"]:::orange
            Ball["Ball"]:::orange
            Paddle["Paddle"]:::orange
            BrickAbstract["Brick (Abstract)"]:::orange
            NormalBrick["NormalBrick"]:::orange
            StrongBrick["StrongBrick"]:::orange
            PowerUpBrick["PowerUpBrick"]:::orange
            PowerUp["PowerUp"]:::orange
            BrickFactory["BrickFactory"]:::orange
        end
    end

    %% Data Layer
    UserModel["User"]:::purple

    %% Resource Layer
    subgraph "Resource Loader" 
        direction TB
        Graphics["Graphics (resources/gfx)"]:::gray
        Sounds["Sounds (resources/sfx)"]:::gray
        Stylesheet["style.css"]:::gray
        Fonts["ttf Fonts"]:::gray
    end

    %% Relationships
    Arkanoid -->|initializes| Main
    Main -->|loads scene| loginFXML
    loginFXML -->|uses| LoginController
    levelSelectionFXML -->|uses| LevelSelectionController
    playFXML -->|uses| PlayController

    LoginController -->|invokes| DatCarrier
    LevelSelectionController -->|invokes| DatCarrier
    PlayController -->|invokes| DatCarrier

    DatCarrier -->|holds state| IngameData
    IngameData -->|passed to| GameManager

    LoginController -->|creates User| UserModel
    LevelSelectionController -->|reads User| UserModel

    GameManager -->|updates| GameObject
    GameObject -->|specializations| Ball
    GameObject -->|specializations| Paddle
    GameObject -->|specializations| BrickAbstract
    BrickAbstract -->|concrete| NormalBrick
    BrickAbstract -->|concrete| StrongBrick
    BrickAbstract -->|concrete| PowerUpBrick
    GameManager -->|spawns| PowerUp
    GameManager -->|uses| BrickFactory

    GameManager -->|pushes updates| PlayController
    PlayController -->|refreshes view| playFXML

    %% Resource Access
    LoginController -->|loads assets| Graphics
    LoginController -->|loads sounds| Sounds
    LoginController -->|applies style| Stylesheet
    LevelSelectionController -->|loads assets| Graphics
    PlayController -->|loads assets| Graphics
    PlayController -->|loads sounds| Sounds
    GameManager -->|loads sounds| Sounds

    Fonts -.-> Stylesheet

    %% Click Events
    click Arkanoid "https://github.com/deety-dino/btloop/blob/main/src/main/Arkanoid.java"
    click Main "https://github.com/deety-dino/btloop/blob/main/src/main/Main.java"
    click loginFXML "https://github.com/deety-dino/btloop/blob/main/src/controller/fxml/login.fxml"
    click levelSelectionFXML "https://github.com/deety-dino/btloop/blob/main/src/controller/fxml/levelSelection.fxml"
    click playFXML "https://github.com/deety-dino/btloop/blob/main/src/controller/fxml/play.fxml"
    click LoginController "https://github.com/deety-dino/btloop/blob/main/src/controller/control/login.java"
    click LevelSelectionController "https://github.com/deety-dino/btloop/blob/main/src/controller/control/levelSelection.java"
    click PlayController "https://github.com/deety-dino/btloop/blob/main/src/controller/control/Play.java"
    click DatCarrier "https://github.com/deety-dino/btloop/blob/main/src/controller/dat/dat.java"
    click IngameData "https://github.com/deety-dino/btloop/blob/main/src/controller/dat/IngameData.java"
    click GameManager "https://github.com/deety-dino/btloop/blob/main/src/mng/gameManager.java"
    click GameObject "https://github.com/deety-dino/btloop/blob/main/src/gameobjects/GameObject.java"
    click Ball "https://github.com/deety-dino/btloop/blob/main/src/gameobjects/Ball.java"
    click Paddle "https://github.com/deety-dino/btloop/blob/main/src/gameobjects/Paddle.java"
    click BrickAbstract "https://github.com/deety-dino/btloop/blob/main/src/gameobjects/Brick.java"
    click NormalBrick "https://github.com/deety-dino/btloop/blob/main/src/gameobjects/NormalBrick.java"
    click StrongBrick "https://github.com/deety-dino/btloop/blob/main/src/gameobjects/StrongBrick.java"
    click PowerUpBrick "https://github.com/deety-dino/btloop/blob/main/src/gameobjects/PowerUpBrick.java"
    click PowerUp "https://github.com/deety-dino/btloop/blob/main/src/gameobjects/PowerUp.java"
    click BrickFactory "https://github.com/deety-dino/btloop/blob/main/src/gameobjects/BrickFactory.java"
    click UserModel "https://github.com/deety-dino/btloop/blob/main/src/user/User.java"
    click Graphics "https://github.com/deety-dino/btloop/tree/main/resources/gfx"
    click Sounds "https://github.com/deety-dino/btloop/tree/main/resources/sfx"
    click Stylesheet "https://github.com/deety-dino/btloop/blob/main/resources/style.css"
    click Fonts "https://github.com/deety-dino/btloop/tree/main/resources/ttf"

    %% Styles
    classDef blue fill:#bbdefb,stroke:#1e88e5,color:#1e88e5;
    classDef green fill:#c8e6c9,stroke:#43a047,color:#43a047;
    classDef orange fill:#ffe0b2,stroke:#fb8c00,color:#fb8c00;
    classDef purple fill:#e1bee7,stroke:#8e24aa,color:#8e24aa;
    classDef gray fill:#cfd8dc,stroke:#546e7a,color:#546e7a;
```
