# sanciro99/not-cero architecture

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

- Interactive diagram: https://gitdiagram.com/sanciro99/not-cero
- Repository: https://github.com/sanciro99/not-cero

## Overview

##### Project Type and Purpose
- This is a libGDX–based, multi-module Java game/application template generated by gdx-liftoff. It uses a “core” module for shared game logic and a “lwjgl3” module as the primary desktop launcher.

##### High-Level File Structure Analysis
- Root
– build.gradle, settings.gradle, Gradle wrapper files – orchestrate multi-project builds.
– assets/… – all game assets (fonts, atlases, skins) for runtime loading.
- core/
– src/main/java/io/github/Sanciro99/notcero/Main.java – extends ApplicationAdapter with game logic.
- lwjgl3/
– src/main/java/io/github/Sanciro99/notcero/lwjgl3/Lwjgl3Launcher.java – desktop entry point.
– StartupHelper.java – config helper for window, resolution, etc.
– nativeimage.gradle – for GraalVM native image tasks.

##### Key Insights from README
- “core” holds cross-platform application logic.
- “lwjgl3” is the desktop platform module, builds a runnable JAR or native image.
- Uses Gradle for dependency management, multi-project builds, and platform-specific tasks.

a. Core Module
– Game Loop & Logic (ApplicationAdapter subclass)
– AssetManager usage for fonts/skins/atlases
b. Platform Module (LWJGL3)
– Lwjgl3Launcher → initializes Application Configuration → invokes core.Main
c. External Frameworks & Libraries
– libGDX API (graphics, input, audio subsystems)
– LWJGL3 bindings (OpenGL, windowing, input)
d. Build & Deployment
– Gradle Wrapper & Settings.gradle
– Tasks: core:build, lwjgl3:jar/run, native image

##### Component Relationships & Data Flow
– Launcher → Core.Main (start game)
– Core.Main → libGDX API calls (render(), update(), input polling)
– libGDX → LWJGL3 native layer → OS/HW
– Core or Launcher → AssetManager loads assets/… → GPU/texture cache
– Developer/CI → Gradle → compiles core + lwjgl3 → jar or native image

##### Architectural Patterns & Principles
– Module separation: core is platform-agnostic; platform modules provide bootstrap.
– Dependency Inversion: core depends only on libGDX interfaces, not on specific backends.
– Single Responsibility: Launcher config vs. game logic vs. assets.

##### Technologies & Frameworks to Annotate
– Java 11+ (or configured JDK)
– Gradle (wrapper)
– libGDX (“core” API)
– LWJGL3 backend
– (Optional) GraalVM native image plugin

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Build & Deployment Layer
    subgraph "Build & Deployment" 
        direction TB
        BuildGradle["build.gradle"]:::build
        Settings["settings.gradle"]:::build
        GradleWrapper["Gradle Wrapper\n(gradlew, wrapper files)"]:::build
    end

    %% Top Layer: Desktop Launcher
    subgraph "Desktop Launcher" 
        direction TB
        Launcher["Lwjgl3Launcher.java"]:::code
        StartupHelper["StartupHelper.java"]:::code
    end

    %% Core Game Module
    subgraph "Core Module" 
        direction TB
        CoreMain["Main.java\n(ApplicationAdapter)"]:::code
        AssetManagerSvc["AssetManager"]:::service
    end

    %% Assets
    Assets["assets/ (fonts, skins, atlases)"]:::assets

    %% Framework Layer
    subgraph "Framework Layer"
        direction TB
        LibGDX["libGDX API\n(Graphics, Input, Audio)"]:::framework
        LWJGL3Bindings["LWJGL3 Bindings\n(OpenGL, Windowing)"]:::framework
    end

    %% Native Layer
    OS["OS / Hardware"]:::native

    %% Native Image Script
    NativeScript["nativeimage.gradle"]:::build

    %% Module Directories
    CoreModule["core/"]:::code
    LWJGLModule["lwjgl3/"]:::code

    %% Developer/CI node
    DevCI["Developer / CI"]:::external

    %% Connections
    DevCI -->|"invokes"| GradleWrapper
    GradleWrapper -->|"orchestrates"| BuildGradle
    BuildGradle -->|"includes modules"| Settings
    BuildGradle -->|"builds"| CoreModule
    BuildGradle -->|"builds"| LWJGLModule
    BuildGradle -->|"executes"| NativeScript

    Launcher -->|"starts game"| CoreMain
    CoreMain -->|"uses"| AssetManagerSvc
    AssetManagerSvc -->|"loads from"| Assets
    CoreMain -->|"calls"| LibGDX
    LibGDX -->|"binds to"| LWJGL3Bindings
    LWJGL3Bindings -->|"interfaces with"| OS

    %% Click Events
    click CoreMain "https://github.com/sanciro99/not-cero/blob/master/core/src/main/java/io/github/Sanciro99/notcero/Main.java"
    click CoreModule "https://github.com/sanciro99/not-cero/tree/master/core/"
    click Assets "https://github.com/sanciro99/not-cero/tree/master/assets/"
    click Launcher "https://github.com/sanciro99/not-cero/blob/master/lwjgl3/src/main/java/io/github/Sanciro99/notcero/lwjgl3/Lwjgl3Launcher.java"
    click StartupHelper "https://github.com/sanciro99/not-cero/blob/master/lwjgl3/src/main/java/io/github/Sanciro99/notcero/lwjgl3/StartupHelper.java"
    click NativeScript "https://github.com/sanciro99/not-cero/blob/master/lwjgl3/nativeimage.gradle"
    click LWJGLModule "https://github.com/sanciro99/not-cero/tree/master/lwjgl3/"
    click BuildGradle "https://github.com/sanciro99/not-cero/blob/master/build.gradle"
    click Settings "https://github.com/sanciro99/not-cero/blob/master/settings.gradle"
    click GradleWrapper "https://github.com/sanciro99/not-cero/tree/master/gradlew"

    %% Styles
    classDef code fill:#b5e7a0,stroke:#4caf50,color:#000
    classDef framework fill:#a0c4ff,stroke:#2196f3,color:#000
    classDef assets fill:#fff3b0,stroke:#ffeb3b,color:#000
    classDef build fill:#e0e0e0,stroke:#9e9e9e,color:#000
    classDef service fill:#c8e6c9,stroke:#4caf50,color:#000
    classDef native fill:#d7ccc8,stroke:#795548,color:#000
    classDef external fill:#eeeeee,stroke:#757575,color:#000
```
