# hajimimaodie8/bettergoldexpansion architecture

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

- Interactive diagram: https://gitdiagram.com/hajimimaodie8/bettergoldexpansion
- Repository: https://github.com/hajimimaodie8/bettergoldexpansion

## Overview

Better Gold is a NeoForge 1.21.1 Minecraft mod that adds gold-themed blocks and crops, the SturdyGold metal family, alchemical materials, recipes, equipment, and gameplay effects. The principal workflow is that the mod initializes and registers content, then player actions and game events use that content to produce crafting, farming, combat, trading, and loot results. Farmer’s Delight support is an additional documented capability. The excerpts establish registration and selected gameplay relationships; links for unsampled recipe and trade implementations are documented rather than source-verified.

Main entry points: [`src/main/java/com/hjmmd_8/bettergold/bettergold.java`](https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/bettergold.java) (Mod bootstrap), [`src/main/java/com/hjmmd_8/bettergold/registry/AllBlocks.java`](https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/registry/AllBlocks.java) (Block registry), [`src/main/java/com/hjmmd_8/bettergold/registry/AllItems.java`](https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/registry/AllItems.java) (Item registry), [`src/main/java/com/hjmmd_8/bettergold/material/MetalFamily.java`](https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/material/MetalFamily.java) (Metal families)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["Mod setup"]
  node_bootstrap["Mod bootstrap<br/>[bettergold.java]"]
  node_config["Configuration<br/>[Config.java]"]
end

subgraph group_content["Content and materials"]
  node_blocks["Block registry<br/>[AllBlocks.java]"]
  node_items["Item registry<br/>[AllItems.java]"]
  node_metals["Metal families<br/>[MetalFamily.java]"]
  node_metal_defs["Metal definitions<br/>[AllMetals.java]"]
  node_alchemy["Alchemy resources<br/>[AllItems.java]"]
  node_creative["Creative tab"]
end

subgraph group_gameplay["Gameplay systems"]
  node_crops["Gold crops<br/>[GoldCropBlock.java]"]
  node_farmland["Gold farmland"]
  node_events["Gameplay events<br/>[ModEvents.java]"]
  node_recipes["Recipe registry<br/>[AllRecipes.java]"]
  node_gold_food_recipe["Golden food recipe"]
  node_trades["Village trades<br/>[VillageTrades.java]"]
  node_brewing["Brewing additions<br/>[ModBrewing.java]"]
end

subgraph group_integration["Client and integration"]
  node_fd["Farmer’s Delight<br/>[FdModule.java]"]
  node_fd_items["FD food items<br/>[FdItems.java]"]
  node_network["Sound networking"]
  node_sound_client["Thunder sound client"]
end

node_player(("Player"))

node_bootstrap -->|"loads"| node_config
node_bootstrap -->|"registers"| node_blocks
node_bootstrap -->|"registers"| node_items
node_bootstrap -->|"registers"| node_recipes
node_bootstrap -->|"bootstraps"| node_metal_defs
node_metal_defs -->|"defines"| node_metals
node_metals -->|"registers family blocks"| node_blocks
node_metals -->|"registers family items"| node_items
node_blocks -->|"registers crops"| node_crops
node_blocks -->|"registers farmland"| node_farmland
node_crops -->|"requires planting soil"| node_farmland
node_player -.->|"grows crops"| node_crops
node_player -.->|"crafts items"| node_recipes
node_recipes -->|"registers recipe"| node_gold_food_recipe
node_gold_food_recipe -->|"uses ingredients"| node_items
node_player -.->|"triggers gameplay"| node_events
node_events -->|"creates drops"| node_items
node_events -->|"checks settings"| node_config
node_player -.->|"trades with villagers"| node_trades
node_player -.->|"brews potions"| node_brewing
node_bootstrap -->|"configures tab"| node_creative
node_bootstrap -.->|"initializes integration"| node_fd
node_fd -.->|"registers food"| node_fd_items
node_bootstrap -->|"sets up channel"| node_network
node_network -->|"dispatches payload"| node_sound_client
node_sound_client -->|"plays thunder sound"| node_player

