# rico-knots/infernum architecture

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

- Interactive diagram: https://gitdiagram.com/rico-knots/infernum
- Repository: https://github.com/rico-knots/infernum

## Overview

Infernum is a Fabric client mod for Minecraft, adding gameplay modules, Kuudra/Skyblock assistance, configurable HUD overlays, and custom configuration screens. Its principal workflow starts at client initialization: the mod loads configuration, registers event handling and modules, and exposes commands and UI; enabled modules then respond to game events and render or otherwise affect play. The source index supports several startup and module-registration links, but does not show all mixin-to-event wiring or feature internals, so those relationships are omitted rather than inferred.

Main entry points: [`src/main/kotlin/dev/frozencloud/infernum/Infernum.kt`](https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/Infernum.kt) (Client initializer), [`src/main/kotlin/dev/frozencloud/infernum/features/ModuleManager.kt`](https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/features/ModuleManager.kt) (Module manager), [`src/main/kotlin/dev/frozencloud/infernum/ui/settings/impl`](https://github.com/rico-knots/infernum/tree/main/src/main/kotlin/dev/frozencloud/infernum/ui/settings/impl) (Setting controls), [`src/main/kotlin/dev/frozencloud/infernum/util/skyblock/kuudra/KuudraUtil.kt`](https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/util/skyblock/kuudra/KuudraUtil.kt) (Kuudra utilities)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Client runtime"]
  node_mod["Client initializer<br/>[Infernum.kt]"]
  node_events["Event dispatcher<br/>[EventDispatcher.kt]"]
  node_ticks["Tick events<br/>[TickEvent.kt]"]
  node_packets["Packet events<br/>[PacketEvent.kt]"]
  node_mixins["Game hooks"]
  node_scheduler["Task scheduler<br/>[Scheduler.kt]"]
  node_commands["Client commands<br/>[MainCommand.kt]"]
end

subgraph group_features["Gameplay features"]
  node_manager["Module manager<br/>[ModuleManager.kt]"]
  node_module["Module lifecycle<br/>[Module.kt]"]
  node_gameplay["Gameplay modules"]
  node_configs["Feature configs"]
end

subgraph group_presentation["UI and overlays"]
  node_configui["Configuration screen<br/>[ConfigScreen.kt]"]
  node_settings["Setting controls"]
  node_textinput["Text input"]
  node_overlayeditor["Overlay editor<br/>[OverlayEditor.kt]"]
  node_overlays["Overlay manager<br/>[OverlayManager.kt]"]
  node_overlayconfig["Overlay settings<br/>[WaypointConfig.kt]"]
  node_nanovg["NanoVG rendering<br/>[NanoVGHelper.kt]"]
  node_color["Color utilities<br/>[Color.kt]"]
end

subgraph group_domain["Skyblock domain"]
  node_kuudra["Kuudra utilities<br/>[KuudraUtil.kt]"]
  node_skyblock["Skyblock context"]
  node_chat["Chat utilities<br/>[ChatUtil.kt]"]
end

node_player(("Minecraft player"))

node_player -.->|"starts client"| node_mod
node_mod -->|"registers handlers"| node_events
node_mod -->|"registers modules"| node_manager
node_mod -->|"registers command"| node_commands
node_mod -->|"loads settings"| node_overlays
node_events -->|"dispatches"| node_ticks
node_events -->|"dispatches"| node_packets
node_mixins -.->|"emits game events"| node_events
node_manager -->|"registers modules"| node_gameplay
node_manager -->|"loads configuration"| node_configs
node_manager -->|"manages lifecycle"| node_module
node_gameplay -.->|"uses domain state"| node_kuudra
node_kuudra -->|"checks location"| node_skyblock
node_kuudra -->|"schedules scans"| node_scheduler
node_kuudra -->|"reports status"| node_chat
node_configui -->|"renders settings"| node_settings
node_settings -->|"handles text"| node_textinput
node_settings -->|"draws controls"| node_nanovg
node_overlayeditor -->|"edits overlays"| node_overlays
node_overlays -.->|"persists settings"| node_overlayconfig
node_overlays -.->|"renders HUD"| node_nanovg
node_settings -->|"uses colors"| node_color

click node_mod "https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/Infernum.kt"
click node_events "https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/events/EventDispatcher.kt"
click node_ticks "https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/events/impl/TickEvent.kt"
click node_packets "https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/events/impl/PacketEvent.kt"
click node_mixins "https://github.com/rico-knots/infernum/tree/main/src/main/java/dev/frozencloud/infernum/mixin"
click node_scheduler "https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/util/Scheduler.kt"
click node_commands "https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/commands/impl/MainCommand.kt"
click node_manager "https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/features/ModuleManager.kt"
click node_module "https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/features/Module.kt"
click node_gameplay "https://github.com/rico-knots/infernum/tree/main/src/main/kotlin/dev/frozencloud/infernum/features/impl"
click node_configs "https://github.com/rico-knots/infernum/tree/main/src/main/kotlin/dev/frozencloud/infernum/config"
click node_kuudra "https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/util/skyblock/kuudra/KuudraUtil.kt"
click node_skyblock "https://github.com/rico-knots/infernum/tree/main/src/main/kotlin/dev/frozencloud/infernum/util/skyblock"
click node_chat "https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/util/ChatUtil.kt"
click node_configui "https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/ui/ConfigScreen.kt"
click node_settings "https://github.com/rico-knots/infernum/tree/main/src/main/kotlin/dev/frozencloud/infernum/ui/settings/impl"
click node_textinput "https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/util/ui/TextInputHandler.kt"
click node_overlayeditor "https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/ui/OverlayEditor.kt"
click node_overlays "https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/util/overlay/OverlayManager.kt"
click node_overlayconfig "https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/config/WaypointConfig.kt"
click node_nanovg "https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/util/ui/rendering/NanoVGHelper.kt"
click node_color "https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/util/render/Color.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_mod,node_events,node_ticks,node_packets,node_mixins,node_scheduler,node_commands toneBlue
class node_manager,node_module,node_gameplay,node_configs toneAmber
class node_configui,node_settings,node_textinput,node_overlayeditor,node_overlays,node_overlayconfig,node_nanovg,node_color toneMint
class node_kuudra,node_skyblock,node_chat toneRose
class node_player toneIndigo
```

## Components

### Client runtime

- [Client initializer](https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/Infernum.kt): `src/main/kotlin/dev/frozencloud/infernum/Infernum.kt`
- [Event dispatcher](https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/events/EventDispatcher.kt): `src/main/kotlin/dev/frozencloud/infernum/events/EventDispatcher.kt`
- [Tick events](https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/events/impl/TickEvent.kt): `src/main/kotlin/dev/frozencloud/infernum/events/impl/TickEvent.kt`
- [Packet events](https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/events/impl/PacketEvent.kt): `src/main/kotlin/dev/frozencloud/infernum/events/impl/PacketEvent.kt`
- [Game hooks](https://github.com/rico-knots/infernum/tree/main/src/main/java/dev/frozencloud/infernum/mixin): `src/main/java/dev/frozencloud/infernum/mixin`
- [Task scheduler](https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/util/Scheduler.kt): `src/main/kotlin/dev/frozencloud/infernum/util/Scheduler.kt`
- [Client commands](https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/commands/impl/MainCommand.kt): `src/main/kotlin/dev/frozencloud/infernum/commands/impl/MainCommand.kt`

### Gameplay features

- [Module manager](https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/features/ModuleManager.kt): `src/main/kotlin/dev/frozencloud/infernum/features/ModuleManager.kt`
- [Module lifecycle](https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/features/Module.kt): `src/main/kotlin/dev/frozencloud/infernum/features/Module.kt`
- [Gameplay modules](https://github.com/rico-knots/infernum/tree/main/src/main/kotlin/dev/frozencloud/infernum/features/impl): `src/main/kotlin/dev/frozencloud/infernum/features/impl`
- [Feature configs](https://github.com/rico-knots/infernum/tree/main/src/main/kotlin/dev/frozencloud/infernum/config): `src/main/kotlin/dev/frozencloud/infernum/config`

### UI and overlays

- [Configuration screen](https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/ui/ConfigScreen.kt): `src/main/kotlin/dev/frozencloud/infernum/ui/ConfigScreen.kt`
- [Setting controls](https://github.com/rico-knots/infernum/tree/main/src/main/kotlin/dev/frozencloud/infernum/ui/settings/impl): `src/main/kotlin/dev/frozencloud/infernum/ui/settings/impl`
- [Text input](https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/util/ui/TextInputHandler.kt): `src/main/kotlin/dev/frozencloud/infernum/util/ui/TextInputHandler.kt`
- [Overlay editor](https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/ui/OverlayEditor.kt): `src/main/kotlin/dev/frozencloud/infernum/ui/OverlayEditor.kt`
- [Overlay manager](https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/util/overlay/OverlayManager.kt): `src/main/kotlin/dev/frozencloud/infernum/util/overlay/OverlayManager.kt`
- [Overlay settings](https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/config/WaypointConfig.kt): `src/main/kotlin/dev/frozencloud/infernum/config/WaypointConfig.kt`
- [NanoVG rendering](https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/util/ui/rendering/NanoVGHelper.kt): `src/main/kotlin/dev/frozencloud/infernum/util/ui/rendering/NanoVGHelper.kt`
- [Color utilities](https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/util/render/Color.kt): `src/main/kotlin/dev/frozencloud/infernum/util/render/Color.kt`

### Skyblock domain

- [Kuudra utilities](https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/util/skyblock/kuudra/KuudraUtil.kt): `src/main/kotlin/dev/frozencloud/infernum/util/skyblock/kuudra/KuudraUtil.kt`
- [Skyblock context](https://github.com/rico-knots/infernum/tree/main/src/main/kotlin/dev/frozencloud/infernum/util/skyblock): `src/main/kotlin/dev/frozencloud/infernum/util/skyblock`
- [Chat utilities](https://github.com/rico-knots/infernum/blob/main/src/main/kotlin/dev/frozencloud/infernum/util/ChatUtil.kt): `src/main/kotlin/dev/frozencloud/infernum/util/ChatUtil.kt`

### Other components

- **Minecraft player**

## Connections

- Minecraft player → Client initializer: starts client
- Client initializer → Event dispatcher: registers handlers (evidence: `src/main/kotlin/dev/frozencloud/infernum/Infernum.kt`)
- Client initializer → Module manager: registers modules (evidence: `src/main/kotlin/dev/frozencloud/infernum/Infernum.kt`)
- Client initializer → Client commands: registers command (evidence: `src/main/kotlin/dev/frozencloud/infernum/Infernum.kt`)
- Client initializer → Overlay manager: loads settings (evidence: `src/main/kotlin/dev/frozencloud/infernum/Infernum.kt`)
- Event dispatcher → Tick events: dispatches (evidence: `src/main/kotlin/dev/frozencloud/infernum/events/EventDispatcher.kt`)
- Event dispatcher → Packet events: dispatches (evidence: `src/main/kotlin/dev/frozencloud/infernum/events/EventDispatcher.kt`)
- Game hooks → Event dispatcher: emits game events
- Module manager → Gameplay modules: registers modules (evidence: `src/main/kotlin/dev/frozencloud/infernum/features/ModuleManager.kt`)
- Module manager → Feature configs: loads configuration (evidence: `src/main/kotlin/dev/frozencloud/infernum/features/ModuleManager.kt`)
- Module manager → Module lifecycle: manages lifecycle (evidence: `src/main/kotlin/dev/frozencloud/infernum/features/ModuleManager.kt`)
- Gameplay modules → Kuudra utilities: uses domain state (evidence: `src/main/kotlin/dev/frozencloud/infernum/features/impl/kuudra/CrateHitboxes.kt`)
- Kuudra utilities → Skyblock context: checks location (evidence: `src/main/kotlin/dev/frozencloud/infernum/util/skyblock/kuudra/KuudraUtil.kt`)
- Kuudra utilities → Task scheduler: schedules scans (evidence: `src/main/kotlin/dev/frozencloud/infernum/util/skyblock/kuudra/KuudraUtil.kt`)
- Kuudra utilities → Chat utilities: reports status (evidence: `src/main/kotlin/dev/frozencloud/infernum/util/skyblock/kuudra/KuudraUtil.kt`)
- Configuration screen → Setting controls: renders settings (evidence: `src/main/kotlin/dev/frozencloud/infernum/ui/settings/impl/ColorSetting.kt`)
- Setting controls → Text input: handles text (evidence: `src/main/kotlin/dev/frozencloud/infernum/ui/settings/impl/ColorSetting.kt`)
- Setting controls → NanoVG rendering: draws controls (evidence: `src/main/kotlin/dev/frozencloud/infernum/ui/settings/impl/ColorSetting.kt`)
- Overlay editor → Overlay manager: edits overlays (evidence: `src/main/kotlin/dev/frozencloud/infernum/ui/OverlayEditor.kt`)
- Overlay manager → Overlay settings: persists settings
- Overlay manager → NanoVG rendering: renders HUD
- Setting controls → Color utilities: uses colors (evidence: `src/main/kotlin/dev/frozencloud/infernum/ui/settings/impl/ColorSetting.kt`)
