# bouncingelf10/animated-mojang-logo architecture

> Architecture diagram of the GitHub repository bouncingelf10/animated-mojang-logo, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-03-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bouncingelf10/animated-mojang-logo
- Repository: https://github.com/bouncingelf10/animated-mojang-logo

## Overview

This is a **Minecraft client mod** built for the **Fabric modding ecosystem** (Gradle-based). Its purpose is to **replace/augment the vanilla Minecraft loading/splash screen** with an **animated logo + startup jingle**, and it includes **compatibility with the “Dark Loading Screen” mod**.

So the “system” you’re diagramming is not a web backend; it’s a **runtime extension** loaded into the **Minecraft client** via **Fabric Loader**, using **Mixin** to modify Minecraft’s client classes during startup.

##### Build / Packaging / CI (out-of-game)
- `build.gradle`, `settings.gradle`, `gradle.properties`, `gradlew*`, `gradle/wrapper/*`
- `.github/workflows/build.yml`
- Output artifact: a **Fabric mod JAR** (built from Java + resources)

##### Mod metadata + Fabric integration
- `src/main/resources/fabric.mod.json`
- `src/main/resources/animated-logo.accesswidener`
Signals bytecode-level access widening (important because it affects what code can call/modify)
- `src/main/resources/animated-logo.mixins.json`
Declares which mixins apply and to what targets

##### Core mod logic (in-game runtime)
- `src/main/java/com/bouncingelf10/animatedLogo/AnimatedLogo.java`
Typically the **entrypoint / coordinator** of the mod (initialization, hooking logic, resource usage)
- `src/main/java/com/bouncingelf10/animatedLogo/mixin/SplashOverlayMixin.java`
The **primary injection point**: modifies Minecraft’s splash/loading overlay behavior
- `src/main/java/com/bouncingelf10/animatedLogo/DarkLoadingScreenCompat.java`
Compatibility layer / conditional logic when the external mod is present

##### Assets (resources consumed at runtime)
- `src/main/resources/assets/animated-mojang-logo/textures/gui/*`
- `src/main/resources/assets/animated-mojang-logo/sounds/startup.ogg`
- `src/main/resources/assets/animated-mojang-logo/sounds.json`
- `src/main/resources/assets/animated-mojang-logo/lang/*.json`

##### External dependency / optional integration
- `libs/darkloadingscreen.jar`
- External runtime platforms (not in tree but essential to show):
- **Minecraft Client**
- **Fabric Loader**
- **Mixin subsystem** (part of the Fabric toolchain/runtime)

##### Produces mod jar containing
- compiled classes from `src/main/java`
- resources from `src/main/resources`

- `GitHub Actions` → `Gradle build` → `Mod JAR artifact`

##### Phase 2: Game Startup → Mod Initialization → UI Replacement
At runtime, the important chain is:

##### `AnimatedLogo` logic coordinates
- selecting/animating textures
- triggering startup sound via the game sound system (registered via `sounds.json`, audio at `startup.ogg`)
- localization via `lang/*.json`
##### Optional: If Dark Loading Screen mod is present
- `DarkLoadingScreenCompat` alters behavior / coordinates with that mod to avoid conflicts and/or integrate visuals

- `Minecraft Client` → `Fabric Loader` → `Mod (Animated Logo)`
- `Fabric Loader` → `Mixin` → `Patched Minecraft Class: SplashOverlay` (or equivalent target)
- `Patched SplashOverlay` → calls/uses → `AnimatedLogo` (animation state, render steps)
- `AnimatedLogo` → reads → `Texture assets`
- `AnimatedLogo` → plays → `startup.ogg` via `Minecraft Sound System`
- `AnimatedLogo` ↔ `DarkLoadingScreenCompat` ↔ `Dark Loading Screen Mod` (conditional/optional edge)

##### “Invasive extension via bytecode transformation”
Mixin modifies Minecraft’s client classes at runtime. Show this as a distinct mechanism (not a normal API call).

##### “Entry-point + injected hooks”
There is a coordinator (likely `AnimatedLogo`) and a hook/injection point (`SplashOverlayMixin`).

##### “Resource-driven UI”
The animation and sound rely heavily on packaged assets (textures/sounds/lang). These should be first-class nodes, not footnotes.

##### “Optional compat adapter”
`DarkLoadingScreenCompat` is an adapter layer. Show it as conditional: only active if the other mod is present.

##### External mods layer: Dark Loading Screen (optional)

This layering makes the runtime patching model obvious and prevents the common mistake of drawing it like a normal plugin with stable APIs.

