# tvt0338/btl_group_xg architecture

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

- Interactive diagram: https://gitdiagram.com/tvt0338/btl_group_xg
- Repository: https://github.com/tvt0338/btl_group_xg

## Overview

##### Project type and purpose
- This is a standalone desktop game written in Java using JavaFX for its UI. It implements the classic Bomberman gameplay: a menu system, per‐level maps, a real‐time game loop, entity behaviors, collision detection, resource loading, and level progression through Map1 → Map2 → Map3.

##### File structure
- Top‐level “boomberman/src” subdivides by domain:
- menu/ (MainMenu.java, FXML/CSS, sub‐screens, music, images)
- / (Map1Controller, Map2Controller, Map3Controller + FXML/CSS)
- map1/, map2/, map3/ (level classes + text maps)
- bomberman/ (core: CollisionHandler, Player)
- bomb/ (Bomb.java)
- enemy/ (Enemy base + Balloom, Fly, Oneal, Tanker, Void)
- items/ (Item base + Flame, Speed, Health, God_eye)
- portal/ (Portal.java)
- Configuration/build files are minimal (.gitignore, .iml); no external services (no DB).

##### Key insights from the README
- MVC-ish separation: UI screens (FXML) handled by Controllers → they instantiate and drive the game engine.
- Real‐time loop: player movement, bomb explosion timer, enemy AI (Random, BFS, A*), collision rules.
- Resource‐based assets: images, CSS, audio loaded at runtime.

##### Main components & their interactions
a. UI Layer (JavaFX)
– MainMenuController ← user clicks Play/Help/Settings
– MapXController ← drives each level’s UI, HUD, binds to Scene Graph
b. Input Handler
– Listens to keyboard events
– Translates to Player.move() or Player.placeBomb()
c. Game Engine
– GameLoop (timed ticks)
– EntityManager (tracks all Entities: Player, Enemies, Bombs, Items, MapObjects)
– CollisionHandler (resolves overlaps, bomb‐explosion vs. bricks/enemies/player)
– BombManager (schedules explosion, computes “+” area based on Flame upgrades)
– AI subsystem (enemy behaviors via Strategy: Random, BFS, A*)
d. Domain Entities
– Player (hp, speed, inventory of upgrades)
– Enemy subclasses (Balloom, Fly, Oneal, Tanker, Void)
– Bomb (timer, radius)
– Item subclasses (Flame, Speed, Health, God_eye)
– MapObjects (Wall, Brick, Grass, Portal)
e. Loader
– Parses Map_X.txt into in‐memory grid of MapObjects
f. Resource Manager
– Loads images, FXML, CSS, audio files from src/images & src/menu/music

