# kcat-fun/everalbum architecture

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

- Interactive diagram: https://gitdiagram.com/kcat-fun/everalbum
- Repository: https://github.com/kcat-fun/everalbum

## Overview

##### Project Components Identification
- Game Engine & Core Logic: The heart of the application is in the Main folder with files like Main.pde, App.pde, and Config.pde that initialize and control the game.
- Scene & Story Management: Files such as Scene.pde, Story.pde, and Title.pde indicate the game’s different states (title screen, narrative scenes) and transitions.
- User Interaction & Commands: Command.pde and Console.pde are likely handling console input and command parsing, allowing the player to interact with the game.
- Data & Asset Management: The “data” directory holds images and a variety of sound files (with an additional “soundOriginal” folder containing originals), showing that the game imports and manipulates multimedia assets.
- Supporting Utilities: Modules like FileIO.pde and Library.pde suggest utility functions for file operations and potential helper libraries, while Player.pde and Room.pde indicate abstractions for game entities (e.g., the character and the game setting).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% User Interaction & Commands
    subgraph "User Interaction & Commands"
        Command["Command"]:::input
        Console["Console"]:::input
    end

    %% Game Engine & Core Logic
    subgraph "Game Engine & Core Logic"
        MainEngine["Main Engine"]:::core
        AppController["App Controller"]:::core
        Config["Config"]:::core
    end

    %% Scene & Story Management
    subgraph "Scene & Story Management"
        Scene["Scene"]:::scene
        Story["Story"]:::scene
        Title["Title"]:::scene
    end

    %% Asset Manager
    subgraph "Asset Manager"
        AssetManager["Asset Manager"]:::asset
    end

    %% Assets & External Resources
    subgraph "Assets & External Resources"
        subgraph "Data Assets"
            Images["Images"]:::external
            Sounds["Sounds"]:::external
        end
        Fonts["Fonts"]:::external
    end

    %% Supporting Utilities
    subgraph "Supporting Utilities"
        FileIO["FileIO"]:::utility
        Library["Library"]:::utility
        Player["Player"]:::utility
        Room["Room"]:::utility
    end

    %% Connections
    Command -->|"sends input"| MainEngine
    Console -->|"sends input"| MainEngine

    MainEngine -->|"triggers scene"| Scene
    MainEngine -->|"loads assets"| AssetManager

    Scene -->|"requests assets"| AssetManager

    AssetManager -->|"retrieves"| Images
    AssetManager -->|"retrieves"| Sounds
    AssetManager -->|"retrieves"| Fonts

    FileIO -->|"supports"| MainEngine
    Library -->|"supports"| MainEngine
    Player -->|"supports"| MainEngine
    Room -->|"supports"| MainEngine

    %% Click Events
    click MainEngine "https://github.com/kcat-fun/everalbum/blob/main/Main/Main.pde"
    click AppController "https://github.com/kcat-fun/everalbum/blob/main/Main/App.pde"
    click Config "https://github.com/kcat-fun/everalbum/blob/main/Main/Config.pde"
    click Scene "https://github.com/kcat-fun/everalbum/blob/main/Main/Scene.pde"
    click Story "https://github.com/kcat-fun/everalbum/blob/main/Main/Story.pde"
    click Title "https://github.com/kcat-fun/everalbum/blob/main/Main/Title.pde"
    click Command "https://github.com/kcat-fun/everalbum/blob/main/Main/Command.pde"
    click Console "https://github.com/kcat-fun/everalbum/blob/main/Main/Console.pde"
    click Images "https://github.com/kcat-fun/everalbum/tree/main/Main/data/image"
    click Sounds "https://github.com/kcat-fun/everalbum/tree/main/Main/data/sound"
    click Fonts "https://github.com/kcat-fun/everalbum/tree/main/Main/font"
    click FileIO "https://github.com/kcat-fun/everalbum/blob/main/Main/FileIO.pde"
    click Library "https://github.com/kcat-fun/everalbum/blob/main/Main/Library.pde"
    click Player "https://github.com/kcat-fun/everalbum/blob/main/Main/Player.pde"
    click Room "https://github.com/kcat-fun/everalbum/blob/main/Main/Room.pde"

    %% Styles
    classDef core fill:#ffcccc,stroke:#333,stroke-width:2px;
    classDef scene fill:#ccffcc,stroke:#333,stroke-width:2px;
    classDef input fill:#ccccff,stroke:#333,stroke-width:2px;
    classDef utility fill:#ffffcc,stroke:#333,stroke-width:2px;
    classDef asset fill:#ffccff,stroke:#333,stroke-width:2px;
    classDef external fill:#ccffff,stroke:#333,stroke-width:2px;
```
