# meteordevelopment/meteor-client architecture

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

- Interactive diagram: https://gitdiagram.com/meteordevelopment/meteor-client
- Repository: https://github.com/meteordevelopment/meteor-client

## Overview

Meteor is a Fabric utility mod for Minecraft anarchy servers. Its runtime brings up the client, discovers addons, loads systems and configuration, and exposes in-game controls such as commands and GUI tabs for operating modules. Modules respond to game events and can affect gameplay or rendering; the repository also includes HUD, waypoint, account, proxy, and pathing capabilities. The README establishes the product purpose; relationships below are limited to shown source references and excerpts, so the graph is not a complete runtime trace.

Main entry points: [`src/main/java/meteordevelopment/meteorclient/MeteorClient.java`](https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/MeteorClient.java) (Meteor client), [`src/main/java/meteordevelopment/meteorclient/systems/modules/render/StorageESP.java`](https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/systems/modules/render/StorageESP.java) (Storage ESP), [`src/main/java/meteordevelopment/meteorclient/systems/modules/Modules.java`](https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/systems/modules/Modules.java) (Module registry), [`src/main/java/meteordevelopment/meteorclient/pathing/PathManagers.java`](https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/pathing/PathManagers.java) (Path manager selection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Client runtime"]
  node_meteor["Meteor client<br/>[MeteorClient.java]"]
  node_addons["Addon manager<br/>[AddonManager.java]"]
  node_addon_api["Addon API<br/>[MeteorAddon.java]"]
  node_systems["Systems<br/>[System.java]"]
end

subgraph group_controls["Player controls"]
  node_commands["Commands<br/>[Commands.java]"]
  node_gui["GUI themes<br/>[GuiTheme.java]"]
  node_path_tab["Path manager tab"]
  node_storage_screen["Storage selection screen"]
  node_hud["HUD system<br/>[HudRenderer.java]"]
end

subgraph group_features["Gameplay features"]
  node_modules["Module registry<br/>[Modules.java]"]
  node_path_managers["Path manager selection<br/>[PathManagers.java]"]
  node_baritone["Baritone adapter"]
  node_nop_path["Fallback pathing"]
  node_storage_esp["Storage ESP<br/>[StorageESP.java]"]
  node_storage_setting["Storage block setting"]
  node_waypoints["Waypoints<br/>[Waypoint.java]"]
  node_accounts["Accounts"]
  node_proxies["Proxy system<br/>[Proxy.java]"]
end

subgraph group_rendering["Rendering"]
  node_render_pipelines["Render pipelines"]
  node_storage_shader["Storage outline shader"]
end

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

node_meteor -->|"initializes"| node_addons
node_addons -->|"discovers"| node_addon_api
node_meteor -->|"loads"| node_systems
node_meteor -->|"sorts"| node_modules
node_player -.->|"opens"| node_gui
node_player -.->|"invokes"| node_commands
node_gui -.->|"configures"| node_modules
node_commands -.->|"controls"| node_modules
node_path_tab -->|"accesses"| node_path_managers
node_path_managers -->|"selects"| node_baritone
node_path_managers -->|"defaults to"| node_nop_path
node_modules -->|"registers"| node_storage_esp
node_storage_esp -->|"uses"| node_storage_setting
node_storage_screen -->|"edits"| node_storage_setting
node_storage_esp -->|"renders with"| node_render_pipelines
node_storage_shader -->|"checks mode"| node_storage_esp
node_storage_shader -->|"uses"| node_render_pipelines
node_minecraft -.->|"hosts"| node_meteor

click node_meteor "https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/MeteorClient.java"
click node_addons "https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/addons/AddonManager.java"
click node_addon_api "https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/addons/MeteorAddon.java"
click node_systems "https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/systems/System.java"
click node_modules "https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/systems/modules/Modules.java"
click node_commands "https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/commands/Commands.java"
click node_gui "https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/gui/GuiTheme.java"
click node_path_tab "https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/gui/tabs/builtin/PathManagerTab.java"
click node_path_managers "https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/pathing/PathManagers.java"
click node_baritone "https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/pathing/BaritonePathManager.java"
click node_nop_path "https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/pathing/NopPathManager.java"
click node_storage_esp "https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/systems/modules/render/StorageESP.java"
click node_storage_setting "https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/settings/StorageBlockListSetting.java"
click node_storage_screen "https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/gui/screens/settings/StorageBlockListSettingScreen.java"
click node_render_pipelines "https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/renderer/MeteorRenderPipelines.java"
click node_storage_shader "https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/utils/render/postprocess/StorageOutlineShader.java"
click node_hud "https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/systems/hud/HudRenderer.java"
click node_waypoints "https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/systems/waypoints/Waypoint.java"
click node_accounts "https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/systems/accounts/types/SessionAccount.java"
click node_proxies "https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/systems/proxies/Proxy.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_meteor,node_addons,node_addon_api,node_systems,node_minecraft toneBlue
class node_commands,node_gui,node_path_tab,node_storage_screen,node_hud toneAmber
class node_modules,node_path_managers,node_baritone,node_nop_path,node_storage_esp,node_storage_setting,node_waypoints,node_accounts,node_proxies toneMint
class node_render_pipelines,node_storage_shader toneRose
class node_player toneIndigo
```

## Components

### Client runtime

- [Meteor client](https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/MeteorClient.java): `src/main/java/meteordevelopment/meteorclient/MeteorClient.java`
- [Addon manager](https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/addons/AddonManager.java): `src/main/java/meteordevelopment/meteorclient/addons/AddonManager.java`
- [Addon API](https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/addons/MeteorAddon.java): `src/main/java/meteordevelopment/meteorclient/addons/MeteorAddon.java`
- [Systems](https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/systems/System.java): `src/main/java/meteordevelopment/meteorclient/systems/System.java`

### Player controls

- [Commands](https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/commands/Commands.java): `src/main/java/meteordevelopment/meteorclient/commands/Commands.java`
- [GUI themes](https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/gui/GuiTheme.java): `src/main/java/meteordevelopment/meteorclient/gui/GuiTheme.java`
- [Path manager tab](https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/gui/tabs/builtin/PathManagerTab.java): `src/main/java/meteordevelopment/meteorclient/gui/tabs/builtin/PathManagerTab.java`
- [Storage selection screen](https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/gui/screens/settings/StorageBlockListSettingScreen.java): `src/main/java/meteordevelopment/meteorclient/gui/screens/settings/StorageBlockListSettingScreen.java`
- [HUD system](https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/systems/hud/HudRenderer.java): `src/main/java/meteordevelopment/meteorclient/systems/hud/HudRenderer.java`

### Gameplay features

- [Module registry](https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/systems/modules/Modules.java): `src/main/java/meteordevelopment/meteorclient/systems/modules/Modules.java`
- [Path manager selection](https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/pathing/PathManagers.java): `src/main/java/meteordevelopment/meteorclient/pathing/PathManagers.java`
- [Baritone adapter](https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/pathing/BaritonePathManager.java): `src/main/java/meteordevelopment/meteorclient/pathing/BaritonePathManager.java`
- [Fallback pathing](https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/pathing/NopPathManager.java): `src/main/java/meteordevelopment/meteorclient/pathing/NopPathManager.java`
- [Storage ESP](https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/systems/modules/render/StorageESP.java): `src/main/java/meteordevelopment/meteorclient/systems/modules/render/StorageESP.java`
- [Storage block setting](https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/settings/StorageBlockListSetting.java): `src/main/java/meteordevelopment/meteorclient/settings/StorageBlockListSetting.java`
- [Waypoints](https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/systems/waypoints/Waypoint.java): `src/main/java/meteordevelopment/meteorclient/systems/waypoints/Waypoint.java`
- [Accounts](https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/systems/accounts/types/SessionAccount.java): `src/main/java/meteordevelopment/meteorclient/systems/accounts/types/SessionAccount.java`
- [Proxy system](https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/systems/proxies/Proxy.java): `src/main/java/meteordevelopment/meteorclient/systems/proxies/Proxy.java`

### Rendering

- [Render pipelines](https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/renderer/MeteorRenderPipelines.java): `src/main/java/meteordevelopment/meteorclient/renderer/MeteorRenderPipelines.java`
- [Storage outline shader](https://github.com/meteordevelopment/meteor-client/blob/master/src/main/java/meteordevelopment/meteorclient/utils/render/postprocess/StorageOutlineShader.java): `src/main/java/meteordevelopment/meteorclient/utils/render/postprocess/StorageOutlineShader.java`

### Other components

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

## Connections

- Meteor client → Addon manager: initializes (evidence: `src/main/java/meteordevelopment/meteorclient/MeteorClient.java`)
- Addon manager → Addon API: discovers (evidence: `src/main/java/meteordevelopment/meteorclient/addons/AddonManager.java`)
- Meteor client → Systems: loads (evidence: `src/main/java/meteordevelopment/meteorclient/MeteorClient.java`)
- Meteor client → Module registry: sorts (evidence: `src/main/java/meteordevelopment/meteorclient/MeteorClient.java`)
- Player → GUI themes: opens
- Player → Commands: invokes
- GUI themes → Module registry: configures
- Commands → Module registry: controls
- Path manager tab → Path manager selection: accesses (evidence: `src/main/java/meteordevelopment/meteorclient/gui/tabs/builtin/PathManagerTab.java`)
- Path manager selection → Baritone adapter: selects (evidence: `src/main/java/meteordevelopment/meteorclient/pathing/PathManagers.java`)
- Path manager selection → Fallback pathing: defaults to (evidence: `src/main/java/meteordevelopment/meteorclient/pathing/PathManagers.java`)
- Module registry → Storage ESP: registers (evidence: `src/main/java/meteordevelopment/meteorclient/systems/modules/render/StorageESP.java`)
- Storage ESP → Storage block setting: uses (evidence: `src/main/java/meteordevelopment/meteorclient/systems/modules/render/StorageESP.java`)
- Storage selection screen → Storage block setting: edits (evidence: `src/main/java/meteordevelopment/meteorclient/gui/screens/settings/StorageBlockListSettingScreen.java`)
- Storage ESP → Render pipelines: renders with (evidence: `src/main/java/meteordevelopment/meteorclient/systems/modules/render/StorageESP.java`)
- Storage outline shader → Storage ESP: checks mode (evidence: `src/main/java/meteordevelopment/meteorclient/utils/render/postprocess/StorageOutlineShader.java`)
- Storage outline shader → Render pipelines: uses (evidence: `src/main/java/meteordevelopment/meteorclient/utils/render/postprocess/StorageOutlineShader.java`)
- Minecraft client → Meteor client: hosts