##### Architectural patterns & principles
- MVC for UI (FXML views + Controllers)
- Game Loop pattern for continuous updates
- Inheritance + Polymorphism for Entities
- Strategy for Enemy pathfinding
- Separation of concerns: Resource loading, Rendering, Input, Game Logic

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% UI Layer
    subgraph "UI Layer"
        direction TB
        MainMenuController["MainMenuController"]:::ui
        MainMenuView["Menu.fxml & CSS"]:::ui
        subgraph "Secondary Screens"
            direction TB
            PlayController["PlayController"]:::ui
            PlayView["Play.fxml & CSS"]:::ui
            HelpController["HelpController"]:::ui
            HelpView["Help.fxml"]:::ui
            SettingController["SettingController"]:::ui
            SettingView["Setting.fxml & CSS"]:::ui
            AuthorsController["AuthorsController"]:::ui
            AuthorsView["Authors.fxml"]:::ui
        end
        subgraph "Level Controllers"
            direction TB
            Map1Controller["Map1Controller"]:::ui
            Map1View["map1.fxml & CSS"]:::ui
            Map2Controller["Map2Controller"]:::ui
            Map2View["map2.fxml"]:::ui
            Map3Controller["Map3Controller"]:::ui
            Map3View["map3.fxml"]:::ui
        end
    end

    %% Input Handler
    subgraph "Input Handling"
        direction TB
        InputHandler["Input Handler"]:::engine
    end

    %% Game Engine Core
    subgraph "Game Engine"
        direction TB
        GameLoop["GameLoop"]:::engine
        EntityManager["EntityManager"]:::engine
        CollisionHandler["CollisionHandler"]:::engine
        BombManager["BombManager"]:::engine
        AISubsystem["AI Subsystem"]:::engine
    end

    Renderer["Renderer (JavaFX Scene Graph)"]:::ui

    %% Domain Entities
    subgraph "Domain Entities"
        direction TB
        Player["Player"]:::domain
        Bomb["Bomb"]:::domain
        Monster["Monster (base)"]:::domain
        Balloom["Balloom"]:::domain
        Fly["Fly"]:::domain
        Oneal["Oneal"]:::domain
        Tanker["Tanker"]:::domain
        VoidEnemy["Void"]:::domain
        ItemBase["Item (base)"]:::domain
        Flame["Flame"]:::domain
        Speed["Speed"]:::domain
        Health["Health"]:::domain
        GodEye["God_eye"]:::domain
        Portal["Portal"]:::domain
    end

    %% Map Loader
    subgraph "Map Loader" 
        direction TB
        Map1Loader["Map1Loader"]:::loader
        Map2Loader["Map2Loader"]:::loader
        Map3Loader["Map3Loader"]:::loader
    end

    %% Resource Manager
    ResourceManager["Resource Manager"]:::loader

    %% Relationships
    User((User)) -->|"clicks"| MainMenuController
    MainMenuController -->|"loads view"| MainMenuView
    MainMenuController -->|"opens"| PlayController
    MainMenuController -->|"opens"| HelpController
    MainMenuController -->|"opens"| SettingController
    MainMenuController -->|"opens"| AuthorsController

    PlayController -->|"loads view"| PlayView
    HelpController -->|"loads view"| HelpView
    SettingController -->|"loads view"| SettingView
    AuthorsController -->|"loads view"| AuthorsView

    Map1Controller -->|"loads view"| Map1View
    Map2Controller -->|"loads view"| Map2View
    Map3Controller -->|"loads view"| Map3View

    User -->|"keyboard events"| InputHandler
    InputHandler -->|"invokes"| Player
    Player -->|"calls"| GameLoop

    MainMenuController -->|"configures and starts"| GameLoop
    Map1Controller -->|"initializes level via"| Map1Loader
    Map2Controller -->|"initializes level via"| Map2Loader
    Map3Controller -->|"initializes level via"| Map3Loader

    Map1Loader -->|"provides grid to"| GameLoop
    Map2Loader -->|"provides grid to"| GameLoop
    Map3Loader -->|"provides grid to"| GameLoop

    GameLoop -->|"manages entities"| EntityManager
    GameLoop -->|"handles collisions"| CollisionHandler
    GameLoop -->|"schedules bombs"| BombManager
    GameLoop -->|"runs AI strategies"| AISubsystem
    GameLoop -->|"renders via"| Renderer

    EntityManager -->|"contains"| Player
    EntityManager -->|"contains"| Bomb
    EntityManager -->|"contains"| Monster
    EntityManager -->|"contains"| Balloom
    EntityManager -->|"contains"| Fly
    EntityManager -->|"contains"| Oneal
    EntityManager -->|"contains"| Tanker
    EntityManager -->|"contains"| VoidEnemy
    EntityManager -->|"contains"| ItemBase
    EntityManager -->|"contains"| Flame
    EntityManager -->|"contains"| Speed
    EntityManager -->|"contains"| Health
    EntityManager -->|"contains"| GodEye
    EntityManager -->|"contains"| Portal

    MainMenuController -->|"loads assets via"| ResourceManager
    GameLoop -->|"loads assets via"| ResourceManager

    ResourceManager -->|"loads images from"| Images["Images Directories"]:::loader
    ResourceManager -->|"loads audio from"| Audio["Audio Directory"]:::loader

    %% Click Events
    click MainMenuController "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/menu/MenuController.java"
    click MainMenuView "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/menu/Menu.fxml"
    click PlayController "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/menu/screen_2/PlayController.java"
    click PlayView "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/menu/screen_2/Play.fxml"
    click HelpController "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/menu/screen_2/HelpController.java"
    click HelpView "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/menu/screen_2/Help.fxml"
    click SettingController "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/menu/screen_2/SettingController.java"
    click SettingView "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/menu/screen_2/Setting.fxml"
    click AuthorsController "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/menu/screen_2/AuthorsController.java"
    click AuthorsView "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/menu/screen_2/Authors.fxml"
    click Map1Controller "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/map/Map1Controller.java"
    click Map1View "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/map/map1.fxml"
    click Map2Controller "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/map/Map2Controller.java"
    click Map2View "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/map/map2.fxml"
    click Map3Controller "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/map/Map3Controller.java"
    click Map3View "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/map/map3.fxml"
    click InputHandler "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/bomberman/Player.java"
    click CollisionHandler "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/bomberman/CollisionHandler.java"
    click Player "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/bomberman/Player.java"
    click Bomb "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/bomb/Bomb.java"
    click Monster "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/enemy/Monster.java"
    click Balloom "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/enemy/Balloom.java"
    click Fly "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/enemy/Fly.java"
    click Oneal "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/enemy/Oneal.java"
    click Tanker "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/enemy/Tanker.java"
    click VoidEnemy "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/enemy/Void.java"
    click ItemBase "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/items/Item.java"
    click Flame "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/items/Flame.java"
    click Speed "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/items/Speed.java"
    click Health "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/items/Health.java"
    click GodEye "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/items/God_eye.java"
    click Portal "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/portal/Portal.java"
    click Map1Loader "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/map1/Map1.java"
    click Map2Loader "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/map2/Map2.java"
    click Map3Loader "https://github.com/tvt0338/btl_group_xg/blob/main/boomberman/src/map3/Map3.java"
    click Images "https://github.com/tvt0338/btl_group_xg/tree/main/boomberman/src/images"
    click Audio "https://github.com/tvt0338/btl_group_xg/tree/main/boomberman/src/menu/music"

    %% Styles
    classDef ui fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef engine fill:#90EE90,stroke:#333,stroke-width:1px
    classDef domain fill:#FFFF99,stroke:#333,stroke-width:1px
    classDef loader fill:#FFA500,stroke:#333,stroke-width:1px
```