click node_bootstrap "https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/bettergold.java"
click node_config "https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/config/Config.java"
click node_blocks "https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/registry/AllBlocks.java"
click node_items "https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/registry/AllItems.java"
click node_metals "https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/material/MetalFamily.java"
click node_metal_defs "https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/material/AllMetals.java"
click node_crops "https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/block/GoldCropBlock.java"
click node_farmland "https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/block/GoldInfusedFarmlandBlock.java"
click node_events "https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/event/ModEvents.java"
click node_recipes "https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/registry/AllRecipes.java"
click node_gold_food_recipe "https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/recipe/GoldenFoodRecipe.java"
click node_alchemy "https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/registry/AllItems.java"
click node_trades "https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/event/VillageTrades.java"
click node_brewing "https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/event/ModBrewing.java"
click node_creative "https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/material/CreativePageSections.java"
click node_fd "https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/fd/FdModule.java"
click node_fd_items "https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/fd/FdItems.java"
click node_network "https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/network/BetterGoldNetwork.java"
click node_sound_client "https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/client/ThunderSoundClientHandler.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_config toneBlue
class node_blocks,node_items,node_metals,node_metal_defs,node_alchemy,node_creative toneAmber
class node_crops,node_farmland,node_events,node_recipes,node_gold_food_recipe,node_trades,node_brewing toneMint
class node_fd,node_fd_items,node_network,node_sound_client toneRose
class node_player toneIndigo
```

## Components

### Mod setup

- [Mod bootstrap](https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/bettergold.java): `src/main/java/com/hjmmd_8/bettergold/bettergold.java`
- [Configuration](https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/config/Config.java): `src/main/java/com/hjmmd_8/bettergold/config/Config.java`

### Content and materials

- [Block registry](https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/registry/AllBlocks.java): `src/main/java/com/hjmmd_8/bettergold/registry/AllBlocks.java`
- [Item registry](https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/registry/AllItems.java): `src/main/java/com/hjmmd_8/bettergold/registry/AllItems.java`
- [Metal families](https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/material/MetalFamily.java): `src/main/java/com/hjmmd_8/bettergold/material/MetalFamily.java`
- [Metal definitions](https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/material/AllMetals.java): `src/main/java/com/hjmmd_8/bettergold/material/AllMetals.java`
- [Alchemy resources](https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/registry/AllItems.java): `src/main/java/com/hjmmd_8/bettergold/registry/AllItems.java`
- [Creative tab](https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/material/CreativePageSections.java): `src/main/java/com/hjmmd_8/bettergold/material/CreativePageSections.java`

### Gameplay systems

- [Gold crops](https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/block/GoldCropBlock.java): `src/main/java/com/hjmmd_8/bettergold/block/GoldCropBlock.java`
- [Gold farmland](https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/block/GoldInfusedFarmlandBlock.java): `src/main/java/com/hjmmd_8/bettergold/block/GoldInfusedFarmlandBlock.java`
- [Gameplay events](https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/event/ModEvents.java): `src/main/java/com/hjmmd_8/bettergold/event/ModEvents.java`
- [Recipe registry](https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/registry/AllRecipes.java): `src/main/java/com/hjmmd_8/bettergold/registry/AllRecipes.java`
- [Golden food recipe](https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/recipe/GoldenFoodRecipe.java): `src/main/java/com/hjmmd_8/bettergold/recipe/GoldenFoodRecipe.java`
- [Village trades](https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/event/VillageTrades.java): `src/main/java/com/hjmmd_8/bettergold/event/VillageTrades.java`
- [Brewing additions](https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/event/ModBrewing.java): `src/main/java/com/hjmmd_8/bettergold/event/ModBrewing.java`

### Client and integration

- [Farmer’s Delight](https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/fd/FdModule.java): `src/main/java/com/hjmmd_8/bettergold/fd/FdModule.java`
- [FD food items](https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/fd/FdItems.java): `src/main/java/com/hjmmd_8/bettergold/fd/FdItems.java`
- [Sound networking](https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/network/BetterGoldNetwork.java): `src/main/java/com/hjmmd_8/bettergold/network/BetterGoldNetwork.java`
- [Thunder sound client](https://github.com/hajimimaodie8/bettergoldexpansion/blob/main/src/main/java/com/hjmmd_8/bettergold/client/ThunderSoundClientHandler.java): `src/main/java/com/hjmmd_8/bettergold/client/ThunderSoundClientHandler.java`

### Other components

- **Player**

## Connections

- Mod bootstrap → Configuration: loads (evidence: `src/main/java/com/hjmmd_8/bettergold/bettergold.java`)
- Mod bootstrap → Block registry: registers (evidence: `src/main/java/com/hjmmd_8/bettergold/bettergold.java`)
- Mod bootstrap → Item registry: registers (evidence: `src/main/java/com/hjmmd_8/bettergold/bettergold.java`)
- Mod bootstrap → Recipe registry: registers (evidence: `src/main/java/com/hjmmd_8/bettergold/bettergold.java`)
- Mod bootstrap → Metal definitions: bootstraps (evidence: `src/main/java/com/hjmmd_8/bettergold/bettergold.java`)
- Metal definitions → Metal families: defines (evidence: `src/main/java/com/hjmmd_8/bettergold/material/AllMetals.java`)
- Metal families → Block registry: registers family blocks (evidence: `src/main/java/com/hjmmd_8/bettergold/material/MetalFamily.java`)
- Metal families → Item registry: registers family items (evidence: `src/main/java/com/hjmmd_8/bettergold/material/MetalFamily.java`)
- Block registry → Gold crops: registers crops (evidence: `src/main/java/com/hjmmd_8/bettergold/registry/AllBlocks.java`)
- Block registry → Gold farmland: registers farmland (evidence: `src/main/java/com/hjmmd_8/bettergold/registry/AllBlocks.java`)
- Gold crops → Gold farmland: requires planting soil (evidence: `src/main/java/com/hjmmd_8/bettergold/block/GoldCropBlock.java`)
- Player → Gold crops: grows crops (evidence: `README.md`)
- Player → Recipe registry: crafts items (evidence: `README.md`)
- Recipe registry → Golden food recipe: registers recipe (evidence: `src/main/java/com/hjmmd_8/bettergold/recipe/GoldenFoodRecipe.java`)
- Golden food recipe → Item registry: uses ingredients (evidence: `src/main/java/com/hjmmd_8/bettergold/recipe/GoldenFoodRecipe.java`)
- Player → Gameplay events: triggers gameplay (evidence: `README.md`)
- Gameplay events → Item registry: creates drops (evidence: `src/main/java/com/hjmmd_8/bettergold/event/ModEvents.java`)
- Gameplay events → Configuration: checks settings (evidence: `src/main/java/com/hjmmd_8/bettergold/event/ModEvents.java`)
- Player → Village trades: trades with villagers (evidence: `README.md`)
- Player → Brewing additions: brews potions (evidence: `README.md`)
- Mod bootstrap → Creative tab: configures tab (evidence: `src/main/java/com/hjmmd_8/bettergold/bettergold.java`)
- Mod bootstrap → Farmer’s Delight: initializes integration (evidence: `src/main/java/com/hjmmd_8/bettergold/bettergold.java`)
- Farmer’s Delight → FD food items: registers food (evidence: `src/main/java/com/hjmmd_8/bettergold/fd/FdItems.java`)
- Mod bootstrap → Sound networking: sets up channel (evidence: `src/main/java/com/hjmmd_8/bettergold/bettergold.java`)
- Sound networking → Thunder sound client: dispatches payload (evidence: `src/main/java/com/hjmmd_8/bettergold/network/BetterGoldNetwork.java`)
- Thunder sound client → Player: plays thunder sound (evidence: `src/main/java/com/hjmmd_8/bettergold/client/ThunderSoundClientHandler.java`)
