# tharidia-organization/simple-weight architecture

> Architecture diagram of the GitHub repository tharidia-organization/simple-weight, 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/tharidia-organization/simple-weight
- Repository: https://github.com/tharidia-organization/simple-weight

## Overview

Tharidia: Simple Weight is a NeoForge Minecraft mod that calculates inventory load and applies movement restrictions, with datapack-defined rules and client feedback. The main workflow loads weight configuration, computes player weight, and applies speed, swimming, and optional jump penalties; commands support operator testing. HUD, tooltip, and configuration synchronization provide client-facing capabilities. Edges reflect the README and indexed references in the supplied excerpts; unsampled integrations and event wiring are not inferred.

Main entry points: [`src/main/java/com/THproject/tharidia_simpleweight/weight/WeightManager.java`](https://github.com/tharidia-organization/simple-weight/blob/main/src/main/java/com/THproject/tharidia_simpleweight/weight/WeightManager.java) (Weight calculation), [`src/main/java/com/THproject/tharidia_simpleweight/weight/WeightRegistry.java`](https://github.com/tharidia-organization/simple-weight/blob/main/src/main/java/com/THproject/tharidia_simpleweight/weight/WeightRegistry.java) (Active weight registry), [`src/main/java/com/THproject/tharidia_simpleweight/TharidiaSimpleWeight.java`](https://github.com/tharidia-organization/simple-weight/blob/main/src/main/java/com/THproject/tharidia_simpleweight/TharidiaSimpleWeight.java) (Mod initialization), [`src/main/java/com/THproject/tharidia_simpleweight/event/WeightDebuffHandler.java`](https://github.com/tharidia-organization/simple-weight/blob/main/src/main/java/com/THproject/tharidia_simpleweight/event/WeightDebuffHandler.java) (Movement restrictions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_configuration["Weight configuration"]
  node_loader["Config loader"]
  node_model["Weight configuration model<br/>[WeightData.java]"]
  node_registry["Active weight registry"]
end

subgraph group_runtime["Weight runtime"]
  node_mod["Mod initialization"]
  node_manager["Weight calculation<br/>[WeightManager.java]"]
  node_debuffs["Movement restrictions"]
end

subgraph group_client["Client experience"]
  node_clientinit["Client initialization"]
  node_clientevents["Client events"]
  node_hud["Weight HUD"]
  node_tooltip["Weight tooltips"]
end

subgraph group_admin["Administration and sync"]
  node_command["Weight test command<br/>[WeightCommand.java]"]
  node_configpayload["Config sync payload"]
  node_testpayload["Test mode payload"]
end

node_player(("Player"))
node_datapack["Datapack files"]
node_client(("Minecraft client"))

node_mod -->|"registers reload"| node_loader
node_datapack -->|"provides configuration"| node_loader
node_loader -->|"decodes data"| node_model
node_loader -->|"sets active data"| node_registry
node_registry -->|"stores configuration"| node_model
node_manager -->|"reads item weights"| node_registry
node_manager -->|"uses weight status"| node_model
node_player -->|"supplies inventory"| node_manager
node_debuffs -->|"checks player weight"| node_manager
node_debuffs -->|"reads penalty rules"| node_registry
node_debuffs -->|"applies restrictions"| node_player
node_mod -->|"registers handler"| node_debuffs
node_mod -->|"registers command"| node_command
node_command -->|"toggles test mode"| node_manager
node_command -->|"sends state"| node_testpayload
node_mod -->|"sends config"| node_configpayload
node_mod -->|"registers payload"| node_testpayload
node_clientinit -->|"registers overlay"| node_hud
node_hud -->|"calculates displayed load"| node_manager
node_hud -->|"reads display rules"| node_registry
node_tooltip -->|"reads item weights"| node_registry
node_client -->|"displays status"| node_hud
node_configpayload -->|"syncs configuration"| node_client
node_testpayload -->|"syncs test mode"| node_client

click node_mod "https://github.com/tharidia-organization/simple-weight/blob/main/src/main/java/com/THproject/tharidia_simpleweight/TharidiaSimpleWeight.java"
click node_loader "https://github.com/tharidia-organization/simple-weight/blob/main/src/main/java/com/THproject/tharidia_simpleweight/weight/WeightDataLoader.java"
click node_model "https://github.com/tharidia-organization/simple-weight/blob/main/src/main/java/com/THproject/tharidia_simpleweight/weight/WeightData.java"
click node_registry "https://github.com/tharidia-organization/simple-weight/blob/main/src/main/java/com/THproject/tharidia_simpleweight/weight/WeightRegistry.java"
click node_manager "https://github.com/tharidia-organization/simple-weight/blob/main/src/main/java/com/THproject/tharidia_simpleweight/weight/WeightManager.java"
click node_debuffs "https://github.com/tharidia-organization/simple-weight/blob/main/src/main/java/com/THproject/tharidia_simpleweight/event/WeightDebuffHandler.java"
click node_command "https://github.com/tharidia-organization/simple-weight/blob/main/src/main/java/com/THproject/tharidia_simpleweight/command/WeightCommand.java"
click node_clientinit "https://github.com/tharidia-organization/simple-weight/blob/main/src/main/java/com/THproject/tharidia_simpleweight/TharidiaSimpleWeightClient.java"
click node_clientevents "https://github.com/tharidia-organization/simple-weight/blob/main/src/main/java/com/THproject/tharidia_simpleweight/client/ClientModEvents.java"
click node_hud "https://github.com/tharidia-organization/simple-weight/blob/main/src/main/java/com/THproject/tharidia_simpleweight/client/WeightHudOverlay.java"
click node_tooltip "https://github.com/tharidia-organization/simple-weight/blob/main/src/main/java/com/THproject/tharidia_simpleweight/client/WeightTooltipHandler.java"
click node_configpayload "https://github.com/tharidia-organization/simple-weight/blob/main/src/main/java/com/THproject/tharidia_simpleweight/network/WeightConfigSyncPayload.java"
click node_testpayload "https://github.com/tharidia-organization/simple-weight/blob/main/src/main/java/com/THproject/tharidia_simpleweight/network/TestModeSyncPayload.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_loader,node_model,node_registry,node_client toneBlue
class node_mod,node_manager,node_debuffs toneAmber
class node_clientinit,node_clientevents,node_hud,node_tooltip toneMint
class node_command,node_configpayload,node_testpayload toneRose
class node_player,node_datapack toneIndigo
```

## Components

### Weight configuration

- [Config loader](https://github.com/tharidia-organization/simple-weight/blob/main/src/main/java/com/THproject/tharidia_simpleweight/weight/WeightDataLoader.java): `src/main/java/com/THproject/tharidia_simpleweight/weight/WeightDataLoader.java`
- [Weight configuration model](https://github.com/tharidia-organization/simple-weight/blob/main/src/main/java/com/THproject/tharidia_simpleweight/weight/WeightData.java): `src/main/java/com/THproject/tharidia_simpleweight/weight/WeightData.java`
- [Active weight registry](https://github.com/tharidia-organization/simple-weight/blob/main/src/main/java/com/THproject/tharidia_simpleweight/weight/WeightRegistry.java): `src/main/java/com/THproject/tharidia_simpleweight/weight/WeightRegistry.java`

### Weight runtime

- [Mod initialization](https://github.com/tharidia-organization/simple-weight/blob/main/src/main/java/com/THproject/tharidia_simpleweight/TharidiaSimpleWeight.java): `src/main/java/com/THproject/tharidia_simpleweight/TharidiaSimpleWeight.java`
- [Weight calculation](https://github.com/tharidia-organization/simple-weight/blob/main/src/main/java/com/THproject/tharidia_simpleweight/weight/WeightManager.java): `src/main/java/com/THproject/tharidia_simpleweight/weight/WeightManager.java`
- [Movement restrictions](https://github.com/tharidia-organization/simple-weight/blob/main/src/main/java/com/THproject/tharidia_simpleweight/event/WeightDebuffHandler.java): `src/main/java/com/THproject/tharidia_simpleweight/event/WeightDebuffHandler.java`

### Client experience

- [Client initialization](https://github.com/tharidia-organization/simple-weight/blob/main/src/main/java/com/THproject/tharidia_simpleweight/TharidiaSimpleWeightClient.java): `src/main/java/com/THproject/tharidia_simpleweight/TharidiaSimpleWeightClient.java`
- [Client events](https://github.com/tharidia-organization/simple-weight/blob/main/src/main/java/com/THproject/tharidia_simpleweight/client/ClientModEvents.java): `src/main/java/com/THproject/tharidia_simpleweight/client/ClientModEvents.java`
- [Weight HUD](https://github.com/tharidia-organization/simple-weight/blob/main/src/main/java/com/THproject/tharidia_simpleweight/client/WeightHudOverlay.java): `src/main/java/com/THproject/tharidia_simpleweight/client/WeightHudOverlay.java`
- [Weight tooltips](https://github.com/tharidia-organization/simple-weight/blob/main/src/main/java/com/THproject/tharidia_simpleweight/client/WeightTooltipHandler.java): `src/main/java/com/THproject/tharidia_simpleweight/client/WeightTooltipHandler.java`

### Administration and sync

- [Weight test command](https://github.com/tharidia-organization/simple-weight/blob/main/src/main/java/com/THproject/tharidia_simpleweight/command/WeightCommand.java): `src/main/java/com/THproject/tharidia_simpleweight/command/WeightCommand.java`
- [Config sync payload](https://github.com/tharidia-organization/simple-weight/blob/main/src/main/java/com/THproject/tharidia_simpleweight/network/WeightConfigSyncPayload.java): `src/main/java/com/THproject/tharidia_simpleweight/network/WeightConfigSyncPayload.java`
- [Test mode payload](https://github.com/tharidia-organization/simple-weight/blob/main/src/main/java/com/THproject/tharidia_simpleweight/network/TestModeSyncPayload.java): `src/main/java/com/THproject/tharidia_simpleweight/network/TestModeSyncPayload.java`

### Other components

- **Player**
- **Datapack files**
- **Minecraft client**

## Connections

- Mod initialization → Config loader: registers reload (evidence: `src/main/java/com/THproject/tharidia_simpleweight/TharidiaSimpleWeight.java`)
- Datapack files → Config loader: provides configuration (evidence: `README.md`)
- Config loader → Weight configuration model: decodes data (evidence: `src/main/java/com/THproject/tharidia_simpleweight/weight/WeightDataLoader.java`)
- Config loader → Active weight registry: sets active data (evidence: `src/main/java/com/THproject/tharidia_simpleweight/weight/WeightDataLoader.java`)
- Active weight registry → Weight configuration model: stores configuration (evidence: `src/main/java/com/THproject/tharidia_simpleweight/weight/WeightRegistry.java`)
- Weight calculation → Active weight registry: reads item weights (evidence: `src/main/java/com/THproject/tharidia_simpleweight/weight/WeightManager.java`)
- Weight calculation → Weight configuration model: uses weight status (evidence: `src/main/java/com/THproject/tharidia_simpleweight/weight/WeightManager.java`)
- Player → Weight calculation: supplies inventory (evidence: `README.md`)
- Movement restrictions → Weight calculation: checks player weight (evidence: `src/main/java/com/THproject/tharidia_simpleweight/event/WeightDebuffHandler.java`)
- Movement restrictions → Active weight registry: reads penalty rules (evidence: `src/main/java/com/THproject/tharidia_simpleweight/event/WeightDebuffHandler.java`)
- Movement restrictions → Player: applies restrictions (evidence: `README.md`)
- Mod initialization → Movement restrictions: registers handler (evidence: `src/main/java/com/THproject/tharidia_simpleweight/TharidiaSimpleWeight.java`)
- Mod initialization → Weight test command: registers command (evidence: `src/main/java/com/THproject/tharidia_simpleweight/TharidiaSimpleWeight.java`)
- Weight test command → Weight calculation: toggles test mode (evidence: `src/main/java/com/THproject/tharidia_simpleweight/command/WeightCommand.java`)
- Weight test command → Test mode payload: sends state (evidence: `src/main/java/com/THproject/tharidia_simpleweight/command/WeightCommand.java`)
- Mod initialization → Config sync payload: sends config (evidence: `src/main/java/com/THproject/tharidia_simpleweight/TharidiaSimpleWeight.java`)
- Mod initialization → Test mode payload: registers payload (evidence: `src/main/java/com/THproject/tharidia_simpleweight/TharidiaSimpleWeight.java`)
- Client initialization → Weight HUD: registers overlay (evidence: `src/main/java/com/THproject/tharidia_simpleweight/TharidiaSimpleWeightClient.java`)
- Weight HUD → Weight calculation: calculates displayed load (evidence: `src/main/java/com/THproject/tharidia_simpleweight/client/WeightHudOverlay.java`)
- Weight HUD → Active weight registry: reads display rules (evidence: `src/main/java/com/THproject/tharidia_simpleweight/client/WeightHudOverlay.java`)
- Weight tooltips → Active weight registry: reads item weights (evidence: `src/main/java/com/THproject/tharidia_simpleweight/client/WeightTooltipHandler.java`)
- Minecraft client → Weight HUD: displays status (evidence: `README.md`)
- Config sync payload → Minecraft client: syncs configuration (evidence: `README.md`)
- Test mode payload → Minecraft client: syncs test mode (evidence: `src/main/java/com/THproject/tharidia_simpleweight/network/TestModeSyncPayload.java`)
