# cheesysponge/advancedalloys architecture

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

- Interactive diagram: https://gitdiagram.com/cheesysponge/advancedalloys
- Repository: https://github.com/cheesysponge/advancedalloys

## Overview

Advanced Alloys is a Minecraft mod adding alloy materials, equipment, blocks, and an Alloy Blaster processing station. The main runtime flow is player interaction with the Blaster, its block entity processes fuel and recipe inputs into output, and the screen handler exposes inventory and progress to the client. Recipe discovery is also surfaced through REI. The README is minimal; the map follows the sampled source and SOURCE INDEX, so unsampled item, loot, and client details are represented at subsystem level.

Main entry points: [`src/main/java/name/advancedalloys/AdvancedAlloys.java`](https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/AdvancedAlloys.java) (Mod initializer), [`src/main/java/name/advancedalloys/compat/ModREIClientPlugin.java`](https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/compat/ModREIClientPlugin.java) (REI plugin), [`src/main/java/name/advancedalloys/block/entity/AlloyBlasterBlockEntity.java`](https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/block/entity/AlloyBlasterBlockEntity.java) (Blaster processing), [`src/main/java/name/advancedalloys/block/custom/AlloyBlasterBlock.java`](https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/block/custom/AlloyBlasterBlock.java) (Blaster block)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Mod registration"]
  node_bootstrap["Mod initializer"]
  node_loot["Loot modifiers"]
  node_block_entity_registry["Block entity registry"]
  node_recipe_registry["Recipe registry<br/>[ModRecipes.java]"]
  node_screen_registry["Screen registration"]
  node_particles["Particle types<br/>[ModParticles.java]"]
end

subgraph group_materials["Alloy content"]
  node_items["Items and tools<br/>[ModItems.java]"]
  node_item_behavior["Custom item behavior"]
  node_armor["Armor materials"]
  node_blocks["Alloy blocks<br/>[ModBlocks.java]"]
  node_item_groups["Creative groups<br/>[ModItemGroup.java]"]
end

subgraph group_blaster["Blaster processing"]
  node_blaster_block["Blaster block"]
  node_block_entity["Blaster processing"]
  node_inventory["Inventory helper"]
  node_recipes["Blaster recipes"]
  node_screen_handler["Screen handler"]
  node_slots["Special slots"]
end

subgraph group_client["Client integrations"]
  node_screen["Blaster screen"]
  node_particle_effects["Particle effects"]
  node_client_init["Client initializer"]
  node_rei_plugin["REI plugin"]
  node_rei_category["REI category"]
  node_rei_display["REI display"]
end

node_player(("Player"))

node_bootstrap -->|"registers"| node_items
node_bootstrap -->|"registers"| node_blocks
node_bootstrap -->|"registers"| node_item_groups
node_bootstrap -->|"registers"| node_screen_registry
node_bootstrap -->|"registers"| node_recipe_registry
node_bootstrap -->|"registers"| node_block_entity_registry
node_bootstrap -->|"configures"| node_loot
node_bootstrap -->|"registers"| node_particles
node_items -->|"instantiates"| node_item_behavior
node_items -->|"uses materials"| node_armor
node_blocks -->|"registers"| node_blaster_block
node_blaster_block -->|"creates"| node_block_entity
node_block_entity_registry -->|"registers"| node_block_entity
node_player -.->|"interacts"| node_blaster_block
node_blaster_block -.->|"opens screen"| node_screen_handler
node_block_entity -->|"implements"| node_inventory
node_block_entity -->|"matches and crafts"| node_recipes
node_block_entity -->|"creates menu"| node_screen_handler
node_recipe_registry -->|"registers"| node_recipes
node_screen_registry -->|"registers"| node_screen_handler
node_screen_handler -->|"uses"| node_slots
node_client_init -->|"registers"| node_screen
node_client_init -->|"registers"| node_particle_effects
node_client_init -->|"uses types"| node_particles
node_rei_plugin -->|"registers"| node_rei_category
node_rei_plugin -->|"registers"| node_rei_display
node_rei_plugin -->|"fills displays"| node_recipes
node_rei_plugin -->|"adds click area"| node_screen
node_rei_plugin -->|"adds workstation"| node_blocks
node_rei_display -->|"reads recipe"| node_recipes

