# cheesysponge/cheesysponge-mod architecture

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

## Overview

The Cheese & Sponges is a Fabric Minecraft content mod: it adds themed blocks, items, fluids, entities and world features, alongside commands and gameplay systems. A representative player workflow is using the Cheese Blaster: its block entity processes a custom recipe and exposes a screen handler, which is rendered client-side; REI provides a recipe-viewer integration. SpongeMod is the initialization orchestrator. The supplied excerpts and index support those links, but leave many gameplay implementations unsampled, so those branches are shown without speculative wiring.

Main entry points: [`src/main/java/name/cheesysponge/SpongeMod.java`](https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/SpongeMod.java) (Mod initializer), [`src/main/java/name/cheesysponge/entity/ModEntities.java`](https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/entity/ModEntities.java) (Entity registrations), [`src/main/java/name/cheesysponge/block/ModBlocks.java`](https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/block/ModBlocks.java) (Blocks), [`src/main/java/name/cheesysponge/CheesyClientMod.java`](https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/CheesyClientMod.java) (Client setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_init["Mod initialization"]
  node_sponge["Mod initializer<br/>[SpongeMod.java]"]
  node_registries["Gameplay registrations<br/>[ModRegistries.java]"]
end

subgraph group_content["Cheese content"]
  node_blocks["Blocks<br/>[ModBlocks.java]"]
  node_items["Items<br/>[ModItems.java]"]
  node_fluids["Cheese fluid<br/>[CheeseFluid.java]"]
  node_entities["Entity registrations<br/>[ModEntities.java]"]
  node_cheese_bird["Cheese bird AI"]
  node_cheese_boss["Cheese boss"]
  node_cheese_entity["Cheese creature<br/>[CheeseEntity.java]"]
end

subgraph group_blaster["Blaster crafting"]
  node_blaster_entity["Blaster processing"]
  node_recipe["Blaster recipe"]
  node_screen_handler["Blaster screen handler"]
end

subgraph group_world["World and gameplay"]
  node_worldgen["World generation"]
  node_dimensions["Dimensions<br/>[ModDimensions.java]"]
  node_villagers["Villagers and trades<br/>[ModVillagers.java]"]
  node_commands["Home commands"]
  node_effects["Effects and potions<br/>[ModEffects.java]"]
  node_enchantments["Enchantments"]
end

subgraph group_client["Client presentation"]
  node_screen["Blaster screen"]
  node_rei["REI recipe viewer"]
  node_client_init["Client setup"]
end

node_player(("Minecraft player"))

node_sponge -->|"registers"| node_blocks
node_sponge -->|"registers"| node_items
node_sponge -->|"initializes"| node_registries
node_sponge -->|"registers"| node_worldgen
node_sponge -.->|"initializes"| node_entities
node_sponge -->|"registers"| node_villagers
node_sponge -.->|"registers"| node_effects
node_sponge -.->|"registers"| node_enchantments
node_sponge -->|"registers"| node_dimensions
node_sponge -->|"registers"| node_screen_handler
node_sponge -.->|"registers"| node_recipe
node_registries -->|"registers"| node_commands
node_registries -->|"configures trades"| node_villagers
node_blocks -->|"uses"| node_fluids
node_items -->|"references"| node_blocks
node_items -->|"references"| node_entities
node_player -.->|"uses"| node_blaster_entity
node_blaster_entity -->|"checks recipe"| node_recipe
node_blaster_entity -->|"opens handler"| node_screen_handler
node_screen_handler -->|"renders as"| node_screen
node_rei -->|"registers displays"| node_recipe
node_rei -->|"registers area"| node_screen
node_rei -->|"sets workstation"| node_blocks
node_entities -->|"registers type"| node_cheese_bird
node_entities -->|"registers type"| node_cheese_boss
node_entities -->|"registers type"| node_cheese_entity
node_client_init -->|"configures rendering"| node_blocks
node_client_init -->|"registers renderers"| node_entities
node_client_init -->|"registers rendering"| node_fluids
node_client_init -->|"registers screen"| node_screen

click node_sponge "https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/SpongeMod.java"
click node_registries "https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/util/ModRegistries.java"
click node_blocks "https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/block/ModBlocks.java"
click node_items "https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/item/ModItems.java"
click node_fluids "https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/fluid/CheeseFluid.java"
click node_blaster_entity "https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/block/entity/CheeseBlasterBlockEntity.java"
click node_recipe "https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/recipe/CheeseBlasterRecipe.java"
click node_screen_handler "https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/screen/CheeseBlasterScreenHandler.java"
click node_screen "https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/screen/CheeseBlasterScreen.java"
click node_rei "https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/compat/ModREIClientPlugin.java"
click node_entities "https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/entity/ModEntities.java"
click node_cheese_bird "https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/entity/custom/CheeseBirdEntity.java"
click node_cheese_boss "https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/entity/custom/CheeseBossEntity.java"
click node_cheese_entity "https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/entity/custom/CheeseEntity.java"
click node_worldgen "https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/world/feature/ModConfiguredFeatures.java"
click node_dimensions "https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/world/dimension/ModDimensions.java"
click node_villagers "https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/villager/ModVillagers.java"
click node_commands "https://github.com/cheesysponge/cheesysponge-mod/tree/1.20/src/main/java/name/cheesysponge/command"
click node_effects "https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/effect/ModEffects.java"
click node_enchantments "https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/enchantment/ModEnchantments.java"
click node_client_init "https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/CheesyClientMod.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_sponge,node_registries toneBlue
class node_blocks,node_items,node_fluids,node_entities,node_cheese_bird,node_cheese_boss,node_cheese_entity toneAmber
class node_blaster_entity,node_recipe,node_screen_handler toneMint
class node_worldgen,node_dimensions,node_villagers,node_commands,node_effects,node_enchantments toneRose
class node_screen,node_rei,node_client_init,node_player toneIndigo
```

## Components

### Mod initialization

- [Mod initializer](https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/SpongeMod.java): `src/main/java/name/cheesysponge/SpongeMod.java`
- [Gameplay registrations](https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/util/ModRegistries.java): `src/main/java/name/cheesysponge/util/ModRegistries.java`

### Cheese content

- [Blocks](https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/block/ModBlocks.java): `src/main/java/name/cheesysponge/block/ModBlocks.java`
- [Items](https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/item/ModItems.java): `src/main/java/name/cheesysponge/item/ModItems.java`
- [Cheese fluid](https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/fluid/CheeseFluid.java): `src/main/java/name/cheesysponge/fluid/CheeseFluid.java`
- [Entity registrations](https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/entity/ModEntities.java): `src/main/java/name/cheesysponge/entity/ModEntities.java`
- [Cheese bird AI](https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/entity/custom/CheeseBirdEntity.java): `src/main/java/name/cheesysponge/entity/custom/CheeseBirdEntity.java`
- [Cheese boss](https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/entity/custom/CheeseBossEntity.java): `src/main/java/name/cheesysponge/entity/custom/CheeseBossEntity.java`
- [Cheese creature](https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/entity/custom/CheeseEntity.java): `src/main/java/name/cheesysponge/entity/custom/CheeseEntity.java`

### Blaster crafting

- [Blaster processing](https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/block/entity/CheeseBlasterBlockEntity.java): `src/main/java/name/cheesysponge/block/entity/CheeseBlasterBlockEntity.java`
- [Blaster recipe](https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/recipe/CheeseBlasterRecipe.java): `src/main/java/name/cheesysponge/recipe/CheeseBlasterRecipe.java`
- [Blaster screen handler](https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/screen/CheeseBlasterScreenHandler.java): `src/main/java/name/cheesysponge/screen/CheeseBlasterScreenHandler.java`

### World and gameplay

- [World generation](https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/world/feature/ModConfiguredFeatures.java): `src/main/java/name/cheesysponge/world/feature/ModConfiguredFeatures.java`
- [Dimensions](https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/world/dimension/ModDimensions.java): `src/main/java/name/cheesysponge/world/dimension/ModDimensions.java`
- [Villagers and trades](https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/villager/ModVillagers.java): `src/main/java/name/cheesysponge/villager/ModVillagers.java`
- [Home commands](https://github.com/cheesysponge/cheesysponge-mod/tree/1.20/src/main/java/name/cheesysponge/command): `src/main/java/name/cheesysponge/command`
- [Effects and potions](https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/effect/ModEffects.java): `src/main/java/name/cheesysponge/effect/ModEffects.java`
- [Enchantments](https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/enchantment/ModEnchantments.java): `src/main/java/name/cheesysponge/enchantment/ModEnchantments.java`

### Client presentation

- [Blaster screen](https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/screen/CheeseBlasterScreen.java): `src/main/java/name/cheesysponge/screen/CheeseBlasterScreen.java`
- [REI recipe viewer](https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/compat/ModREIClientPlugin.java): `src/main/java/name/cheesysponge/compat/ModREIClientPlugin.java`
- [Client setup](https://github.com/cheesysponge/cheesysponge-mod/blob/1.20/src/main/java/name/cheesysponge/CheesyClientMod.java): `src/main/java/name/cheesysponge/CheesyClientMod.java`

### Other components

- **Minecraft player**

## Connections

- Mod initializer → Blocks: registers (evidence: `src/main/java/name/cheesysponge/SpongeMod.java`)
- Mod initializer → Items: registers (evidence: `src/main/java/name/cheesysponge/SpongeMod.java`)
- Mod initializer → Gameplay registrations: initializes (evidence: `src/main/java/name/cheesysponge/SpongeMod.java`)
- Mod initializer → World generation: registers (evidence: `src/main/java/name/cheesysponge/SpongeMod.java`)
- Mod initializer → Entity registrations: initializes (evidence: `src/main/java/name/cheesysponge/entity/ModEntities.java`)
- Mod initializer → Villagers and trades: registers (evidence: `src/main/java/name/cheesysponge/SpongeMod.java`)
- Mod initializer → Effects and potions: registers (evidence: `src/main/java/name/cheesysponge/SpongeMod.java`)
- Mod initializer → Enchantments: registers (evidence: `src/main/java/name/cheesysponge/SpongeMod.java`)
- Mod initializer → Dimensions: registers (evidence: `src/main/java/name/cheesysponge/SpongeMod.java`)
- Mod initializer → Blaster screen handler: registers (evidence: `src/main/java/name/cheesysponge/SpongeMod.java`)
- Mod initializer → Blaster recipe: registers
- Gameplay registrations → Home commands: registers (evidence: `src/main/java/name/cheesysponge/util/ModRegistries.java`)
- Gameplay registrations → Villagers and trades: configures trades (evidence: `src/main/java/name/cheesysponge/util/ModRegistries.java`)
- Blocks → Cheese fluid: uses (evidence: `src/main/java/name/cheesysponge/block/ModBlocks.java`)
- Items → Blocks: references (evidence: `src/main/java/name/cheesysponge/item/ModItems.java`)
- Items → Entity registrations: references (evidence: `src/main/java/name/cheesysponge/item/ModItems.java`)
- Minecraft player → Blaster processing: uses
- Blaster processing → Blaster recipe: checks recipe (evidence: `src/main/java/name/cheesysponge/block/entity/CheeseBlasterBlockEntity.java`)
- Blaster processing → Blaster screen handler: opens handler (evidence: `src/main/java/name/cheesysponge/block/entity/CheeseBlasterBlockEntity.java`)
- Blaster screen handler → Blaster screen: renders as (evidence: `src/main/java/name/cheesysponge/screen/CheeseBlasterScreen.java`)
- REI recipe viewer → Blaster recipe: registers displays (evidence: `src/main/java/name/cheesysponge/compat/ModREIClientPlugin.java`)
- REI recipe viewer → Blaster screen: registers area (evidence: `src/main/java/name/cheesysponge/compat/ModREIClientPlugin.java`)
- REI recipe viewer → Blocks: sets workstation (evidence: `src/main/java/name/cheesysponge/compat/ModREIClientPlugin.java`)
- Entity registrations → Cheese bird AI: registers type (evidence: `src/main/java/name/cheesysponge/entity/ModEntities.java`)
- Entity registrations → Cheese boss: registers type (evidence: `src/main/java/name/cheesysponge/entity/ModEntities.java`)
- Entity registrations → Cheese creature: registers type (evidence: `src/main/java/name/cheesysponge/entity/ModEntities.java`)
- Client setup → Blocks: configures rendering (evidence: `src/main/java/name/cheesysponge/CheesyClientMod.java`)
- Client setup → Entity registrations: registers renderers (evidence: `src/main/java/name/cheesysponge/CheesyClientMod.java`)
- Client setup → Cheese fluid: registers rendering (evidence: `src/main/java/name/cheesysponge/CheesyClientMod.java`)
- Client setup → Blaster screen: registers screen (evidence: `src/main/java/name/cheesysponge/CheesyClientMod.java`)
