# nazarazhar/legacy-bugs architecture

> Architecture diagram of the GitHub repository nazarazhar/legacy-bugs, 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/nazarazhar/legacy-bugs
- Repository: https://github.com/nazarazhar/legacy-bugs

## Overview

Legacy Bugs is a Fabric mod that recreates selected historical Minecraft bugs, with server-authoritative toggles exposed through commands and a client configuration screen. The principal workflow is player interaction with a bug-relevant Minecraft screen or crafting grid, followed by mixin-driven behavior gated by configuration; operators can change settings through commands or the UI, with network updates validated and persisted by the server. The graph includes documented bug stages, but some mixin-to-logic wiring is not visible in the excerpts and is left unasserted.

Main entry points: [`src/client/java/com/nazarazhar/legacybugs/client/network/LegacyBugsClientNetworking.java`](https://github.com/nazarazhar/legacy-bugs/blob/main/src/client/java/com/nazarazhar/legacybugs/client/network/LegacyBugsClientNetworking.java) (Client Networking), [`src/main/java/com/nazarazhar/legacybugs/network/LegacyBugsNetworking.java`](https://github.com/nazarazhar/legacy-bugs/blob/main/src/main/java/com/nazarazhar/legacybugs/network/LegacyBugsNetworking.java) (Server Networking), [`src/client/java/com/nazarazhar/legacybugs/client/gui/LegacyBugsConfigScreen.java`](https://github.com/nazarazhar/legacy-bugs/blob/main/src/client/java/com/nazarazhar/legacybugs/client/gui/LegacyBugsConfigScreen.java) (Config Screen), [`src/main/java/com/nazarazhar/legacybugs/config/LegacyBugsConfig.java`](https://github.com/nazarazhar/legacy-bugs/blob/main/src/main/java/com/nazarazhar/legacybugs/config/LegacyBugsConfig.java) (Config File)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Mod Runtime"]
  node_entry["Mod Initialization<br/>[LegacyBugs.java]"]
end

subgraph group_bugs["Bug Restorations"]
  node_grindstone_mixin["Grindstone Hook"]
  node_grindstone_logic["Grindstone Merge"]
  node_grindstone_enchantments["Enchantment Handling"]
  node_grindstone_durability["Durability Handling"]
  node_grindstone_components["Component Handling"]
  node_grindstone_util["Grindstone Utilities"]
  node_crafting_hook["Crafting Remainder Hook"]
end

subgraph group_settings["Configuration"]
  node_config_store[("Config File")]
  node_commands["Bug Commands"]
  node_server_network["Server Networking"]
  node_request_payload["Config Request"]
  node_state_payload["Config State"]
  node_update_payload["Config Update"]
end

subgraph group_client["Client Controls"]
  node_client_entry["Client Initialization"]
  node_config_screen["Config Screen"]
  node_client_network["Client Networking"]
  node_client_state["Client State"]
  node_modmenu["Mod Menu Integration"]
end

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

node_minecraft -->|"initializes"| node_entry
node_entry -->|"loads"| node_config_store
node_entry -->|"registers"| node_server_network
node_entry -->|"registers"| node_commands
node_grindstone_mixin -->|"checks toggles"| node_config_store
node_crafting_hook -->|"checks toggles"| node_config_store
node_grindstone_logic -->|"uses"| node_grindstone_enchantments
node_grindstone_logic -->|"uses"| node_grindstone_durability
node_grindstone_logic -->|"uses"| node_grindstone_components
node_grindstone_logic -.->|"uses"| node_grindstone_util
node_player -.->|"uses grindstone"| node_grindstone_mixin
node_player -.->|"crafts items"| node_crafting_hook
node_commands -->|"reads and updates"| node_config_store
node_server_network -->|"validates and saves"| node_config_store
node_server_network -->|"handles request"| node_request_payload
node_server_network -->|"handles update"| node_update_payload
node_server_network -->|"sends state"| node_state_payload
node_client_entry -->|"registers"| node_client_network
node_client_entry -->|"opens"| node_config_screen
node_client_entry -->|"clears on disconnect"| node_client_state
node_config_screen -->|"requests and updates"| node_client_network
node_config_screen -->|"reads state"| node_client_state
node_client_network -->|"updates state"| node_client_state
node_client_network -->|"sends request"| node_request_payload
node_client_network -->|"sends update"| node_update_payload
node_client_network -->|"receives state"| node_state_payload
node_modmenu -->|"opens"| node_config_screen
node_player -.->|"opens settings"| node_config_screen

click node_entry "https://github.com/nazarazhar/legacy-bugs/blob/main/src/main/java/com/nazarazhar/legacybugs/LegacyBugs.java"
click node_grindstone_mixin "https://github.com/nazarazhar/legacy-bugs/blob/main/src/main/java/com/nazarazhar/legacybugs/mixin/grindstone/GrindstoneMergeMixin.java"
click node_grindstone_logic "https://github.com/nazarazhar/legacy-bugs/blob/main/src/main/java/com/nazarazhar/legacybugs/bug/grindstone/LegacyGrindstoneLogic.java"
click node_grindstone_enchantments "https://github.com/nazarazhar/legacy-bugs/blob/main/src/main/java/com/nazarazhar/legacybugs/bug/grindstone/GrindstoneEnchantments.java"
click node_grindstone_durability "https://github.com/nazarazhar/legacy-bugs/blob/main/src/main/java/com/nazarazhar/legacybugs/bug/grindstone/GrindstoneDurability.java"
click node_grindstone_components "https://github.com/nazarazhar/legacy-bugs/blob/main/src/main/java/com/nazarazhar/legacybugs/bug/grindstone/GrindstoneComponents.java"
click node_grindstone_util "https://github.com/nazarazhar/legacy-bugs/blob/main/src/main/java/com/nazarazhar/legacybugs/bug/grindstone/GrindstoneUtil.java"
click node_crafting_hook "https://github.com/nazarazhar/legacy-bugs/blob/main/src/main/java/com/nazarazhar/legacybugs/mixin/crafting/CraftingResultBugMixin.java"
click node_config_store "https://github.com/nazarazhar/legacy-bugs/blob/main/src/main/java/com/nazarazhar/legacybugs/config/LegacyBugsConfig.java"
click node_commands "https://github.com/nazarazhar/legacy-bugs/blob/main/src/main/java/com/nazarazhar/legacybugs/command/LegacyBugsCommand.java"
click node_server_network "https://github.com/nazarazhar/legacy-bugs/blob/main/src/main/java/com/nazarazhar/legacybugs/network/LegacyBugsNetworking.java"
click node_request_payload "https://github.com/nazarazhar/legacy-bugs/blob/main/src/main/java/com/nazarazhar/legacybugs/network/payload/LegacyBugsConfigRequestPayload.java"
click node_state_payload "https://github.com/nazarazhar/legacy-bugs/blob/main/src/main/java/com/nazarazhar/legacybugs/network/payload/LegacyBugsConfigStatePayload.java"
click node_update_payload "https://github.com/nazarazhar/legacy-bugs/blob/main/src/main/java/com/nazarazhar/legacybugs/network/payload/LegacyBugsConfigUpdatePayload.java"
click node_client_entry "https://github.com/nazarazhar/legacy-bugs/blob/main/src/client/java/com/nazarazhar/legacybugs/client/LegacyBugsClient.java"
click node_config_screen "https://github.com/nazarazhar/legacy-bugs/blob/main/src/client/java/com/nazarazhar/legacybugs/client/gui/LegacyBugsConfigScreen.java"
click node_client_network "https://github.com/nazarazhar/legacy-bugs/blob/main/src/client/java/com/nazarazhar/legacybugs/client/network/LegacyBugsClientNetworking.java"
click node_client_state "https://github.com/nazarazhar/legacy-bugs/blob/main/src/client/java/com/nazarazhar/legacybugs/client/network/LegacyBugsClientState.java"
click node_modmenu "https://github.com/nazarazhar/legacy-bugs/blob/main/src/client/java/com/nazarazhar/legacybugs/client/integration/LegacyBugsModMenu.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_entry toneBlue
class node_grindstone_mixin,node_grindstone_logic,node_grindstone_enchantments,node_grindstone_durability,node_grindstone_components,node_grindstone_util,node_crafting_hook toneAmber
class node_config_store,node_commands,node_server_network,node_request_payload,node_state_payload,node_update_payload toneMint
class node_client_entry,node_config_screen,node_client_network,node_client_state,node_modmenu toneRose
class node_player,node_minecraft toneIndigo
```

## Components

### Mod Runtime

- [Mod Initialization](https://github.com/nazarazhar/legacy-bugs/blob/main/src/main/java/com/nazarazhar/legacybugs/LegacyBugs.java): `src/main/java/com/nazarazhar/legacybugs/LegacyBugs.java`

### Bug Restorations

- [Grindstone Hook](https://github.com/nazarazhar/legacy-bugs/blob/main/src/main/java/com/nazarazhar/legacybugs/mixin/grindstone/GrindstoneMergeMixin.java): `src/main/java/com/nazarazhar/legacybugs/mixin/grindstone/GrindstoneMergeMixin.java`
- [Grindstone Merge](https://github.com/nazarazhar/legacy-bugs/blob/main/src/main/java/com/nazarazhar/legacybugs/bug/grindstone/LegacyGrindstoneLogic.java): `src/main/java/com/nazarazhar/legacybugs/bug/grindstone/LegacyGrindstoneLogic.java`
- [Enchantment Handling](https://github.com/nazarazhar/legacy-bugs/blob/main/src/main/java/com/nazarazhar/legacybugs/bug/grindstone/GrindstoneEnchantments.java): `src/main/java/com/nazarazhar/legacybugs/bug/grindstone/GrindstoneEnchantments.java`
- [Durability Handling](https://github.com/nazarazhar/legacy-bugs/blob/main/src/main/java/com/nazarazhar/legacybugs/bug/grindstone/GrindstoneDurability.java): `src/main/java/com/nazarazhar/legacybugs/bug/grindstone/GrindstoneDurability.java`
- [Component Handling](https://github.com/nazarazhar/legacy-bugs/blob/main/src/main/java/com/nazarazhar/legacybugs/bug/grindstone/GrindstoneComponents.java): `src/main/java/com/nazarazhar/legacybugs/bug/grindstone/GrindstoneComponents.java`
- [Grindstone Utilities](https://github.com/nazarazhar/legacy-bugs/blob/main/src/main/java/com/nazarazhar/legacybugs/bug/grindstone/GrindstoneUtil.java): `src/main/java/com/nazarazhar/legacybugs/bug/grindstone/GrindstoneUtil.java`
- [Crafting Remainder Hook](https://github.com/nazarazhar/legacy-bugs/blob/main/src/main/java/com/nazarazhar/legacybugs/mixin/crafting/CraftingResultBugMixin.java): `src/main/java/com/nazarazhar/legacybugs/mixin/crafting/CraftingResultBugMixin.java`

### Configuration

- [Config File](https://github.com/nazarazhar/legacy-bugs/blob/main/src/main/java/com/nazarazhar/legacybugs/config/LegacyBugsConfig.java): `src/main/java/com/nazarazhar/legacybugs/config/LegacyBugsConfig.java`
- [Bug Commands](https://github.com/nazarazhar/legacy-bugs/blob/main/src/main/java/com/nazarazhar/legacybugs/command/LegacyBugsCommand.java): `src/main/java/com/nazarazhar/legacybugs/command/LegacyBugsCommand.java`
- [Server Networking](https://github.com/nazarazhar/legacy-bugs/blob/main/src/main/java/com/nazarazhar/legacybugs/network/LegacyBugsNetworking.java): `src/main/java/com/nazarazhar/legacybugs/network/LegacyBugsNetworking.java`
- [Config Request](https://github.com/nazarazhar/legacy-bugs/blob/main/src/main/java/com/nazarazhar/legacybugs/network/payload/LegacyBugsConfigRequestPayload.java): `src/main/java/com/nazarazhar/legacybugs/network/payload/LegacyBugsConfigRequestPayload.java`
- [Config State](https://github.com/nazarazhar/legacy-bugs/blob/main/src/main/java/com/nazarazhar/legacybugs/network/payload/LegacyBugsConfigStatePayload.java): `src/main/java/com/nazarazhar/legacybugs/network/payload/LegacyBugsConfigStatePayload.java`
- [Config Update](https://github.com/nazarazhar/legacy-bugs/blob/main/src/main/java/com/nazarazhar/legacybugs/network/payload/LegacyBugsConfigUpdatePayload.java): `src/main/java/com/nazarazhar/legacybugs/network/payload/LegacyBugsConfigUpdatePayload.java`

### Client Controls

- [Client Initialization](https://github.com/nazarazhar/legacy-bugs/blob/main/src/client/java/com/nazarazhar/legacybugs/client/LegacyBugsClient.java): `src/client/java/com/nazarazhar/legacybugs/client/LegacyBugsClient.java`
- [Config Screen](https://github.com/nazarazhar/legacy-bugs/blob/main/src/client/java/com/nazarazhar/legacybugs/client/gui/LegacyBugsConfigScreen.java): `src/client/java/com/nazarazhar/legacybugs/client/gui/LegacyBugsConfigScreen.java`
- [Client Networking](https://github.com/nazarazhar/legacy-bugs/blob/main/src/client/java/com/nazarazhar/legacybugs/client/network/LegacyBugsClientNetworking.java): `src/client/java/com/nazarazhar/legacybugs/client/network/LegacyBugsClientNetworking.java`
- [Client State](https://github.com/nazarazhar/legacy-bugs/blob/main/src/client/java/com/nazarazhar/legacybugs/client/network/LegacyBugsClientState.java): `src/client/java/com/nazarazhar/legacybugs/client/network/LegacyBugsClientState.java`
- [Mod Menu Integration](https://github.com/nazarazhar/legacy-bugs/blob/main/src/client/java/com/nazarazhar/legacybugs/client/integration/LegacyBugsModMenu.java): `src/client/java/com/nazarazhar/legacybugs/client/integration/LegacyBugsModMenu.java`

### Other components

- **Player**
- **Minecraft Runtime**

## Connections

- Minecraft Runtime → Mod Initialization: initializes (evidence: `src/main/java/com/nazarazhar/legacybugs/LegacyBugs.java`)
- Mod Initialization → Config File: loads (evidence: `src/main/java/com/nazarazhar/legacybugs/LegacyBugs.java`)
- Mod Initialization → Server Networking: registers (evidence: `src/main/java/com/nazarazhar/legacybugs/LegacyBugs.java`)
- Mod Initialization → Bug Commands: registers (evidence: `src/main/java/com/nazarazhar/legacybugs/LegacyBugs.java`)
- Grindstone Hook → Config File: checks toggles (evidence: `src/main/java/com/nazarazhar/legacybugs/mixin/grindstone/GrindstoneMergeMixin.java`)
- Crafting Remainder Hook → Config File: checks toggles (evidence: `src/main/java/com/nazarazhar/legacybugs/mixin/crafting/CraftingResultBugMixin.java`)
- Grindstone Merge → Enchantment Handling: uses (evidence: `src/main/java/com/nazarazhar/legacybugs/bug/grindstone/LegacyGrindstoneLogic.java`)
- Grindstone Merge → Durability Handling: uses (evidence: `src/main/java/com/nazarazhar/legacybugs/bug/grindstone/LegacyGrindstoneLogic.java`)
- Grindstone Merge → Component Handling: uses (evidence: `src/main/java/com/nazarazhar/legacybugs/bug/grindstone/LegacyGrindstoneLogic.java`)
- Grindstone Merge → Grindstone Utilities: uses
- Player → Grindstone Hook: uses grindstone
- Player → Crafting Remainder Hook: crafts items
- Bug Commands → Config File: reads and updates (evidence: `src/main/java/com/nazarazhar/legacybugs/command/LegacyBugsCommand.java`)
- Server Networking → Config File: validates and saves (evidence: `src/main/java/com/nazarazhar/legacybugs/network/LegacyBugsNetworking.java`)
- Server Networking → Config Request: handles request (evidence: `src/main/java/com/nazarazhar/legacybugs/network/LegacyBugsNetworking.java`)
- Server Networking → Config Update: handles update (evidence: `src/main/java/com/nazarazhar/legacybugs/network/LegacyBugsNetworking.java`)
- Server Networking → Config State: sends state (evidence: `src/main/java/com/nazarazhar/legacybugs/network/LegacyBugsNetworking.java`)
- Client Initialization → Client Networking: registers (evidence: `src/client/java/com/nazarazhar/legacybugs/client/LegacyBugsClient.java`)
- Client Initialization → Config Screen: opens (evidence: `src/client/java/com/nazarazhar/legacybugs/client/LegacyBugsClient.java`)
- Client Initialization → Client State: clears on disconnect (evidence: `src/client/java/com/nazarazhar/legacybugs/client/LegacyBugsClient.java`)
- Config Screen → Client Networking: requests and updates (evidence: `src/client/java/com/nazarazhar/legacybugs/client/gui/LegacyBugsConfigScreen.java`)
- Config Screen → Client State: reads state (evidence: `src/client/java/com/nazarazhar/legacybugs/client/gui/LegacyBugsConfigScreen.java`)
- Client Networking → Client State: updates state (evidence: `src/client/java/com/nazarazhar/legacybugs/client/network/LegacyBugsClientNetworking.java`)
- Client Networking → Config Request: sends request (evidence: `src/client/java/com/nazarazhar/legacybugs/client/network/LegacyBugsClientNetworking.java`)
- Client Networking → Config Update: sends update (evidence: `src/client/java/com/nazarazhar/legacybugs/client/network/LegacyBugsClientNetworking.java`)
- Client Networking → Config State: receives state (evidence: `src/client/java/com/nazarazhar/legacybugs/client/network/LegacyBugsClientNetworking.java`)
- Mod Menu Integration → Config Screen: opens (evidence: `src/client/java/com/nazarazhar/legacybugs/client/integration/LegacyBugsModMenu.java`)
- Player → Config Screen: opens settings
