# ishuamouren/better-loading-screen-mod architecture

> Architecture diagram of the GitHub repository ishuamouren/better-loading-screen-mod, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ishuamouren/better-loading-screen-mod
- Repository: https://github.com/ishuamouren/better-loading-screen-mod

## Overview

Better Loading Screen is a Fabric mod that replaces Minecraft’s world-loading display with an animated screen showing loading text and progress, including during dimension transitions. The game’s loading-screen render hook draws the interface and reads shared settings. Settings load and save as JSON; an optional Mod Menu integration opens a Cloth Config screen for editing them. The README documents the visual features and dependencies; implementation links below are based on the shown source excerpts.

Main entry points: [`src/main/java/me/mouren/better_loading_screen/utils/ConfigManager.java`](https://github.com/ishuamouren/better-loading-screen-mod/blob/main/src/main/java/me/mouren/better_loading_screen/utils/ConfigManager.java) (Config manager), [`src/main/java/me/mouren/better_loading_screen/mixin/LevelLoadingScreenMixin.java`](https://github.com/ishuamouren/better-loading-screen-mod/blob/main/src/main/java/me/mouren/better_loading_screen/mixin/LevelLoadingScreenMixin.java) (Loading render hook), [`src/main/java/me/mouren/better_loading_screen/gui/ConfigScreen.java`](https://github.com/ishuamouren/better-loading-screen-mod/blob/main/src/main/java/me/mouren/better_loading_screen/gui/ConfigScreen.java) (Settings screen), [`src/main/java/me/mouren/better_loading_screen/JsonConfig.java`](https://github.com/ishuamouren/better-loading-screen-mod/blob/main/src/main/java/me/mouren/better_loading_screen/JsonConfig.java) (Settings model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_render["Loading display"]
  node_render_hook["Loading render hook"]
  node_animation["Loading animation"]
end

subgraph group_config["Configuration"]
  node_config_screen["Settings screen<br/>[ConfigScreen.java]"]
  node_config_manager["Config manager<br/>[ConfigManager.java]"]
  node_settings["Settings model<br/>[JsonConfig.java]"]
  node_config_file[("Config JSON")]
end

subgraph group_integration["Mod integration"]
  node_initializer["Mod initializer"]
  node_mod_menu["Mod Menu entry"]
end

node_game(("Minecraft"))

node_game -->|"invokes render"| node_render_hook
node_render_hook -->|"draws frames"| node_animation
node_render_hook -->|"reads options"| node_settings
node_initializer -->|"loads settings"| node_config_manager
node_config_manager -->|"populates defaults"| node_settings
node_config_manager -->|"reads and writes"| node_config_file
node_mod_menu -->|"opens screen"| node_config_screen
node_config_screen -->|"edits options"| node_settings
node_config_screen -->|"saves settings"| node_config_manager

click node_render_hook "https://github.com/ishuamouren/better-loading-screen-mod/blob/main/src/main/java/me/mouren/better_loading_screen/mixin/LevelLoadingScreenMixin.java"
click node_animation "https://github.com/ishuamouren/better-loading-screen-mod/tree/main/src/main/resources/assets/betterloadingscreen/textures/gui"
click node_initializer "https://github.com/ishuamouren/better-loading-screen-mod/blob/main/src/main/java/me/mouren/better_loading_screen/BetterLoadingScreen.java"
click node_mod_menu "https://github.com/ishuamouren/better-loading-screen-mod/blob/main/src/main/java/me/mouren/better_loading_screen/ModMenuIntegration.java"
click node_config_screen "https://github.com/ishuamouren/better-loading-screen-mod/blob/main/src/main/java/me/mouren/better_loading_screen/gui/ConfigScreen.java"
click node_config_manager "https://github.com/ishuamouren/better-loading-screen-mod/blob/main/src/main/java/me/mouren/better_loading_screen/utils/ConfigManager.java"
click node_settings "https://github.com/ishuamouren/better-loading-screen-mod/blob/main/src/main/java/me/mouren/better_loading_screen/JsonConfig.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_render_hook,node_animation toneBlue
class node_config_screen,node_config_manager,node_settings,node_config_file toneAmber
class node_initializer,node_mod_menu toneMint
class node_game toneIndigo
```

## Components

### Loading display

- [Loading render hook](https://github.com/ishuamouren/better-loading-screen-mod/blob/main/src/main/java/me/mouren/better_loading_screen/mixin/LevelLoadingScreenMixin.java): `src/main/java/me/mouren/better_loading_screen/mixin/LevelLoadingScreenMixin.java`
- [Loading animation](https://github.com/ishuamouren/better-loading-screen-mod/tree/main/src/main/resources/assets/betterloadingscreen/textures/gui): `src/main/resources/assets/betterloadingscreen/textures/gui`

### Configuration

- [Settings screen](https://github.com/ishuamouren/better-loading-screen-mod/blob/main/src/main/java/me/mouren/better_loading_screen/gui/ConfigScreen.java): `src/main/java/me/mouren/better_loading_screen/gui/ConfigScreen.java`
- [Config manager](https://github.com/ishuamouren/better-loading-screen-mod/blob/main/src/main/java/me/mouren/better_loading_screen/utils/ConfigManager.java): `src/main/java/me/mouren/better_loading_screen/utils/ConfigManager.java`
- [Settings model](https://github.com/ishuamouren/better-loading-screen-mod/blob/main/src/main/java/me/mouren/better_loading_screen/JsonConfig.java): `src/main/java/me/mouren/better_loading_screen/JsonConfig.java`
- **Config JSON**

### Mod integration

- [Mod initializer](https://github.com/ishuamouren/better-loading-screen-mod/blob/main/src/main/java/me/mouren/better_loading_screen/BetterLoadingScreen.java): `src/main/java/me/mouren/better_loading_screen/BetterLoadingScreen.java`
- [Mod Menu entry](https://github.com/ishuamouren/better-loading-screen-mod/blob/main/src/main/java/me/mouren/better_loading_screen/ModMenuIntegration.java): `src/main/java/me/mouren/better_loading_screen/ModMenuIntegration.java`

### Other components

- **Minecraft**

## Connections

- Minecraft → Loading render hook: invokes render (evidence: `src/main/java/me/mouren/better_loading_screen/mixin/LevelLoadingScreenMixin.java`)
- Loading render hook → Loading animation: draws frames (evidence: `src/main/java/me/mouren/better_loading_screen/mixin/LevelLoadingScreenMixin.java`)
- Loading render hook → Settings model: reads options (evidence: `src/main/java/me/mouren/better_loading_screen/mixin/LevelLoadingScreenMixin.java`)
- Mod initializer → Config manager: loads settings (evidence: `src/main/java/me/mouren/better_loading_screen/BetterLoadingScreen.java`)
- Config manager → Settings model: populates defaults (evidence: `src/main/java/me/mouren/better_loading_screen/utils/ConfigManager.java`)
- Config manager → Config JSON: reads and writes (evidence: `src/main/java/me/mouren/better_loading_screen/utils/ConfigManager.java`)
- Mod Menu entry → Settings screen: opens screen (evidence: `src/main/java/me/mouren/better_loading_screen/ModMenuIntegration.java`)
- Settings screen → Settings model: edits options (evidence: `src/main/java/me/mouren/better_loading_screen/gui/ConfigScreen.java`)
- Settings screen → Config manager: saves settings (evidence: `src/main/java/me/mouren/better_loading_screen/gui/ConfigScreen.java`)