click node_bootstrap "https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/AdvancedAlloys.java"
click node_items "https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/item/ModItems.java"
click node_item_behavior "https://github.com/cheesysponge/advancedalloys/tree/master/src/main/java/name/advancedalloys/item/custom"
click node_armor "https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/item/ModArmorMaterials.java"
click node_blocks "https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/block/ModBlocks.java"
click node_item_groups "https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/item/ModItemGroup.java"
click node_loot "https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/util/ModLootTableModifiers.java"
click node_blaster_block "https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/block/custom/AlloyBlasterBlock.java"
click node_block_entity "https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/block/entity/AlloyBlasterBlockEntity.java"
click node_block_entity_registry "https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/block/entity/ModBlockEntities.java"
click node_inventory "https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/util/ImplementedInventory.java"
click node_recipes "https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/recipe/AlloyBlasterRecipe.java"
click node_recipe_registry "https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/recipe/ModRecipes.java"
click node_screen_registry "https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/screen/ModScreenHandlers.java"
click node_screen_handler "https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/screen/AlloyBlasterScreenHandler.java"
click node_slots "https://github.com/cheesysponge/advancedalloys/tree/master/src/main/java/name/advancedalloys/screen/slot"
click node_screen "https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/screen/AlloyBlasterScreen.java"
click node_particles "https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/particle/ModParticles.java"
click node_particle_effects "https://github.com/cheesysponge/advancedalloys/tree/master/src/main/java/name/advancedalloys/particle/custom"
click node_client_init "https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/client/AdvancedAlloysClient.java"
click node_rei_plugin "https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/compat/ModREIClientPlugin.java"
click node_rei_category "https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/compat/AlloyBlasterRecipeCategory.java"
click node_rei_display "https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/compat/AlloyBlasterDisplay.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_bootstrap,node_loot,node_block_entity_registry,node_recipe_registry,node_screen_registry,node_particles toneBlue
class node_items,node_item_behavior,node_armor,node_blocks,node_item_groups toneAmber
class node_blaster_block,node_block_entity,node_inventory,node_recipes,node_screen_handler,node_slots toneMint
class node_screen,node_particle_effects,node_client_init,node_rei_plugin,node_rei_category,node_rei_display toneRose
class node_player toneIndigo
```

## Components

### Mod registration

- [Mod initializer](https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/AdvancedAlloys.java): `src/main/java/name/advancedalloys/AdvancedAlloys.java`
- [Loot modifiers](https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/util/ModLootTableModifiers.java): `src/main/java/name/advancedalloys/util/ModLootTableModifiers.java`
- [Block entity registry](https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/block/entity/ModBlockEntities.java): `src/main/java/name/advancedalloys/block/entity/ModBlockEntities.java`
- [Recipe registry](https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/recipe/ModRecipes.java): `src/main/java/name/advancedalloys/recipe/ModRecipes.java`
- [Screen registration](https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/screen/ModScreenHandlers.java): `src/main/java/name/advancedalloys/screen/ModScreenHandlers.java`
- [Particle types](https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/particle/ModParticles.java): `src/main/java/name/advancedalloys/particle/ModParticles.java`

### Alloy content

- [Items and tools](https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/item/ModItems.java): `src/main/java/name/advancedalloys/item/ModItems.java`
- [Custom item behavior](https://github.com/cheesysponge/advancedalloys/tree/master/src/main/java/name/advancedalloys/item/custom): `src/main/java/name/advancedalloys/item/custom`
- [Armor materials](https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/item/ModArmorMaterials.java): `src/main/java/name/advancedalloys/item/ModArmorMaterials.java`
- [Alloy blocks](https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/block/ModBlocks.java): `src/main/java/name/advancedalloys/block/ModBlocks.java`
- [Creative groups](https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/item/ModItemGroup.java): `src/main/java/name/advancedalloys/item/ModItemGroup.java`

### Blaster processing

- [Blaster block](https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/block/custom/AlloyBlasterBlock.java): `src/main/java/name/advancedalloys/block/custom/AlloyBlasterBlock.java`
- [Blaster processing](https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/block/entity/AlloyBlasterBlockEntity.java): `src/main/java/name/advancedalloys/block/entity/AlloyBlasterBlockEntity.java`
- [Inventory helper](https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/util/ImplementedInventory.java): `src/main/java/name/advancedalloys/util/ImplementedInventory.java`
- [Blaster recipes](https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/recipe/AlloyBlasterRecipe.java): `src/main/java/name/advancedalloys/recipe/AlloyBlasterRecipe.java`
- [Screen handler](https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/screen/AlloyBlasterScreenHandler.java): `src/main/java/name/advancedalloys/screen/AlloyBlasterScreenHandler.java`
- [Special slots](https://github.com/cheesysponge/advancedalloys/tree/master/src/main/java/name/advancedalloys/screen/slot): `src/main/java/name/advancedalloys/screen/slot`

### Client integrations

- [Blaster screen](https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/screen/AlloyBlasterScreen.java): `src/main/java/name/advancedalloys/screen/AlloyBlasterScreen.java`
- [Particle effects](https://github.com/cheesysponge/advancedalloys/tree/master/src/main/java/name/advancedalloys/particle/custom): `src/main/java/name/advancedalloys/particle/custom`
- [Client initializer](https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/client/AdvancedAlloysClient.java): `src/main/java/name/advancedalloys/client/AdvancedAlloysClient.java`
- [REI plugin](https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/compat/ModREIClientPlugin.java): `src/main/java/name/advancedalloys/compat/ModREIClientPlugin.java`
- [REI category](https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/compat/AlloyBlasterRecipeCategory.java): `src/main/java/name/advancedalloys/compat/AlloyBlasterRecipeCategory.java`
- [REI display](https://github.com/cheesysponge/advancedalloys/blob/master/src/main/java/name/advancedalloys/compat/AlloyBlasterDisplay.java): `src/main/java/name/advancedalloys/compat/AlloyBlasterDisplay.java`

### Other components

- **Player**

## Connections

- Mod initializer → Items and tools: registers (evidence: `src/main/java/name/advancedalloys/AdvancedAlloys.java`)
- Mod initializer → Alloy blocks: registers (evidence: `src/main/java/name/advancedalloys/AdvancedAlloys.java`)
- Mod initializer → Creative groups: registers (evidence: `src/main/java/name/advancedalloys/AdvancedAlloys.java`)
- Mod initializer → Screen registration: registers (evidence: `src/main/java/name/advancedalloys/AdvancedAlloys.java`)
- Mod initializer → Recipe registry: registers (evidence: `src/main/java/name/advancedalloys/AdvancedAlloys.java`)
- Mod initializer → Block entity registry: registers (evidence: `src/main/java/name/advancedalloys/AdvancedAlloys.java`)
- Mod initializer → Loot modifiers: configures (evidence: `src/main/java/name/advancedalloys/AdvancedAlloys.java`)
- Mod initializer → Particle types: registers (evidence: `src/main/java/name/advancedalloys/AdvancedAlloys.java`)
- Items and tools → Custom item behavior: instantiates (evidence: `src/main/java/name/advancedalloys/item/ModItems.java`)
- Items and tools → Armor materials: uses materials (evidence: `src/main/java/name/advancedalloys/item/ModItems.java`)
- Alloy blocks → Blaster block: registers (evidence: `src/main/java/name/advancedalloys/block/ModBlocks.java`)
- Blaster block → Blaster processing: creates (evidence: `src/main/java/name/advancedalloys/block/custom/AlloyBlasterBlock.java`)
- Block entity registry → Blaster processing: registers (evidence: `src/main/java/name/advancedalloys/block/entity/ModBlockEntities.java`)
- Player → Blaster block: interacts
- Blaster block → Screen handler: opens screen (evidence: `src/main/java/name/advancedalloys/block/custom/AlloyBlasterBlock.java`)
- Blaster processing → Inventory helper: implements (evidence: `src/main/java/name/advancedalloys/block/entity/AlloyBlasterBlockEntity.java`)
- Blaster processing → Blaster recipes: matches and crafts (evidence: `src/main/java/name/advancedalloys/block/entity/AlloyBlasterBlockEntity.java`)
- Blaster processing → Screen handler: creates menu (evidence: `src/main/java/name/advancedalloys/block/entity/AlloyBlasterBlockEntity.java`)
- Recipe registry → Blaster recipes: registers (evidence: `src/main/java/name/advancedalloys/recipe/ModRecipes.java`)
- Screen registration → Screen handler: registers (evidence: `src/main/java/name/advancedalloys/screen/ModScreenHandlers.java`)
- Screen handler → Special slots: uses (evidence: `src/main/java/name/advancedalloys/screen/AlloyBlasterScreenHandler.java`)
- Client initializer → Blaster screen: registers (evidence: `src/main/java/name/advancedalloys/client/AdvancedAlloysClient.java`)
- Client initializer → Particle effects: registers (evidence: `src/main/java/name/advancedalloys/client/AdvancedAlloysClient.java`)
- Client initializer → Particle types: uses types (evidence: `src/main/java/name/advancedalloys/client/AdvancedAlloysClient.java`)
- REI plugin → REI category: registers (evidence: `src/main/java/name/advancedalloys/compat/ModREIClientPlugin.java`)
- REI plugin → REI display: registers (evidence: `src/main/java/name/advancedalloys/compat/ModREIClientPlugin.java`)
- REI plugin → Blaster recipes: fills displays (evidence: `src/main/java/name/advancedalloys/compat/ModREIClientPlugin.java`)
- REI plugin → Blaster screen: adds click area (evidence: `src/main/java/name/advancedalloys/compat/ModREIClientPlugin.java`)
- REI plugin → Alloy blocks: adds workstation (evidence: `src/main/java/name/advancedalloys/compat/ModREIClientPlugin.java`)
- REI display → Blaster recipes: reads recipe (evidence: `src/main/java/name/advancedalloys/compat/AlloyBlasterDisplay.java`)
