# ccbluex/liquidbounce architecture

> Architecture diagram of the GitHub repository ccbluex/liquidbounce, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ccbluex/liquidbounce
- Repository: https://github.com/ccbluex/liquidbounce

## Overview

LiquidBounce is a Fabric-based Minecraft client that injects runtime changes into the game and provides a Svelte theme for interacting with client features. The main user flow is configuring features through the in-game interface, applying them during gameplay, and rendering their results in the HUD or world. Other visible capabilities include account management, multiplayer and proxy screens, cosmetics, and note-bot and deep-learning support. The graph combines documented product scope with sampled source; connections for unsampled subsystems are intentionally limited.

Main entry points: [`src-theme/src/integration`](https://github.com/ccbluex/liquidbounce/tree/nextgen/src-theme/src/integration) (Theme integration), [`src/main/kotlin/net/ccbluex/liquidbounce/features/module/modules`](https://github.com/ccbluex/liquidbounce/tree/nextgen/src/main/kotlin/net/ccbluex/liquidbounce/features/module/modules) (Client modules), [`src-theme/src/App.svelte`](https://github.com/ccbluex/liquidbounce/blob/nextgen/src-theme/src/App.svelte) (Theme application), [`src/main/kotlin/net/ccbluex/liquidbounce/features/module/modules/render/ModuleStorageESP.kt`](https://github.com/ccbluex/liquidbounce/blob/nextgen/src/main/kotlin/net/ccbluex/liquidbounce/features/module/modules/render/ModuleStorageESP.kt) (Storage ESP)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Client Runtime"]
  node_mixins["Game mixins"]
  node_interop["Client interop"]
  node_persistent[("Persistent client data")]
end

subgraph group_interface["Theme Interface"]
  node_theme["Theme application<br/>[App.svelte]"]
  node_clickgui["Click GUI"]
  node_menu["Client menus"]
  node_themebridge["Theme integration"]
  node_localstorage[("Browser storage")]
end

subgraph group_gameplay["Gameplay Features"]
  node_gamefeatures["Client modules"]
  node_notebot["Note-bot engine<br/>[NotebotEngine.kt]"]
  node_deeplearn["Deep learning"]
  node_storageesp["Storage ESP"]
end

subgraph group_rendering["Rendering"]
  node_hud["HUD components"]
  node_mesh["Cached mesh storage"]
  node_pipelines["Render pipelines"]
end

subgraph group_services["Accounts and Services"]
  node_accountui["Account manager"]
  node_session["Account session"]
  node_cosmetics["Cosmetics service<br/>[CosmeticService.kt]"]
end

node_player(("Player"))
node_minecraft["Minecraft client"]

node_player -->|"uses"| node_theme
node_theme -->|"routes to"| node_clickgui
node_theme -->|"routes to"| node_menu
node_clickgui -->|"uses"| node_themebridge
node_menu -->|"uses"| node_themebridge
node_themebridge -->|"syncs storage"| node_localstorage
node_mixins -->|"modifies at runtime"| node_minecraft
node_mixins -->|"invokes"| node_gamefeatures
node_themebridge -->|"bridges client calls"| node_interop
node_interop -->|"registers config"| node_persistent
node_accountui -->|"uses"| node_themebridge
node_session -->|"extends user session"| node_minecraft
node_gamefeatures -->|"includes"| node_notebot
node_gamefeatures -->|"includes"| node_storageesp
node_gamefeatures -->|"includes"| node_deeplearn
node_storageesp -->|"builds meshes"| node_mesh
node_storageesp -->|"selects pipelines"| node_pipelines
node_mesh -->|"uses"| node_pipelines
node_hud -->|"uses"| node_themebridge
node_cosmetics -->|"reads client session"| node_minecraft

click node_mixins "https://github.com/ccbluex/liquidbounce/tree/nextgen/src/main/java/net/ccbluex/liquidbounce/injection/mixins"
click node_theme "https://github.com/ccbluex/liquidbounce/blob/nextgen/src-theme/src/App.svelte"
click node_clickgui "https://github.com/ccbluex/liquidbounce/tree/nextgen/src-theme/src/routes/clickgui"
click node_menu "https://github.com/ccbluex/liquidbounce/tree/nextgen/src-theme/src/routes/menu"
click node_themebridge "https://github.com/ccbluex/liquidbounce/tree/nextgen/src-theme/src/integration"
click node_localstorage "https://github.com/ccbluex/liquidbounce/blob/nextgen/src-theme/src/integration/persistent_storage.ts"
click node_interop "https://github.com/ccbluex/liquidbounce/tree/nextgen/src/main/kotlin/net/ccbluex/liquidbounce/integration/interop"
click node_accountui "https://github.com/ccbluex/liquidbounce/tree/nextgen/src-theme/src/routes/menu/altmanager"
click node_session "https://github.com/ccbluex/liquidbounce/blob/nextgen/src/main/kotlin/net/ccbluex/liquidbounce/features/account/SessionWithService.kt"
click node_cosmetics "https://github.com/ccbluex/liquidbounce/blob/nextgen/src/main/kotlin/net/ccbluex/liquidbounce/features/cosmetic/CosmeticService.kt"
click node_gamefeatures "https://github.com/ccbluex/liquidbounce/tree/nextgen/src/main/kotlin/net/ccbluex/liquidbounce/features/module/modules"
click node_notebot "https://github.com/ccbluex/liquidbounce/blob/nextgen/src/main/kotlin/net/ccbluex/liquidbounce/features/module/modules/fun/notebot/NotebotEngine.kt"
click node_deeplearn "https://github.com/ccbluex/liquidbounce/blob/nextgen/src/main/kotlin/net/ccbluex/liquidbounce/deeplearn/DeepLearningEngine.kt"
click node_hud "https://github.com/ccbluex/liquidbounce/tree/nextgen/src-theme/src/routes/hud"
click node_storageesp "https://github.com/ccbluex/liquidbounce/blob/nextgen/src/main/kotlin/net/ccbluex/liquidbounce/features/module/modules/render/ModuleStorageESP.kt"
click node_mesh "https://github.com/ccbluex/liquidbounce/blob/nextgen/src/main/java/net/ccbluex/liquidbounce/render/CachedMeshStorage.java"
click node_pipelines "https://github.com/ccbluex/liquidbounce/blob/nextgen/src/main/kotlin/net/ccbluex/liquidbounce/render/ClientRenderPipelines.kt"
click node_persistent "https://github.com/ccbluex/liquidbounce/blob/nextgen/src/main/kotlin/net/ccbluex/liquidbounce/integration/interop/persistant/PersistentLocalStorage.kt"

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_mixins,node_interop,node_persistent,node_minecraft toneBlue
class node_theme,node_clickgui,node_menu,node_themebridge,node_localstorage toneAmber
class node_gamefeatures,node_notebot,node_deeplearn,node_storageesp toneMint
class node_hud,node_mesh,node_pipelines toneRose
class node_accountui,node_session,node_cosmetics,node_player toneIndigo
```

## Components

### Client Runtime

- [Game mixins](https://github.com/ccbluex/liquidbounce/tree/nextgen/src/main/java/net/ccbluex/liquidbounce/injection/mixins): `src/main/java/net/ccbluex/liquidbounce/injection/mixins`
- [Client interop](https://github.com/ccbluex/liquidbounce/tree/nextgen/src/main/kotlin/net/ccbluex/liquidbounce/integration/interop): `src/main/kotlin/net/ccbluex/liquidbounce/integration/interop`
- [Persistent client data](https://github.com/ccbluex/liquidbounce/blob/nextgen/src/main/kotlin/net/ccbluex/liquidbounce/integration/interop/persistant/PersistentLocalStorage.kt): `src/main/kotlin/net/ccbluex/liquidbounce/integration/interop/persistant/PersistentLocalStorage.kt`

### Theme Interface

- [Theme application](https://github.com/ccbluex/liquidbounce/blob/nextgen/src-theme/src/App.svelte): `src-theme/src/App.svelte`
- [Click GUI](https://github.com/ccbluex/liquidbounce/tree/nextgen/src-theme/src/routes/clickgui): `src-theme/src/routes/clickgui`
- [Client menus](https://github.com/ccbluex/liquidbounce/tree/nextgen/src-theme/src/routes/menu): `src-theme/src/routes/menu`
- [Theme integration](https://github.com/ccbluex/liquidbounce/tree/nextgen/src-theme/src/integration): `src-theme/src/integration`
- [Browser storage](https://github.com/ccbluex/liquidbounce/blob/nextgen/src-theme/src/integration/persistent_storage.ts): `src-theme/src/integration/persistent_storage.ts`

### Gameplay Features

- [Client modules](https://github.com/ccbluex/liquidbounce/tree/nextgen/src/main/kotlin/net/ccbluex/liquidbounce/features/module/modules): `src/main/kotlin/net/ccbluex/liquidbounce/features/module/modules`
- [Note-bot engine](https://github.com/ccbluex/liquidbounce/blob/nextgen/src/main/kotlin/net/ccbluex/liquidbounce/features/module/modules/fun/notebot/NotebotEngine.kt): `src/main/kotlin/net/ccbluex/liquidbounce/features/module/modules/fun/notebot/NotebotEngine.kt`
- [Deep learning](https://github.com/ccbluex/liquidbounce/blob/nextgen/src/main/kotlin/net/ccbluex/liquidbounce/deeplearn/DeepLearningEngine.kt): `src/main/kotlin/net/ccbluex/liquidbounce/deeplearn/DeepLearningEngine.kt`
- [Storage ESP](https://github.com/ccbluex/liquidbounce/blob/nextgen/src/main/kotlin/net/ccbluex/liquidbounce/features/module/modules/render/ModuleStorageESP.kt): `src/main/kotlin/net/ccbluex/liquidbounce/features/module/modules/render/ModuleStorageESP.kt`

### Rendering

- [HUD components](https://github.com/ccbluex/liquidbounce/tree/nextgen/src-theme/src/routes/hud): `src-theme/src/routes/hud`
- [Cached mesh storage](https://github.com/ccbluex/liquidbounce/blob/nextgen/src/main/java/net/ccbluex/liquidbounce/render/CachedMeshStorage.java): `src/main/java/net/ccbluex/liquidbounce/render/CachedMeshStorage.java`
- [Render pipelines](https://github.com/ccbluex/liquidbounce/blob/nextgen/src/main/kotlin/net/ccbluex/liquidbounce/render/ClientRenderPipelines.kt): `src/main/kotlin/net/ccbluex/liquidbounce/render/ClientRenderPipelines.kt`

### Accounts and Services

- [Account manager](https://github.com/ccbluex/liquidbounce/tree/nextgen/src-theme/src/routes/menu/altmanager): `src-theme/src/routes/menu/altmanager`
- [Account session](https://github.com/ccbluex/liquidbounce/blob/nextgen/src/main/kotlin/net/ccbluex/liquidbounce/features/account/SessionWithService.kt): `src/main/kotlin/net/ccbluex/liquidbounce/features/account/SessionWithService.kt`
- [Cosmetics service](https://github.com/ccbluex/liquidbounce/blob/nextgen/src/main/kotlin/net/ccbluex/liquidbounce/features/cosmetic/CosmeticService.kt): `src/main/kotlin/net/ccbluex/liquidbounce/features/cosmetic/CosmeticService.kt`

### Other components

- **Player**
- **Minecraft client**

## Connections

- Player → Theme application: uses
- Theme application → Click GUI: routes to
- Theme application → Client menus: routes to
- Click GUI → Theme integration: uses
- Client menus → Theme integration: uses
- Theme integration → Browser storage: syncs storage
- Game mixins → Minecraft client: modifies at runtime
- Game mixins → Client modules: invokes
- Theme integration → Client interop: bridges client calls
- Client interop → Persistent client data: registers config
- Account manager → Theme integration: uses
- Account session → Minecraft client: extends user session
- Client modules → Note-bot engine: includes
- Client modules → Storage ESP: includes
- Client modules → Deep learning: includes
- Storage ESP → Cached mesh storage: builds meshes
- Storage ESP → Render pipelines: selects pipelines
- Cached mesh storage → Render pipelines: uses
- HUD components → Theme integration: uses
- Cosmetics service → Minecraft client: reads client session