##### What
At minimum, include these nodes:
- **Minecraft Client**
- **Fabric Loader**
- **Mixin Framework**
- **Animated Minecraft Logo Mod**
- `AnimatedLogo.java` (Entrypoint/Coordinator)
- `SplashOverlayMixin.java` (Injection/Hook)
- `DarkLoadingScreenCompat.java` (Compat Adapter)
- **Resources**
- textures (logo frames)
- sound (`startup.ogg`)
- `sounds.json`
- `lang/*.json`
- `fabric.mod.json`
- `animated-logo.mixins.json`
- `animated-logo.accesswidener`
- **Dark Loading Screen Mod** (optional)
- **Build pipeline**
- GitHub Actions build workflow
- Gradle wrapper / Gradle build
- Output: Mod Jar

Focus on:
- Minecraft startup
- Fabric Loader discovery
- Mixin patching of splash overlay
- Animated rendering + audio
- Optional compat path

Focus on:
- source tree inputs
- Gradle tasks
- resource packaging
- output jar
- CI workflow

##### Under them: Animated Logo Mod
5. Bottom: **Assets/Resources** cluster (textures, sounds, lang, + mixin config/access widener/manifest)

## Diagram (Mermaid)

```mermaid
flowchart TD

%% =========================
%% Diagram A: Runtime Architecture
%% =========================
subgraph "Diagram A — Runtime Architecture (Game Startup → UI Replacement)"
direction TB

subgraph "Platform Layer (Runtime)"
direction TB
MC["Minecraft Client"]:::platform
FL["Fabric Loader"]:::platform
MX["Mixin Framework"]:::platform
SS["Minecraft Sound System"]:::platform
end

subgraph "Mod Layer (Animated Minecraft Logo Mod)"
direction TB
MOD["Animated Minecraft Logo Mod"]:::mod
AL["AnimatedLogo (Entrypoint/Coordinator)"]:::code
SOM["SplashOverlayMixin (Injection/Hook)"]:::code
DLC["DarkLoadingScreenCompat (Compat Adapter)"]:::code
end

subgraph "Patched Game Code (Post-Mixin)"
direction TB
PSO["Patched SplashOverlay (Minecraft Class)"]:::patched
end

subgraph "Resources Layer (Packaged in Mod JAR)"
direction TB
FMJ["fabric.mod.json (Mod Registration Manifest)"]:::res
AW["animated-logo.accesswidener (Access Widener)"]:::res
MIXCFG["animated-logo.mixins.json (Mixin Declarations)"]:::res

subgraph "Runtime Assets (Resource-driven UI)"
direction TB
ASROOT["assets/animated-mojang-logo (Resource Root)"]:::res
TEX["Textures (Animated Logo Frames/UI)"]:::res
SJSON["sounds.json (Sound Registration)"]:::res
SOGG["startup.ogg (Startup Jingle)"]:::res
LANG["lang/*.json (Localization)"]:::res
end
end

subgraph "External Mods (Optional)"
direction TB
DLS["Dark Loading Screen Mod"]:::externalMod
end

%% --- Runtime flow ---
MC -->|"startup"| FL
MC -->|"runs"| SS
FL -.->|"discovers_mods_via"| FMJ
FL -.->|"loads_mixin_config"| MIXCFG
FL -.->|"applies_access_widener"| AW

FL -->|"initializes"| MOD
MOD -->|"entrypoint_calls"| AL

MX -.->|"configured_by"| MIXCFG
MX ==>|"bytecode_injection"| PSO
SOM -->|"defines_injection"| MX
SOM -.->|"targets"| PSO

PSO -->|"calls_render/animate"| AL

AL -->|"loads"| TEX
AL -->|"reads"| LANG
AL -->|"uses"| SJSON
AL -->|"plays"| SS
SS -->|"loads_audio"| SOGG

AL -->|"delegates_optional"| DLC
DLC -.->|"conditional(mod_present)"| DLS
DLC <-->|"compat_calls"| DLS

%% --- Resource containment ---
ASROOT -->|"contains"| TEX
ASROOT -->|"contains"| SJSON
ASROOT -->|"contains"| SOGG
ASROOT -->|"contains"| LANG

end

%% =========================
%% Diagram B: Build / Packaging Architecture
%% =========================
subgraph "Diagram B — Build / Packaging / CI (Source → Mod JAR Artifact)"
direction TB

DEV["Developer / Repo Working Copy"]:::build
GHA["GitHub Actions Workflow"]:::build
GRADLE["Gradle Build (Wrapper-based)"]:::build
JAR["Output: Fabric Mod JAR Artifact"]:::artifact

subgraph "Build Inputs (Configuration)"
direction TB
BG["build.gradle"]:::buildFile
SG["settings.gradle"]:::buildFile
GP["gradle.properties"]:::buildFile
GW["gradlew"]:::buildFile
GWB["gradlew.bat"]:::buildFile
GWJ["gradle-wrapper.jar"]:::buildFile
GWP["gradle-wrapper.properties"]:::buildFile
end

subgraph "Packaged Outputs (Classes + Resources)"
direction TB
JAVA["Compiled Java Classes (src/main/java)"]:::artifactPart
RES["Packaged Resources (src/main/resources)"]:::artifactPart
DLSJ["libs/darkloadingscreen.jar (Optional Compile/Runtime Compat)"]:::externalMod
end

DEV -->|"push/PR_triggers"| GHA
GHA -->|"runs"| GRADLE

GRADLE -->|"uses"| BG
GRADLE -->|"uses"| SG
GRADLE -->|"uses"| GP
GRADLE -->|"invoked_by"| GW
GRADLE -->|"invoked_by"| GWB
GRADLE -->|"uses"| GWJ
GRADLE -->|"uses"| GWP

GRADLE -->|"compiles"| JAVA
GRADLE -->|"packages"| RES
GRADLE -.->|"depends_on(optional)"| DLSJ

JAVA -->|"bundled_into"| JAR
RES -->|"bundled_into"| JAR
end

%% =========================
%% Click Events (from component_mapping)
%% =========================
click GHA "https://github.com/bouncingelf10/animated-mojang-logo/blob/master/.github/workflows/build.yml"
click BG "https://github.com/bouncingelf10/animated-mojang-logo/blob/master/build.gradle"
click SG "https://github.com/bouncingelf10/animated-mojang-logo/blob/master/settings.gradle"
click GP "https://github.com/bouncingelf10/animated-mojang-logo/blob/master/gradle.properties"
click GW "https://github.com/bouncingelf10/animated-mojang-logo/tree/master/gradlew"
click GWB "https://github.com/bouncingelf10/animated-mojang-logo/blob/master/gradlew.bat"
click GWJ "https://github.com/bouncingelf10/animated-mojang-logo/blob/master/gradle/wrapper/gradle-wrapper.jar"
click GWP "https://github.com/bouncingelf10/animated-mojang-logo/blob/master/gradle/wrapper/gradle-wrapper.properties"

click FMJ "https://github.com/bouncingelf10/animated-mojang-logo/blob/master/src/main/resources/fabric.mod.json"
click AW "https://github.com/bouncingelf10/animated-mojang-logo/blob/master/src/main/resources/animated-logo.accesswidener"
click MIXCFG "https://github.com/bouncingelf10/animated-mojang-logo/blob/master/src/main/resources/animated-logo.mixins.json"

click AL "https://github.com/bouncingelf10/animated-mojang-logo/blob/master/src/main/java/com/bouncingelf10/animatedLogo/AnimatedLogo.java"
click SOM "https://github.com/bouncingelf10/animated-mojang-logo/blob/master/src/main/java/com/bouncingelf10/animatedLogo/mixin/SplashOverlayMixin.java"
click DLC "https://github.com/bouncingelf10/animated-mojang-logo/blob/master/src/main/java/com/bouncingelf10/animatedLogo/DarkLoadingScreenCompat.java"

click ASROOT "https://github.com/bouncingelf10/animated-mojang-logo/tree/master/src/main/resources/assets/animated-mojang-logo"
click TEX "https://github.com/bouncingelf10/animated-mojang-logo/tree/master/src/main/resources/assets/animated-mojang-logo/textures/gui"
click SJSON "https://github.com/bouncingelf10/animated-mojang-logo/blob/master/src/main/resources/assets/animated-mojang-logo/sounds.json"
click SOGG "https://github.com/bouncingelf10/animated-mojang-logo/blob/master/src/main/resources/assets/animated-mojang-logo/sounds/startup.ogg"
click LANG "https://github.com/bouncingelf10/animated-mojang-logo/blob/master/src/main/resources/assets/animated-mojang-logo/lang/en_us.json"
click DLSJ "https://github.com/bouncingelf10/animated-mojang-logo/blob/master/libs/darkloadingscreen.jar"

%% =========================
%% Styles (Color coding)
%% =========================
classDef platform fill:#e5e7eb,stroke:#6b7280,color:#111827,stroke-width:1px
classDef mod fill:#dbeafe,stroke:#2563eb,color:#0f172a,stroke-width:1px
classDef code fill:#bfdbfe,stroke:#1d4ed8,color:#0f172a,stroke-width:1px
classDef patched fill:#c7d2fe,stroke:#4338ca,color:#0f172a,stroke-width:2px
classDef res fill:#dcfce7,stroke:#16a34a,color:#052e16,stroke-width:1px
classDef externalMod fill:#f3e8ff,stroke:#7c3aed,color:#2e1065,stroke-width:1px
classDef build fill:#ffedd5,stroke:#ea580c,color:#431407,stroke-width:1px
classDef buildFile fill:#fed7aa,stroke:#c2410c,color:#431407,stroke-width:1px
classDef artifact fill:#fde68a,stroke:#a16207,color:#3f2d0b,stroke-width:2px
classDef artifactPart fill:#fef3c7,stroke:#b45309,color:#3f2d0b,stroke-width:1px
```
