# xabyxd/recrafted-alloys-and-amulets architecture

> Architecture diagram of the GitHub repository xabyxd/recrafted-alloys-and-amulets, 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/xabyxd/recrafted-alloys-and-amulets
- Repository: https://github.com/xabyxd/recrafted-alloys-and-amulets

## Overview

Recrafted is a Minecraft 1.7.10 Forge mod adding alloy materials and tools, gem amulets, ore generation, fuel-powered machines, and NEI/Waila integrations. The principal gameplay path is world-generated ores and registered materials feeding recipes; players operate the coke oven through its controller, tile entity, and GUI to produce items. Forge lifecycle setup is shown as the internal registration layer. The map follows sampled source and the source index; unsampled alloy, amulet, and blast-furnace behavior is represented only at its supported directory or class path.

Main entry points: [`src/main/java/net/xabyxd/recrafted/CommonProxy.java`](https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/CommonProxy.java) (Lifecycle Setup), [`src/main/java/net/xabyxd/recrafted/tileentity/TileEntityCokeOven.java`](https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/tileentity/TileEntityCokeOven.java) (Oven Processing), [`src/main/java/net/xabyxd/recrafted/gui/GuiHandler.java`](https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/gui/GuiHandler.java) (GUI Routing), [`src/main/java/net/xabyxd/recrafted/registers/recipes/CokeOvenRecipes.java`](https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/registers/recipes/CokeOvenRecipes.java) (Oven Recipes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Mod Runtime"]
  node_entry["Mod Lifecycle<br/>[Recrafted.java]"]
  node_proxy["Lifecycle Setup<br/>[CommonProxy.java]"]
  node_config["Configuration<br/>[Config.java]"]
end

subgraph group_content["Materials and World"]
  node_items["Items and Tools"]
  node_blocks["Blocks and Ores"]
  node_amulets["Gem Amulets"]
  node_oregen["Ore Generation<br/>[OreGenerator.java]"]
  node_recipes["Recipe Setup"]
end

subgraph group_machines["Processing Machines"]
  node_fuel["Fuel Handler"]
  node_cokecontroller["Coke Oven Block"]
  node_blast["Blast Furnace"]
  node_tile["Oven Processing"]
  node_cokerecipes[("Oven Recipes")]
end

subgraph group_client["Player Interfaces"]
  node_guihandler["GUI Routing<br/>[GuiHandler.java]"]
  node_container["Oven Container"]
  node_ovenui["Oven Screen<br/>[GuiCokeOven.java]"]
  node_keyhandler["Compat Status Key<br/>[KeyHandler.java]"]
  node_pause["Pause Menu Add-on"]
end

subgraph group_integrations["Mod Integrations"]
  node_nei["NEI Recipes<br/>[NEIRecipes.java]"]
  node_neicoke["Oven NEI View"]
  node_waila["Waila Support<br/>[WailaCompat.java]"]
  node_compat["Compat Setup<br/>[Compat.java]"]
end

node_game(("Minecraft / Forge"))

node_game -.->|"loads mod"| node_entry
node_entry -->|"delegates lifecycle"| node_proxy
node_proxy -->|"loads settings"| node_config
node_proxy -->|"initializes"| node_compat
node_proxy -->|"initializes"| node_items
node_proxy -->|"initializes"| node_blocks
node_proxy -->|"registers"| node_recipes
node_proxy -->|"registers"| node_fuel
node_proxy -->|"registers"| node_oregen
node_proxy -->|"initializes"| node_cokerecipes
node_proxy -->|"registers compatibility"| node_waila
node_proxy -->|"registers tile entities"| node_tile
node_proxy -->|"registers GUI"| node_guihandler
node_proxy -->|"initializes magic items"| node_amulets
node_oregen -->|"uses registered ores"| node_blocks
node_cokecontroller -->|"creates tile entity"| node_tile
node_cokecontroller -->|"opens GUI"| node_guihandler
node_tile -->|"queries recipes"| node_cokerecipes
node_tile -.->|"produces items"| node_items
node_guihandler -->|"reads tile entity"| node_tile
node_guihandler -->|"creates container"| node_container
node_guihandler -->|"creates screen"| node_ovenui
node_container -->|"uses inventory"| node_tile
node_container -->|"reads recipes"| node_cokerecipes
node_neicoke -->|"lists recipes"| node_cokerecipes
node_nei -->|"uses registered items"| node_items
node_waila -->|"inspects controller"| node_cokecontroller
node_keyhandler -->|"opens status view"| node_compat
node_proxy -->|"client setup"| node_keyhandler
node_proxy -->|"registers event handler"| node_pause

click node_entry "https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/Recrafted.java"
click node_proxy "https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/CommonProxy.java"
click node_config "https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/config/Config.java"
click node_items "https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/registers/RecraftedItems.java"
click node_blocks "https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/registers/RecraftedBlocks.java"
click node_amulets "https://github.com/xabyxd/recrafted-alloys-and-amulets/tree/master/src/main/java/net/xabyxd/recrafted/items/amulets"
click node_oregen "https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/world/OreGenerator.java"
click node_recipes "https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/registers/RecipesRegister.java"
click node_fuel "https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/registers/RecraftedFuelHandler.java"
click node_cokecontroller "https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/blocks/machines/CokeOvenController.java"
click node_blast "https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/blocks/machines/BlastFurnaceController.java"
click node_tile "https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/tileentity/TileEntityCokeOven.java"
click node_cokerecipes "https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/registers/recipes/CokeOvenRecipes.java"
click node_guihandler "https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/gui/GuiHandler.java"
click node_container "https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/gui/ContainerCokeOven.java"
click node_ovenui "https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/gui/GuiCokeOven.java"
click node_nei "https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/compat/nei/NEIRecipes.java"
click node_neicoke "https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/compat/nei/CokeOvenRecipeHandler.java"
click node_waila "https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/compat/waila/WailaCompat.java"
click node_compat "https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/compat/Compat.java"
click node_keyhandler "https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/compat/KeyHandler.java"
click node_pause "https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/PauseMenuHandler.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,node_proxy,node_config toneBlue
class node_items,node_blocks,node_amulets,node_oregen,node_recipes toneAmber
class node_fuel,node_cokecontroller,node_blast,node_tile,node_cokerecipes toneMint
class node_guihandler,node_container,node_ovenui,node_keyhandler,node_pause toneRose
class node_nei,node_neicoke,node_waila,node_compat,node_game toneIndigo
```

## Components

### Mod Runtime

- [Mod Lifecycle](https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/Recrafted.java): `src/main/java/net/xabyxd/recrafted/Recrafted.java`
- [Lifecycle Setup](https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/CommonProxy.java): `src/main/java/net/xabyxd/recrafted/CommonProxy.java`
- [Configuration](https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/config/Config.java): `src/main/java/net/xabyxd/recrafted/config/Config.java`

### Materials and World

- [Items and Tools](https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/registers/RecraftedItems.java): `src/main/java/net/xabyxd/recrafted/registers/RecraftedItems.java`
- [Blocks and Ores](https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/registers/RecraftedBlocks.java): `src/main/java/net/xabyxd/recrafted/registers/RecraftedBlocks.java`
- [Gem Amulets](https://github.com/xabyxd/recrafted-alloys-and-amulets/tree/master/src/main/java/net/xabyxd/recrafted/items/amulets): `src/main/java/net/xabyxd/recrafted/items/amulets`
- [Ore Generation](https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/world/OreGenerator.java): `src/main/java/net/xabyxd/recrafted/world/OreGenerator.java`
- [Recipe Setup](https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/registers/RecipesRegister.java): `src/main/java/net/xabyxd/recrafted/registers/RecipesRegister.java`

### Processing Machines

- [Fuel Handler](https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/registers/RecraftedFuelHandler.java): `src/main/java/net/xabyxd/recrafted/registers/RecraftedFuelHandler.java`
- [Coke Oven Block](https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/blocks/machines/CokeOvenController.java): `src/main/java/net/xabyxd/recrafted/blocks/machines/CokeOvenController.java`
- [Blast Furnace](https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/blocks/machines/BlastFurnaceController.java): `src/main/java/net/xabyxd/recrafted/blocks/machines/BlastFurnaceController.java`
- [Oven Processing](https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/tileentity/TileEntityCokeOven.java): `src/main/java/net/xabyxd/recrafted/tileentity/TileEntityCokeOven.java`
- [Oven Recipes](https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/registers/recipes/CokeOvenRecipes.java): `src/main/java/net/xabyxd/recrafted/registers/recipes/CokeOvenRecipes.java`

### Player Interfaces

- [GUI Routing](https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/gui/GuiHandler.java): `src/main/java/net/xabyxd/recrafted/gui/GuiHandler.java`
- [Oven Container](https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/gui/ContainerCokeOven.java): `src/main/java/net/xabyxd/recrafted/gui/ContainerCokeOven.java`
- [Oven Screen](https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/gui/GuiCokeOven.java): `src/main/java/net/xabyxd/recrafted/gui/GuiCokeOven.java`
- [Compat Status Key](https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/compat/KeyHandler.java): `src/main/java/net/xabyxd/recrafted/compat/KeyHandler.java`
- [Pause Menu Add-on](https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/PauseMenuHandler.java): `src/main/java/net/xabyxd/recrafted/PauseMenuHandler.java`

### Mod Integrations

- [NEI Recipes](https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/compat/nei/NEIRecipes.java): `src/main/java/net/xabyxd/recrafted/compat/nei/NEIRecipes.java`
- [Oven NEI View](https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/compat/nei/CokeOvenRecipeHandler.java): `src/main/java/net/xabyxd/recrafted/compat/nei/CokeOvenRecipeHandler.java`
- [Waila Support](https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/compat/waila/WailaCompat.java): `src/main/java/net/xabyxd/recrafted/compat/waila/WailaCompat.java`
- [Compat Setup](https://github.com/xabyxd/recrafted-alloys-and-amulets/blob/master/src/main/java/net/xabyxd/recrafted/compat/Compat.java): `src/main/java/net/xabyxd/recrafted/compat/Compat.java`

### Other components

- **Minecraft / Forge**

## Connections

- Minecraft / Forge → Mod Lifecycle: loads mod
- Mod Lifecycle → Lifecycle Setup: delegates lifecycle (evidence: `src/main/java/net/xabyxd/recrafted/Recrafted.java`)
- Lifecycle Setup → Configuration: loads settings (evidence: `src/main/java/net/xabyxd/recrafted/CommonProxy.java`)
- Lifecycle Setup → Compat Setup: initializes (evidence: `src/main/java/net/xabyxd/recrafted/CommonProxy.java`)
- Lifecycle Setup → Items and Tools: initializes (evidence: `src/main/java/net/xabyxd/recrafted/CommonProxy.java`)
- Lifecycle Setup → Blocks and Ores: initializes (evidence: `src/main/java/net/xabyxd/recrafted/CommonProxy.java`)
- Lifecycle Setup → Recipe Setup: registers (evidence: `src/main/java/net/xabyxd/recrafted/CommonProxy.java`)
- Lifecycle Setup → Fuel Handler: registers (evidence: `src/main/java/net/xabyxd/recrafted/CommonProxy.java`)
- Lifecycle Setup → Ore Generation: registers (evidence: `src/main/java/net/xabyxd/recrafted/CommonProxy.java`)
- Lifecycle Setup → Oven Recipes: initializes (evidence: `src/main/java/net/xabyxd/recrafted/CommonProxy.java`)
- Lifecycle Setup → Waila Support: registers compatibility (evidence: `src/main/java/net/xabyxd/recrafted/CommonProxy.java`)
- Lifecycle Setup → Oven Processing: registers tile entities (evidence: `src/main/java/net/xabyxd/recrafted/CommonProxy.java`)
- Lifecycle Setup → GUI Routing: registers GUI (evidence: `src/main/java/net/xabyxd/recrafted/CommonProxy.java`)
- Lifecycle Setup → Gem Amulets: initializes magic items (evidence: `src/main/java/net/xabyxd/recrafted/CommonProxy.java`)
- Ore Generation → Blocks and Ores: uses registered ores (evidence: `src/main/java/net/xabyxd/recrafted/world/OreGenerator.java`)
- Coke Oven Block → Oven Processing: creates tile entity (evidence: `src/main/java/net/xabyxd/recrafted/blocks/machines/CokeOvenController.java`)
- Coke Oven Block → GUI Routing: opens GUI (evidence: `src/main/java/net/xabyxd/recrafted/blocks/machines/CokeOvenController.java`)
- Oven Processing → Oven Recipes: queries recipes (evidence: `src/main/java/net/xabyxd/recrafted/tileentity/TileEntityCokeOven.java`)
- Oven Processing → Items and Tools: produces items
- GUI Routing → Oven Processing: reads tile entity (evidence: `src/main/java/net/xabyxd/recrafted/gui/GuiHandler.java`)
- GUI Routing → Oven Container: creates container (evidence: `src/main/java/net/xabyxd/recrafted/gui/GuiHandler.java`)
- GUI Routing → Oven Screen: creates screen (evidence: `src/main/java/net/xabyxd/recrafted/gui/GuiHandler.java`)
- Oven Container → Oven Processing: uses inventory (evidence: `src/main/java/net/xabyxd/recrafted/gui/ContainerCokeOven.java`)
- Oven Container → Oven Recipes: reads recipes (evidence: `src/main/java/net/xabyxd/recrafted/gui/ContainerCokeOven.java`)
- Oven NEI View → Oven Recipes: lists recipes (evidence: `src/main/java/net/xabyxd/recrafted/compat/nei/CokeOvenRecipeHandler.java`)
- NEI Recipes → Items and Tools: uses registered items (evidence: `src/main/java/net/xabyxd/recrafted/compat/nei/NEIRecipes.java`)
- Waila Support → Coke Oven Block: inspects controller (evidence: `src/main/java/net/xabyxd/recrafted/compat/waila/WailaCompat.java`)
- Compat Status Key → Compat Setup: opens status view (evidence: `src/main/java/net/xabyxd/recrafted/compat/KeyHandler.java`)
- Lifecycle Setup → Compat Status Key: client setup (evidence: `src/main/java/net/xabyxd/recrafted/ClientProxy.java`)
- Lifecycle Setup → Pause Menu Add-on: registers event handler (evidence: `src/main/java/net/xabyxd/recrafted/ClientProxy.java`)
