# hasnatrasool163/tetris-in-java architecture

> Architecture diagram of the GitHub repository hasnatrasool163/tetris-in-java, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hasnatrasool163/tetris-in-java
- Repository: https://github.com/hasnatrasool163/tetris-in-java

## Overview

##### Project type and purpose
- This is a standalone desktop Tetris game written in Java, using Swing and AWT for the GUI.
- The purpose is to present classic Tetris gameplay with features like 7 tetrominoes (Minos), score tracking, levels, pause/resume, collision detection, and sound.

##### File structure
- Top-level directories:
- tetris – the main game modules: input handling, game loop, UI panel, commands, sound, and utility classes.
- Executables and build artifacts: TetrisGame.exe, Tetris_Game.jar (packaged game), .iml files, .idea folder.
- No server or network components; purely client-side desktop application.

##### README for additional insights
- Confirms Swing/AWT GUI, Java 21, game controls, features, and external resources (audio files under tetris/).

##### Main components and their relationships
a. User Interface Layer
- window.java – top-level JFrame
- GamePanel.java – custom JPanel for rendering the game board and current piece
- MenuHandler.java – builds and handles the main menu UI
b. Input & Command Layer
- KeyHandler.java – listens for key events and translates them into GameCommandStart, GameCommandQuit, or movement/rotation commands
- Controller.java – centralizes input dispatch
- Command.java, GameCommandStart.java, GameCommandQuit.java – Command pattern for starting and quitting
c. Core Game Logic
- PlayManager.java – the game loop, state transitions, level/score management, collision checks
- Subject.java and PowerUpObserver.java – Observer pattern for broadcasting events (e.g., line clear, level up) to interested listeners (e.g., UI, score tracker)
d. Data Model
- Block.java – basic unit in a tetromino
- Mino.java and its subclasses (Mino_Bar, Mino_L1, etc.) – tetromino definitions, rotation logic
- Board representation (likely inside PlayManager or GamePanel) – 2D array/grid storing placed blocks
e. Audio Subsystem
- Sound.java – loads and plays .wav files for line clear, rotation, game over, etc.
- Audio assets under tetris/ directory

##### Architectural patterns and design principles
- MVC-like separation:
- View: window.java, GamePanel, MenuHandler
- Controller: KeyHandler, Controller, Command classes
- Model: PlayManager, Mino classes, Block, score/level state
- Command pattern for start/quit and potentially future commands
- Observer pattern for decoupling game events from UI updates and sound effects
- Single responsibility for each class/module

