# katlicia/frosch_jumper architecture

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

- Interactive diagram: https://gitdiagram.com/katlicia/frosch_jumper
- Repository: https://github.com/katlicia/frosch_jumper

## Overview

##### Project type and purpose
- This is a Godot-based 2D endless jumper game (“Frosch Jumper”) built in GDScript for a Game Jam.
- It comprises game logic scripts, scene definitions, and asset resources (sprites, audio, UI controls).

##### File structure
- Top-level files:
- project.godot: Godot project configuration
- export_presets.cfg: build/export settings
- .gitignore, .gitattributes, .editorconfig: VCS and editor settings
- Directories:
- assets/: sprites, sound files, UI templates (.tres)
- scenes/: all .tscn scene files and subfolder for platform tiles
- scripts/: GDScript files attached to scenes or nodes
- Patterns:
- MVC-style separation: Scenes hold nodes/structure; scripts control behavior.
- Assets are decoupled into their own folder, reusable across scenes.

##### README for additional insights
- Game jam demo, simple endless jumper with menu, options, audio, parallax background.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Editor/Build Stage
    subgraph "Editor/Build Stage"
        projectCfg["project.godot"]:::build
        exportCfg["export_presets.cfg"]:::build
        executable["Game Executable"]:::build
        projectCfg --> executable
        exportCfg --> executable
    end

    %% Runtime Stage
    subgraph "Runtime"
        %% Assets Pipeline
        subgraph "Assets" 
            sprites["Sprites"]:::assets
            uiTemplates["UI Templates"]:::assets
            sounds["Sounds"]:::assets
        end

        %% Scenes and Scene Graph
        subgraph "Scenes" 
            mainMenuScene["Main Menu Scene\n(main_menu.tscn)"]:::scenes
            optionsScene["Options Scene\n(options.tscn)"]:::scenes
            volumeScene["Volume Slider Scene\n(volume_slider.tscn)"]:::scenes
            parallaxScene["Parallax Background\n(parallax.tscn)"]:::scenes
            platformScene["Platform Template\n(platform.tscn)"]:::scenes
            platformVariants["Platform Variants"]:::scenes
            playerScene["Player Scene\n(player.tscn)"]:::scenes
            testScene["Test Scene\n(test.tscn)"]:::scenes
            platformScene --> platformVariants
        end

        %% Script Controllers
        subgraph "Scripts" 
            mainMenuScript["main_menu.gd"]:::scripts
            optionsScript["options.gd"]:::scripts
            volumeScript["volume_slider.gd"]:::scripts
            parallaxLayer2Script["parallax_layer_2.gd"]:::scripts
            playerScript["player.gd"]:::scripts
            cameraScript["camera_2d.gd"]:::scripts
            testScript["test.gd"]:::scripts
        end

        %% Engine Subsystems
        subgraph "Engine Subsystems"
            inputSys["Input System"]:::engine
            physicsSys["Physics Engine"]:::engine
            renderSys["Renderer"]:::engine
            audioSys["Audio Server"]:::engine
        end
    end

    %% Asset to Scenes
    sprites --> mainMenuScene
    sprites --> optionsScene
    sprites --> volumeScene
    sprites --> parallaxScene
    sprites --> platformScene
    sprites --> playerScene

    uiTemplates --> optionsScene
    uiTemplates --> volumeScene

    sounds --> mainMenuScene
    sounds --> optionsScene
    sounds --> volumeScene
    sounds --> parallaxScene
    sounds --> playerScene

    %% Input to Scripts
    inputSys --> mainMenuScript
    inputSys --> optionsScript
    inputSys --> volumeScript
    inputSys --> playerScript
    inputSys --> cameraScript

    %% Scripts to their Scenes
    mainMenuScript --> mainMenuScene
    optionsScript --> optionsScene
    volumeScript --> volumeScene
    parallaxLayer2Script --> parallaxScene
    playerScript --> playerScene
    cameraScript --> playerScene
    testScript --> testScene

    %% Scenes to Engine
    mainMenuScene --> physicsSys
    optionsScene --> physicsSys
    volumeScene --> physicsSys
    parallaxScene --> physicsSys
    platformScene --> physicsSys
    playerScene --> physicsSys
    testScene --> physicsSys

    mainMenuScene --> renderSys
    optionsScene --> renderSys
    volumeScene --> renderSys
    parallaxScene --> renderSys
    platformScene --> renderSys
    playerScene --> renderSys
    testScene --> renderSys

    %% Scripts triggering Audio
    mainMenuScript --> audioSys
    optionsScript --> audioSys
    volumeScript --> audioSys
    playerScript --> audioSys

    %% Click Events
    click projectCfg "https://github.com/katlicia/frosch_jumper/blob/main/project.godot"
    click exportCfg "https://github.com/katlicia/frosch_jumper/blob/main/export_presets.cfg"
    click audioSys "https://github.com/katlicia/frosch_jumper/blob/main/default_bus_layout.tres"
    click sprites "https://github.com/katlicia/frosch_jumper/tree/main/assets/sprites/"
    click uiTemplates "https://github.com/katlicia/frosch_jumper/blob/main/assets/OptionsLabelSettings.tres"
    click uiTemplates "https://github.com/katlicia/frosch_jumper/tree/main/assets/buttons/"
    click sounds "https://github.com/katlicia/frosch_jumper/blob/main/assets/sound/frog.ogg"
    click sounds "https://github.com/katlicia/frosch_jumper/blob/main/assets/sound/music.mp3"
    click mainMenuScene "https://github.com/katlicia/frosch_jumper/blob/main/scenes/main_menu.tscn"
    click mainMenuScript "https://github.com/katlicia/frosch_jumper/blob/main/scripts/main_menu.gd"
    click optionsScene "https://github.com/katlicia/frosch_jumper/blob/main/scenes/options.tscn"
    click optionsScript "https://github.com/katlicia/frosch_jumper/blob/main/scripts/options.gd"
    click volumeScene "https://github.com/katlicia/frosch_jumper/blob/main/scenes/volume_slider.tscn"
    click volumeScript "https://github.com/katlicia/frosch_jumper/blob/main/volume_slider.gd"
    click parallaxScene "https://github.com/katlicia/frosch_jumper/blob/main/scenes/parallax.tscn"
    click parallaxLayer2Script "https://github.com/katlicia/frosch_jumper/blob/main/scenes/parallax_layer_2.gd"
    click platformScene "https://github.com/katlicia/frosch_jumper/blob/main/scenes/platform.tscn"
    click platformVariants "https://github.com/katlicia/frosch_jumper/blob/main/scenes/platforms/large-grass.tscn"
    click platformVariants "https://github.com/katlicia/frosch_jumper/blob/main/scenes/platforms/large-ice.tscn"
    click platformVariants "https://github.com/katlicia/frosch_jumper/blob/main/scenes/platforms/medium-grass.tscn"
    click platformVariants "https://github.com/katlicia/frosch_jumper/blob/main/scenes/platforms/medium-ice.tscn"
    click platformVariants "https://github.com/katlicia/frosch_jumper/blob/main/scenes/platforms/small-grass.tscn"
    click platformVariants "https://github.com/katlicia/frosch_jumper/blob/main/scenes/platforms/small-ice.tscn"
    click playerScene "https://github.com/katlicia/frosch_jumper/blob/main/scenes/player.tscn"
    click playerScript "https://github.com/katlicia/frosch_jumper/blob/main/scripts/player.gd"
    click cameraScript "https://github.com/katlicia/frosch_jumper/blob/main/scripts/camera_2d.gd"
    click testScene "https://github.com/katlicia/frosch_jumper/blob/main/scenes/test.tscn"
    click testScript "https://github.com/katlicia/frosch_jumper/blob/main/scripts/test.gd"

    %% Styles
    classDef build fill:#ddd,stroke:#333,stroke-width:1px
    classDef assets fill:#f96,stroke:#333,stroke-width:1px
    classDef scenes fill:#6cf,stroke:#333,stroke-width:1px
    classDef scripts fill:#9f6,stroke:#333,stroke-width:1px
    classDef engine fill:#c9f,stroke:#333,stroke-width:1px
```
