# yukkitmc/yukkit-toolkit architecture

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

- Interactive diagram: https://gitdiagram.com/yukkitmc/yukkit-toolkit
- Repository: https://github.com/yukkitmc/yukkit-toolkit

## Overview

Yukkit Toolkit is a client-side Minecraft utility mod. Players open its vanilla-style options or module screen, configure tools, and use them during play; the client initializer also runs registered modules and dedicated automation, HUD, map, and capture ticks. Major feature families are represented at subsystem level, including documented capabilities whose implementation was not sampled. Relationships below are limited to README statements and visible source references; many feature internals and mixin connections were not inspected.

Main entry points: [`src/main/java/dev/yukkit/toolkit/YukkitToolkitClient.java`](https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/YukkitToolkitClient.java) (Client Initializer), [`src/main/java/dev/yukkit/toolkit/modules/framework/ModuleRegistry.java`](https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/modules/framework/ModuleRegistry.java) (Module Registry), [`src/main/java/dev/yukkit/toolkit/screen/ToolkitScreen.java`](https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/screen/ToolkitScreen.java) (Options Screen), [`src/main/java/dev/yukkit/toolkit/screen/ModuleScreen.java`](https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/screen/ModuleScreen.java) (Module Screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Client App"]
  node_client["Client Initializer"]
  node_module_registry["Module Registry"]
  node_module_manager["Legacy Module Manager<br/>[ModuleManager.java]"]
end

subgraph group_modules["Gameplay Modules"]
  node_combat["Combat Modules"]
  node_movement["Movement Modules"]
  node_player_tools["Player Modules"]
  node_world_tools["World Modules"]
  node_exploit["Exploit Modules"]
  node_misc_fun["Misc and Fun"]
  node_render_modules["Render Modules"]
end

subgraph group_ui["Controls and Settings"]
  node_options["Options Screen<br/>[ToolkitScreen.java]"]
  node_module_screen["Module Screen<br/>[ModuleScreen.java]"]
end

subgraph group_visual["Visual and World Tools"]
  node_camera["Camera Controllers"]
  node_hud["HUD and Team Glow<br/>[ToolkitHud.java]"]
  node_map["Minimap<br/>[ToolkitMap.java]"]
  node_storage_render["Storage Visuals"]
  node_capture["World Capture<br/>[WorldCapture.java]"]
  node_chest_candidates["Chest Candidates"]
end

subgraph group_state["Local State"]
  node_config[("Toolkit Settings<br/>[ToolkitConfig.java]")]
  node_module_settings["Module Settings<br/>[Setting.java]"]
  node_team_names["Team Names<br/>[TeamNames.java]"]
end

node_player(("Player"))

node_player -->|"starts mod"| node_client
node_player -->|"opens controls"| node_options
node_player -->|"opens panel"| node_module_screen
node_client -->|"opens screen"| node_options
node_client -->|"registers and ticks"| node_module_registry
node_client -->|"ticks modules"| node_module_manager
node_client -->|"ticks camera"| node_camera
node_client -->|"ticks HUD"| node_hud
node_client -->|"ticks map"| node_map
node_client -->|"ticks scan"| node_chest_candidates
node_client -->|"ticks capture"| node_capture
node_client -->|"uses settings"| node_config
node_client -->|"registers visuals"| node_storage_render
node_options -->|"edits settings"| node_config
node_options -->|"starts capture"| node_capture
node_options -->|"renders preview"| node_map
node_module_screen -->|"lists and toggles"| node_module_manager
node_module_screen -->|"edits options"| node_module_settings
node_module_screen -->|"manages teammates"| node_team_names
node_module_registry -.->|"provides modules"| node_combat
node_module_registry -.->|"provides modules"| node_movement
node_module_registry -.->|"provides modules"| node_player_tools
node_module_registry -.->|"provides modules"| node_world_tools
node_module_registry -.->|"provides modules"| node_exploit
node_module_registry -.->|"provides modules"| node_misc_fun
node_module_registry -.->|"provides modules"| node_render_modules
node_hud -->|"reads names"| node_team_names
node_map -->|"matches players"| node_team_names
node_storage_render -->|"reads candidates"| node_chest_candidates
node_storage_render -->|"reads options"| node_config
node_camera -->|"moves viewer only"| node_player

click node_client "https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/YukkitToolkitClient.java"
click node_module_registry "https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/modules/framework/ModuleRegistry.java"
click node_module_manager "https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/core/ModuleManager.java"
click node_options "https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/screen/ToolkitScreen.java"
click node_module_screen "https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/screen/ModuleScreen.java"
click node_combat "https://github.com/yukkitmc/yukkit-toolkit/tree/main/src/main/java/dev/yukkit/toolkit/modules/combat"
click node_movement "https://github.com/yukkitmc/yukkit-toolkit/tree/main/src/main/java/dev/yukkit/toolkit/modules/movement"
click node_player_tools "https://github.com/yukkitmc/yukkit-toolkit/tree/main/src/main/java/dev/yukkit/toolkit/modules/player"
click node_world_tools "https://github.com/yukkitmc/yukkit-toolkit/tree/main/src/main/java/dev/yukkit/toolkit/modules/world"
click node_exploit "https://github.com/yukkitmc/yukkit-toolkit/tree/main/src/main/java/dev/yukkit/toolkit/modules/exploit"
click node_misc_fun "https://github.com/yukkitmc/yukkit-toolkit/tree/main/src/main/java/dev/yukkit/toolkit/modules/misc"
click node_render_modules "https://github.com/yukkitmc/yukkit-toolkit/tree/main/src/main/java/dev/yukkit/toolkit/modules/render"
click node_camera "https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/camera/FreecamController.java"
click node_hud "https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/hud/ToolkitHud.java"
click node_map "https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/map/ToolkitMap.java"
click node_storage_render "https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/render/StorageVisualExtras.java"
click node_capture "https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/world/WorldCapture.java"
click node_config "https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/ToolkitConfig.java"
click node_module_settings "https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/core/Setting.java"
click node_chest_candidates "https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/render/ChestCandidates.java"
click node_team_names "https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/team/TeamNames.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_client,node_module_registry,node_module_manager toneBlue
class node_combat,node_movement,node_player_tools,node_world_tools,node_exploit,node_misc_fun,node_render_modules toneAmber
class node_options,node_module_screen toneMint
class node_camera,node_hud,node_map,node_storage_render,node_capture,node_chest_candidates toneRose
class node_config,node_module_settings,node_team_names,node_player toneIndigo
```

## Components

### Client App

- [Client Initializer](https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/YukkitToolkitClient.java): `src/main/java/dev/yukkit/toolkit/YukkitToolkitClient.java`
- [Module Registry](https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/modules/framework/ModuleRegistry.java): `src/main/java/dev/yukkit/toolkit/modules/framework/ModuleRegistry.java`
- [Legacy Module Manager](https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/core/ModuleManager.java): `src/main/java/dev/yukkit/toolkit/core/ModuleManager.java`

### Gameplay Modules

- [Combat Modules](https://github.com/yukkitmc/yukkit-toolkit/tree/main/src/main/java/dev/yukkit/toolkit/modules/combat): `src/main/java/dev/yukkit/toolkit/modules/combat`
- [Movement Modules](https://github.com/yukkitmc/yukkit-toolkit/tree/main/src/main/java/dev/yukkit/toolkit/modules/movement): `src/main/java/dev/yukkit/toolkit/modules/movement`
- [Player Modules](https://github.com/yukkitmc/yukkit-toolkit/tree/main/src/main/java/dev/yukkit/toolkit/modules/player): `src/main/java/dev/yukkit/toolkit/modules/player`
- [World Modules](https://github.com/yukkitmc/yukkit-toolkit/tree/main/src/main/java/dev/yukkit/toolkit/modules/world): `src/main/java/dev/yukkit/toolkit/modules/world`
- [Exploit Modules](https://github.com/yukkitmc/yukkit-toolkit/tree/main/src/main/java/dev/yukkit/toolkit/modules/exploit): `src/main/java/dev/yukkit/toolkit/modules/exploit`
- [Misc and Fun](https://github.com/yukkitmc/yukkit-toolkit/tree/main/src/main/java/dev/yukkit/toolkit/modules/misc): `src/main/java/dev/yukkit/toolkit/modules/misc`
- [Render Modules](https://github.com/yukkitmc/yukkit-toolkit/tree/main/src/main/java/dev/yukkit/toolkit/modules/render): `src/main/java/dev/yukkit/toolkit/modules/render`

### Controls and Settings

- [Options Screen](https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/screen/ToolkitScreen.java): `src/main/java/dev/yukkit/toolkit/screen/ToolkitScreen.java`
- [Module Screen](https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/screen/ModuleScreen.java): `src/main/java/dev/yukkit/toolkit/screen/ModuleScreen.java`

### Visual and World Tools

- [Camera Controllers](https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/camera/FreecamController.java): `src/main/java/dev/yukkit/toolkit/camera/FreecamController.java`
- [HUD and Team Glow](https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/hud/ToolkitHud.java): `src/main/java/dev/yukkit/toolkit/hud/ToolkitHud.java`
- [Minimap](https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/map/ToolkitMap.java): `src/main/java/dev/yukkit/toolkit/map/ToolkitMap.java`
- [Storage Visuals](https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/render/StorageVisualExtras.java): `src/main/java/dev/yukkit/toolkit/render/StorageVisualExtras.java`
- [World Capture](https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/world/WorldCapture.java): `src/main/java/dev/yukkit/toolkit/world/WorldCapture.java`
- [Chest Candidates](https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/render/ChestCandidates.java): `src/main/java/dev/yukkit/toolkit/render/ChestCandidates.java`

### Local State

- [Toolkit Settings](https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/ToolkitConfig.java): `src/main/java/dev/yukkit/toolkit/ToolkitConfig.java`
- [Module Settings](https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/core/Setting.java): `src/main/java/dev/yukkit/toolkit/core/Setting.java`
- [Team Names](https://github.com/yukkitmc/yukkit-toolkit/blob/main/src/main/java/dev/yukkit/toolkit/team/TeamNames.java): `src/main/java/dev/yukkit/toolkit/team/TeamNames.java`

### Other components

- **Player**

## Connections

- Player → Client Initializer: starts mod (evidence: `src/main/java/dev/yukkit/toolkit/YukkitToolkitClient.java`)
- Player → Options Screen: opens controls (evidence: `README.md`)
- Player → Module Screen: opens panel (evidence: `README.md`)
- Client Initializer → Options Screen: opens screen (evidence: `src/main/java/dev/yukkit/toolkit/YukkitToolkitClient.java`)
- Client Initializer → Module Registry: registers and ticks (evidence: `src/main/java/dev/yukkit/toolkit/YukkitToolkitClient.java`)
- Client Initializer → Legacy Module Manager: ticks modules (evidence: `src/main/java/dev/yukkit/toolkit/YukkitToolkitClient.java`)
- Client Initializer → Camera Controllers: ticks camera (evidence: `src/main/java/dev/yukkit/toolkit/YukkitToolkitClient.java`)
- Client Initializer → HUD and Team Glow: ticks HUD (evidence: `src/main/java/dev/yukkit/toolkit/YukkitToolkitClient.java`)
- Client Initializer → Minimap: ticks map (evidence: `src/main/java/dev/yukkit/toolkit/YukkitToolkitClient.java`)
- Client Initializer → Chest Candidates: ticks scan (evidence: `src/main/java/dev/yukkit/toolkit/YukkitToolkitClient.java`)
- Client Initializer → World Capture: ticks capture (evidence: `src/main/java/dev/yukkit/toolkit/YukkitToolkitClient.java`)
- Client Initializer → Toolkit Settings: uses settings (evidence: `src/main/java/dev/yukkit/toolkit/YukkitToolkitClient.java`)
- Client Initializer → Storage Visuals: registers visuals (evidence: `src/main/java/dev/yukkit/toolkit/YukkitToolkitClient.java`)
- Options Screen → Toolkit Settings: edits settings (evidence: `src/main/java/dev/yukkit/toolkit/screen/ToolkitScreen.java`)
- Options Screen → World Capture: starts capture (evidence: `src/main/java/dev/yukkit/toolkit/screen/ToolkitScreen.java`)
- Options Screen → Minimap: renders preview (evidence: `src/main/java/dev/yukkit/toolkit/screen/ToolkitScreen.java`)
- Module Screen → Legacy Module Manager: lists and toggles (evidence: `src/main/java/dev/yukkit/toolkit/screen/ModuleScreen.java`)
- Module Screen → Module Settings: edits options (evidence: `src/main/java/dev/yukkit/toolkit/screen/ModuleScreen.java`)
- Module Screen → Team Names: manages teammates (evidence: `src/main/java/dev/yukkit/toolkit/screen/ModuleScreen.java`)
- Module Registry → Combat Modules: provides modules
- Module Registry → Movement Modules: provides modules
- Module Registry → Player Modules: provides modules
- Module Registry → World Modules: provides modules
- Module Registry → Exploit Modules: provides modules
- Module Registry → Misc and Fun: provides modules
- Module Registry → Render Modules: provides modules
- HUD and Team Glow → Team Names: reads names (evidence: `src/main/java/dev/yukkit/toolkit/hud/ToolkitHud.java`)
- Minimap → Team Names: matches players (evidence: `src/main/java/dev/yukkit/toolkit/map/ToolkitMap.java`)
- Storage Visuals → Chest Candidates: reads candidates (evidence: `src/main/java/dev/yukkit/toolkit/render/StorageVisualExtras.java`)
- Storage Visuals → Toolkit Settings: reads options (evidence: `src/main/java/dev/yukkit/toolkit/render/StorageVisualExtras.java`)
- Camera Controllers → Player: moves viewer only (evidence: `README.md`)
