# ff11222/atomicarchitect architecture

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

- Interactive diagram: https://gitdiagram.com/ff11222/atomicarchitect
- Repository: https://github.com/ff11222/atomicarchitect

## Overview

##### Project type and purpose
- From the file tree and README (“這是一個可以自由地組裝和分解各種原子的minecraft模組”), we see this is a Minecraft mod (Atomic Architect) built with Gradle, targeting Forge or Fabric. Its purpose is to let players assemble and decompose atoms in-game.

##### File structure
- Top-level build files: build.gradle, gradle wrapper, settings.gradle → standard Gradle mod project.
- src/main/java/org/tingyu/atomicarchitect:
- AtomicArchitect.java – mod entry point
- client/… – client-only code (GUI screens registration)
- common/… – shared logic (handlers, utilities, world, inventory, items, blocks, recipes)
- src/main/resources:
- META-INF/mods.toml – mod metadata
- assets/atomic_architect – blockstates, models, textures, lang files
- pack.mcmeta – resource pack descriptor

##### README for insights
- While minimal, it confirms the functionality (atomic assembly/decomposition) which maps to recipes, containers, blocks, and UI screens.

##### Elements
- Mod Loader/Minecraft Engine
- AtomicArchitect (entry point)
- RegistryHandler
- Package modules (client GUI, common logic, utilities)
- Resource assets folder
- Startup flow: Entry Point → RegistryHandler → Minecraft engine registers items/blocks/recipes.
- Runtime flow: Player Input → GUI Screen → Container/Menu → World/Inventory update → Client render.
- Data dependencies: Recipes ↔ Serialization ↔ Registry.
- Blue for client-only components
- Green for server/common logic
- Orange for external systems (Minecraft engine, mod loader)
- Grey for resources/assets

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External Systems
    ModLoader["Mod Loader / Minecraft Engine"]:::external
    Player["Player"]:::external

    %% Startup Flow
    ModLoader -->|"loads mod"| AtomicArchitect
    AtomicArchitect["AtomicArchitect (Entry Point)"]:::common -->|"calls register()"| RegistryHandler

    %% Common Logic Subgraph
    subgraph "Common Logic" 
        direction TB
        RegistryHandler["RegistryHandler"]:::common
        RegistryHandler -->|"register blocks"| ModBlocks
        RegistryHandler -->|"register menus"| ModMenuTypes
        RegistryHandler -->|"register items"| ModItems
        RegistryHandler -->|"register recipes"| ModRecipeTypes

        ModBlocks["ModBlocks"]:::common
        ModMenuTypes["ModMenuTypes"]:::common
        ModItems["ModItems"]:::common
        ModRecipeTypes["ModRecipeTypes"]:::common

        %% World Blocks
        AlchemyTableBlock["AlchemyTableBlock"]:::common
        ModBlocks --> AlchemyTableBlock

        %% Inventory & Menus
        AlchemyTable["AlchemyTable entity"]:::common
        AlchemyContainer["AlchemyContainer"]:::common
        AlchemyTableMenu["AlchemyTableMenu"]:::common
        MatterDecomposerMenu["MatterDecomposerMenu"]:::common
        ModResultSlot["ModResultSlot"]:::common

        ModMenuTypes --> AlchemyTableMenu
        ModMenuTypes --> MatterDecomposerMenu
        AlchemyTableMenu --> AlchemyContainer
        AlchemyContainer --> AlchemyTable
        AlchemyContainer --> ModResultSlot

        %% Items & Recipes
        ElementItem["ElementItem"]:::common
        ModCreativeModeTab["ModCreativeModeTab"]:::common
        AlchemyRecipe["AlchemyRecipe"]:::common
        ModRecipeSerializer["ModRecipeSerializer"]:::common

        ElementItem --> ModCreativeModeTab
        ModItems --> ElementItem
        ModItems --> ModCreativeModeTab
        AlchemyRecipe --> ModRecipeSerializer
        ModRecipeTypes --> AlchemyRecipe

        %% Utilities
        Coordinate2i["Coordinate2i"]:::common
    end

    %% Client Layer Subgraph
    subgraph "Client (GUI & Rendering)"
        direction TB
        ModMenuScreens["ModMenuScreens"]:::client
        AlchemyTableScreen["AlchemyTableScreen"]:::client

        Player -->|"open GUI"| ModMenuScreens
        ModMenuScreens -->|"Packet: Open Menu"| AlchemyTableMenu
        AlchemyTableMenu -->|"updateInventory"| AlchemyContainer
        AlchemyContainer -->|"world update"| AlchemyTable
        AlchemyTable -->|"world sync"| ModLoader
        ModLoader -->|"render"| AlchemyTableScreen
        AlchemyTableScreen -->|"fetch assets"| Resources
    end

    %% Resources Subgraph
    subgraph "Resource Assets"
        direction TB
        ModsToml["mods.toml"]:::resource
        Blockstates["blockstates/alchemy_table.json"]:::resource
        BlockModel["models/block/alchemy_table.json"]:::resource
        ItemModel1["models/item/alchemy_table.json"]:::resource
        ItemModel2["models/item/hydrogen.json"]:::resource
        TexturesBlock["textures/block"]:::resource
        TexturesGUI["textures/gui/container"]:::resource
        TexturesItem["textures/item"]:::resource
        Lang1["lang/en_us.json"]:::resource
        Lang2["lang/zh_tw.json"]:::resource
        PackMC["pack.mcmeta"]:::resource

        Resources --> ModsToml
        Resources --> Blockstates
        Resources --> BlockModel
        Resources --> ItemModel1
        Resources --> ItemModel2
        Resources --> TexturesBlock
        Resources --> TexturesGUI
        Resources --> TexturesItem
        Resources --> Lang1
        Resources --> Lang2
        Resources --> PackMC
        Resources --> ModLoader
    end

    %% Click Events
    click AtomicArchitect "https://github.com/ff11222/atomicarchitect/blob/master/src/main/java/org/tingyu/atomicarchitect/AtomicArchitect.java"
    click RegistryHandler "https://github.com/ff11222/atomicarchitect/blob/master/src/main/java/org/tingyu/atomicarchitect/common/handler/RegistryHandler.java"
    click ModMenuScreens "https://github.com/ff11222/atomicarchitect/blob/master/src/main/java/org/tingyu/atomicarchitect/client/gui/screen/ModMenuScreens.java"
    click AlchemyTableScreen "https://github.com/ff11222/atomicarchitect/blob/master/src/main/java/org/tingyu/atomicarchitect/client/gui/screen/inventory/AlchemyTableScreen.java"
    click AlchemyTableBlock "https://github.com/ff11222/atomicarchitect/blob/master/src/main/java/org/tingyu/atomicarchitect/common/world/level/block/AlchemyTableBlock.java"
    click ModBlocks "https://github.com/ff11222/atomicarchitect/blob/master/src/main/java/org/tingyu/atomicarchitect/common/world/level/block/ModBlocks.java"
    click AlchemyTable "https://github.com/ff11222/atomicarchitect/blob/master/src/main/java/org/tingyu/atomicarchitect/common/world/inventory/AlchemyTable.java"
    click AlchemyContainer "https://github.com/ff11222/atomicarchitect/blob/master/src/main/java/org/tingyu/atomicarchitect/common/world/inventory/AlchemyContainer.java"
    click AlchemyTableMenu "https://github.com/ff11222/atomicarchitect/blob/master/src/main/java/org/tingyu/atomicarchitect/common/world/inventory/AlchemyTableMenu.java"
    click MatterDecomposerMenu "https://github.com/ff11222/atomicarchitect/blob/master/src/main/java/org/tingyu/atomicarchitect/common/world/inventory/MatterDecomposerMenu.java"
    click ModMenuTypes "https://github.com/ff11222/atomicarchitect/blob/master/src/main/java/org/tingyu/atomicarchitect/common/world/inventory/ModMenuTypes.java"
    click ModResultSlot "https://github.com/ff11222/atomicarchitect/blob/master/src/main/java/org/tingyu/atomicarchitect/common/world/inventory/ModResultSlot.java"
    click ElementItem "https://github.com/ff11222/atomicarchitect/blob/master/src/main/java/org/tingyu/atomicarchitect/common/world/item/ElementItem.java"
    click ModCreativeModeTab "https://github.com/ff11222/atomicarchitect/blob/master/src/main/java/org/tingyu/atomicarchitect/common/world/item/ModCreativeModeTab.java"
    click ModItems "https://github.com/ff11222/atomicarchitect/blob/master/src/main/java/org/tingyu/atomicarchitect/common/world/item/ModItems.java"
    click AlchemyRecipe "https://github.com/ff11222/atomicarchitect/blob/master/src/main/java/org/tingyu/atomicarchitect/common/world/item/crafting/AlchemyRecipe.java"
    click ModRecipeSerializer "https://github.com/ff11222/atomicarchitect/blob/master/src/main/java/org/tingyu/atomicarchitect/common/world/item/crafting/ModRecipeSerializer.java"
    click ModRecipeTypes "https://github.com/ff11222/atomicarchitect/blob/master/src/main/java/org/tingyu/atomicarchitect/common/world/item/crafting/ModRecipeTypes.java"
    click Coordinate2i "https://github.com/ff11222/atomicarchitect/blob/master/src/main/java/org/tingyu/atomicarchitect/common/util/math/Coordinate2i.java"
    click ModsToml "https://github.com/ff11222/atomicarchitect/blob/master/src/main/resources/META-INF/mods.toml"
    click Blockstates "https://github.com/ff11222/atomicarchitect/blob/master/src/main/resources/assets/atomic_architect/blockstates/alchemy_table.json"
    click BlockModel "https://github.com/ff11222/atomicarchitect/blob/master/src/main/resources/assets/atomic_architect/models/block/alchemy_table.json"
    click ItemModel1 "https://github.com/ff11222/atomicarchitect/blob/master/src/main/resources/assets/atomic_architect/models/item/alchemy_table.json"
    click ItemModel2 "https://github.com/ff11222/atomicarchitect/blob/master/src/main/resources/assets/atomic_architect/models/item/hydrogen.json"
    click TexturesBlock "https://github.com/ff11222/atomicarchitect/tree/master/src/main/resources/assets/atomic_architect/textures/block"
    click TexturesGUI "https://github.com/ff11222/atomicarchitect/tree/master/src/main/resources/assets/atomic_architect/textures/gui/container"
    click TexturesItem "https://github.com/ff11222/atomicarchitect/tree/master/src/main/resources/assets/atomic_architect/textures/item"
    click Lang1 "https://github.com/ff11222/atomicarchitect/blob/master/src/main/resources/assets/atomic_architect/lang/en_us.json"
    click Lang2 "https://github.com/ff11222/atomicarchitect/blob/master/src/main/resources/assets/atomic_architect/lang/zh_tw.json"
    click PackMC "https://github.com/ff11222/atomicarchitect/blob/master/src/main/resources/pack.mcmeta"

    %% Styles
    classDef external fill:#FFA500,stroke:#333,stroke-width:1px
    classDef common fill:#98FB98,stroke:#333,stroke-width:1px
    classDef client fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef resource fill:#D3D3D3,stroke:#333,stroke-width:1px
```
