# saadan-hashmi-0p/sfmlproject architecture

> Architecture diagram of the GitHub repository saadan-hashmi-0p/sfmlproject, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-10). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/saadan-hashmi-0p/sfmlproject
- Repository: https://github.com/saadan-hashmi-0p/sfmlproject

## Overview

##### Project Type and Purpose
- Type: Desktop 2D game written in C++ using the SFML multimedia library.
- Purpose: Real‐time, local two‐player fighting game with movement, attacks, health/energy bars, sound effects, and simple UI screens (start menu, game over).

##### File Structure
- Root contains solution and project files (.sln, .vcxproj).
- Inside “SFML PROJECT”:
- SFML PROJECT.cpp – the main game source file (entry point).
- Multiple .mp3 files – audio assets (theme, SFX).
- GAME_RESULTS.txt / results.txt – game‐state persistence or logs.
- No submodules: all code lives in one source file. Assets are managed by the game at runtime.

##### Extract Architectural Insights
- Single executable that uses SFML modules for windowing, graphics, audio, and input.
- There is an implicit game loop: initialization → input handling → game logic update → rendering → audio playback → repeat.

a. Game Loop & Core Engine
– Entry point (main).
– Manages initialization and the loop that ties all subsystems together.
b. Input Manager
– Polls SFML events (keyboard for both players, cheat code).
– Abstracts key mappings (W/A/S/D + Q/E/R/Z etc.).
c. Game Logic
– Player entities (Goku, Vegeta) with health and energy.
– Attack resolution, collision detection (hit confirmation), cheat logic.
– State machine for menus vs. in‐game vs. game‐over.
d. Renderer (Graphics)
– Draws sprites, UI (health/energy bars, menus).
– Uses SFML Graphics module.
e. Audio Manager
– Loads .mp3 assets.
– Plays background music and SFX via SFML Audio module.
f. Asset Manager
– Loads and caches textures, fonts (if any), audio clips, external files (results.txt).
g. Persistence/Logging
– Reads/writes GAME_RESULTS.txt for high scores or match logs.

##### Relationships and Data Flows
- Game Logic → Renderer (to present updated state).
- Game Logic → Audio Manager (to trigger sounds/music).
- Asset Manager feeds assets to both Renderer and Audio Manager during initialization.
- Persistence layer invoked by Game Logic on game end to read/write GAME_RESULTS.txt.

##### Architectural Patterns & Principles
- Centralized game loop controlling subsystems (common in game engines).
- Manager classes (Input, Asset, Audio) isolating SFML API usage.
- State machine for menu vs. in‐game vs. game‐over screens.
- Monolithic application (no microservices or multi‐tier).

##### Technologies & Frameworks
- C++
- SFML modules: Window, Graphics, System, Audio, Network (if used for cheat code—but local only here).
- Build via Visual Studio or g++ linking SFML.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Build & Config
    subgraph "Build & Config"
        B1["SFML PROJECT.sln"]:::external
        B2["SFML PROJECT.vcxproj"]:::external
        B3["SFML PROJECT.vcxproj.filters"]:::external
        B4["README.md"]:::external
    end

    %% Core Engine
    Core["Game Loop & Core Engine"]:::core

    %% Managers
    subgraph "Managers" 
        IM["Input Manager"]:::manager
        GM["Game Logic"]:::core
        RM["Renderer (Graphics)"]:::manager
        AM["Audio Manager"]:::manager
        AS["Asset Manager"]:::asset
        PL["Persistence/Logging"]:::manager
    end

    %% External Libraries
    subgraph "SFML Libraries"
        style SFML_Window stroke-dasharray: 5 5
        SFML_Window["SFML Window"]:::external
        SFML_Graphics["SFML Graphics"]:::external
        SFML_Audio["SFML Audio"]:::external
        SFML_System["SFML System"]:::external
    end

    %% Assets
    subgraph "Assets"
        A1["Flying.mp3"]:::asset
        A2["SpecialAttack.mp3"]:::asset
        A3["dbz_theme_song.mp3"]:::asset
        A4["gameover.mp3"]:::asset
        A5["punch.mp3"]:::asset
        T1["GAME_RESULTS.txt"]:::asset
        T2["results.txt"]:::asset
    end

    %% Initialization Flow
    Core -->|"Init subsystems"| AS
    AS -->|"provide textures/audio"| RM
    AS -->|"provide audio clips"| AM
    SFML_Window --> RM
    SFML_Graphics --> RM
    SFML_Audio --> AM
    SFML_System --> Core

    %% Main Loop
    Core -->|"poll events"| IM
    IM -->|"KeyPressed"| GM
    GM -->|"update state"| RM
    GM -->|"trigger SFX/Music"| AM
    GM -->|"on GameEnd"| PL

    %% Persistence
    PL -->|"read/write"| T1
    PL -->|"read/write"| T2

    %% Click Events
    click Core "https://github.com/saadan-hashmi-0p/sfmlproject/blob/master/SFML PROJECT/SFML PROJECT.cpp"
    click IM "https://github.com/saadan-hashmi-0p/sfmlproject/blob/master/SFML PROJECT/SFML PROJECT.cpp"
    click GM "https://github.com/saadan-hashmi-0p/sfmlproject/blob/master/SFML PROJECT/SFML PROJECT.cpp"
    click RM "https://github.com/saadan-hashmi-0p/sfmlproject/blob/master/SFML PROJECT/SFML PROJECT.cpp"
    click AS "https://github.com/saadan-hashmi-0p/sfmlproject/blob/master/SFML PROJECT/SFML PROJECT.cpp"
    click A1 "https://github.com/saadan-hashmi-0p/sfmlproject/blob/master/SFML PROJECT/Flying.mp3"
    click A2 "https://github.com/saadan-hashmi-0p/sfmlproject/blob/master/SFML PROJECT/SpecialAttack.mp3"
    click A3 "https://github.com/saadan-hashmi-0p/sfmlproject/blob/master/SFML PROJECT/dbz_theme_song.mp3"
    click A4 "https://github.com/saadan-hashmi-0p/sfmlproject/blob/master/SFML PROJECT/gameover.mp3"
    click A5 "https://github.com/saadan-hashmi-0p/sfmlproject/blob/master/SFML PROJECT/punch.mp3"
    click T1 "https://github.com/saadan-hashmi-0p/sfmlproject/blob/master/SFML PROJECT/GAME_RESULTS.txt"
    click T2 "https://github.com/saadan-hashmi-0p/sfmlproject/blob/master/SFML PROJECT/results.txt"
    click B1 "https://github.com/saadan-hashmi-0p/sfmlproject/blob/master/SFML PROJECT.sln"
    click B2 "https://github.com/saadan-hashmi-0p/sfmlproject/blob/master/SFML PROJECT/SFML PROJECT.vcxproj"
    click B3 "https://github.com/saadan-hashmi-0p/sfmlproject/blob/master/SFML PROJECT/SFML PROJECT.vcxproj.filters"
    click B4 "https://github.com/saadan-hashmi-0p/sfmlproject/blob/master/README.md"

    %% Styles
    classDef core fill:#cfe2f3,stroke:#2a65a0,color:#0b2246
    classDef manager fill:#d9ead3,stroke:#3c763d,color:#0b342d
    classDef asset fill:#f9cb9c,stroke:#a65f00,color:#663d00
    classDef external fill:#ffe599,stroke:#7f6000,color:#403000
```