- From KeyHandler → Controller → PlayManager (input flow)
- From PlayManager → Subject → PowerUpObserver/UI/Sound (event propagation)
- From PlayManager → GamePanel (render requests)
- From UI (window/GamePanel) → PlayManager (start, pause signals)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% User Interface Layer
    subgraph "User Interface"
        direction TB
        Window["window.java"]:::ui
        GamePanel["GamePanel.java"]:::ui
        MenuHandler["MenuHandler.java"]:::ui
    end

    %% Input & Command Layer
    subgraph "Input & Command"
        direction TB
        KeyHandler["KeyHandler.java"]:::input
        Controller["Controller.java"]:::input
        Command["Command.java"]:::input
        GameCommandStart["GameCommandStart.java"]:::input
        GameCommandQuit["GameCommandQuit.java"]:::input
    end

    %% Core Game Logic Layer
    subgraph "Core Game Logic"
        direction TB
        PlayManager["PlayManager.java"]:::logic
        Subject["Subject.java"]:::logic
        PowerUpObserver["PowerUpObserver.java"]:::logic
    end

    %% Data Model Layer
    subgraph "Data Model"
        direction TB
        Block["Block.java"]:::model
        Mino["Mino.java"]:::model
        Mino_Bar["Mino_Bar.java"]:::model
        Mino_L1["Mino_L1.java"]:::model
        Mino_L2["Mino_L2.java"]:::model
        Mino_Square["Mino_Square.java"]:::model
        Mino_T["Mino_T.java"]:::model
        Mino_Z1["Mino_Z1.java"]:::model
        Mino_Z2["Mino_Z2.java"]:::model
    end

    %% Audio Subsystem Layer
    subgraph "Audio Subsystem"
        direction TB
        Sound["Sound.java"]:::audio
        AudioAssets[".wav files"]:::audio
    end

    %% Interactions
    Window -->|"start/pause"| PlayManager
    GamePanel -->|"render() calls"| PlayManager
    PlayManager -->|"update()/game loop"| GamePanel

    KeyHandler -->|"User input"| Controller
    Controller -->|"dispatch()"| PlayManager
    Controller --> Command
    Command --> GameCommandStart
    Command --> GameCommandQuit
    GameCommandStart -->|"execute()"| PlayManager
    GameCommandQuit -->|"execute()"| PlayManager

    PlayManager -->|"notify() events"| Subject
    Subject -->|"lineClear(), levelUp()"| PowerUpObserver
    Subject -->|"UI update"| MenuHandler
    Subject -->|"play sound"| Sound

    PlayManager -->|"uses"| Mino
    Mino --> Mino_Bar
    Mino --> Mino_L1
    Mino --> Mino_L2
    Mino --> Mino_Square
    Mino --> Mino_T
    Mino --> Mino_Z1
    Mino --> Mino_Z2
    PlayManager -->|"grid blocks"| Block

    Sound --> AudioAssets

    %% Click Events
    click Window "https://github.com/hasnatrasool163/tetris-in-java/blob/main/tetris/window.java"
    click GamePanel "https://github.com/hasnatrasool163/tetris-in-java/blob/main/tetris/GamePanel.java"
    click MenuHandler "https://github.com/hasnatrasool163/tetris-in-java/blob/main/tetris/MenuHandler.java"
    click KeyHandler "https://github.com/hasnatrasool163/tetris-in-java/blob/main/tetris/KeyHandler.java"
    click Controller "https://github.com/hasnatrasool163/tetris-in-java/blob/main/tetris/Controller.java"
    click Command "https://github.com/hasnatrasool163/tetris-in-java/blob/main/tetris/Command.java"
    click GameCommandStart "https://github.com/hasnatrasool163/tetris-in-java/blob/main/tetris/GameCommandStart.java"
    click GameCommandQuit "https://github.com/hasnatrasool163/tetris-in-java/blob/main/tetris/GameCommandQuit.java"
    click PlayManager "https://github.com/hasnatrasool163/tetris-in-java/blob/main/tetris/PlayManager.java"
    click Subject "https://github.com/hasnatrasool163/tetris-in-java/blob/main/tetris/Subject.java"
    click PowerUpObserver "https://github.com/hasnatrasool163/tetris-in-java/blob/main/tetris/PowerUpObserver.java"
    click Block "https://github.com/hasnatrasool163/tetris-in-java/blob/main/mino/Block.java"
    click Mino "https://github.com/hasnatrasool163/tetris-in-java/blob/main/mino/Mino.java"
    click Mino_Bar "https://github.com/hasnatrasool163/tetris-in-java/blob/main/mino/Mino_Bar.java"
    click Mino_L1 "https://github.com/hasnatrasool163/tetris-in-java/blob/main/mino/Mino_L1.java"
    click Mino_L2 "https://github.com/hasnatrasool163/tetris-in-java/blob/main/mino/Mino_L2.java"
    click Mino_Square "https://github.com/hasnatrasool163/tetris-in-java/blob/main/mino/Mino_Square.java"
    click Mino_T "https://github.com/hasnatrasool163/tetris-in-java/blob/main/mino/Mino_T.java"
    click Mino_Z1 "https://github.com/hasnatrasool163/tetris-in-java/blob/main/mino/Mino_Z1.java"
    click Mino_Z2 "https://github.com/hasnatrasool163/tetris-in-java/blob/main/mino/Mino_Z2.java"
    click Sound "https://github.com/hasnatrasool163/tetris-in-java/blob/main/tetris/Sound.java"

    %% Legend
    classDef ui fill:#D0E8FF,stroke:#0366D6,color:#0366D6;
    classDef input fill:#DFFFE0,stroke:#28A745,color:#22863A;
    classDef logic fill:#FFF5D1,stroke:#DBAB09,color:#735C0F;
    classDef model fill:#FFE4C4,stroke:#D2691E,color:#8B4513;
    classDef audio fill:#F3E8FF,stroke:#6F42C1,color:#5A32A3;
```
