# zurrtum/create-fly architecture

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

- Interactive diagram: https://gitdiagram.com/zurrtum/create-fly
- Repository: https://github.com/zurrtum/create-fly

## Overview

Create Fly is a Fabric port of the Create Minecraft mod, adding Create-style blocks, kinetic machinery, moving contraptions, storage, trains, and logistics. A player places and operates registered content; contraptions assemble and move structures, while mounted storage preserves and synchronizes inventories. Client rendering and recipe-viewer integrations support the gameplay. The map emphasizes these domain stages and the sampled storage/rendering internals; many feature connections are omitted because their implementation was not sampled.

Main entry points: [`src/main/java/com/zurrtum/create/Create.java`](https://github.com/zurrtum/create-fly/blob/26.3/src/main/java/com/zurrtum/create/Create.java) (Mod Initialization), [`src/main/java/com/zurrtum/create/content/contraptions/MountedStorageManager.java`](https://github.com/zurrtum/create-fly/blob/26.3/src/main/java/com/zurrtum/create/content/contraptions/MountedStorageManager.java) (Mounted Storage Manager), [`src/client/java/com/zurrtum/create/client/Create.java`](https://github.com/zurrtum/create-fly/blob/26.3/src/client/java/com/zurrtum/create/client/Create.java) (Client Setup), [`src/main/java/com/zurrtum/create/AllBlocks.java`](https://github.com/zurrtum/create-fly/blob/26.3/src/main/java/com/zurrtum/create/AllBlocks.java) (Content Blocks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Content and Registration"]
  node_mod["Mod Initialization<br/>[Create.java]"]
  node_blocks["Content Blocks<br/>[AllBlocks.java]"]
  node_items["Content Items<br/>[AllItems.java]"]
  node_registries["Create Registries"]
end

subgraph group_motion["Kinetics and Contraptions"]
  node_steam["Steam Engine"]
  node_steam_entity["Engine Behavior"]
  node_contraption["Contraption Assembly<br/>[Contraption.java]"]
  node_psi["Portable Interface"]
  node_railways["Railway Manager"]
end

subgraph group_storage["Mounted Storage"]
  node_storage_manager["Mounted Storage Manager"]
  node_storage_api["Mounted Item Storage"]
  node_storage_types["Storage Types"]
  node_sync["Storage Sync Packet"]
end

subgraph group_client["Client Rendering"]
  node_client_init["Client Setup<br/>[Create.java]"]
  node_models["Partial Models"]
  node_render["Render Pipelines"]
  node_buffers["Cached Buffers<br/>[CachedBuffers.java]"]
  node_flywheel["Flywheel Engine<br/>[EngineImpl.java]"]
  node_compiler["Shader Compiler"]
  node_light["Light Storage<br/>[LightStorage.java]"]
end

subgraph group_integration["Mod Integrations"]
  node_recipe_compat["Recipe Viewer Compatibility"]
end

node_player(("Minecraft Player"))

node_player -.->|"places blocks"| node_blocks
node_mod -->|"registers content"| node_blocks
node_mod -->|"registers content"| node_items
node_mod -->|"initializes registries"| node_registries
node_blocks -->|"includes engine block"| node_steam
node_steam -->|"uses block entity"| node_steam_entity
node_contraption -->|"reads storage"| node_storage_manager
node_storage_manager -->|"mounts storage"| node_storage_api
node_storage_manager -->|"looks up types"| node_storage_types
node_storage_manager -->|"sends updates"| node_sync
node_mod -.->|"separates client setup"| node_client_init
node_client_init -.->|"registers models"| node_models
node_client_init -->|"registers rendering"| node_render
node_render -.->|"uses buffers"| node_buffers
node_flywheel -.->|"compiles pipelines"| node_compiler
node_light -->|"feeds visualization"| node_flywheel
node_recipe_compat -.->|"shows recipes"| node_player

click node_mod "https://github.com/zurrtum/create-fly/blob/26.3/src/main/java/com/zurrtum/create/Create.java"
click node_blocks "https://github.com/zurrtum/create-fly/blob/26.3/src/main/java/com/zurrtum/create/AllBlocks.java"
click node_items "https://github.com/zurrtum/create-fly/blob/26.3/src/main/java/com/zurrtum/create/AllItems.java"
click node_registries "https://github.com/zurrtum/create-fly/blob/26.3/src/main/java/com/zurrtum/create/api/registry/CreateRegistries.java"
click node_steam "https://github.com/zurrtum/create-fly/blob/26.3/src/main/java/com/zurrtum/create/content/kinetics/steamEngine/SteamEngineBlock.java"
click node_steam_entity "https://github.com/zurrtum/create-fly/blob/26.3/src/main/java/com/zurrtum/create/content/kinetics/steamEngine/SteamEngineBlockEntity.java"
click node_contraption "https://github.com/zurrtum/create-fly/blob/26.3/src/main/java/com/zurrtum/create/content/contraptions/Contraption.java"
click node_psi "https://github.com/zurrtum/create-fly/blob/26.3/src/main/java/com/zurrtum/create/content/contraptions/actors/psi/PortableStorageInterfaceBlockEntity.java"
click node_railways "https://github.com/zurrtum/create-fly/blob/26.3/src/main/java/com/zurrtum/create/content/trains/GlobalRailwayManager.java"
click node_storage_manager "https://github.com/zurrtum/create-fly/blob/26.3/src/main/java/com/zurrtum/create/content/contraptions/MountedStorageManager.java"
click node_storage_api "https://github.com/zurrtum/create-fly/blob/26.3/src/main/java/com/zurrtum/create/api/contraption/storage/item/MountedItemStorage.java"
click node_storage_types "https://github.com/zurrtum/create-fly/blob/26.3/src/main/java/com/zurrtum/create/AllMountedStorageTypes.java"
click node_sync "https://github.com/zurrtum/create-fly/blob/26.3/src/main/java/com/zurrtum/create/infrastructure/packet/s2c/MountedStorageSyncPacket.java"
click node_client_init "https://github.com/zurrtum/create-fly/blob/26.3/src/client/java/com/zurrtum/create/client/Create.java"
click node_models "https://github.com/zurrtum/create-fly/blob/26.3/src/client/java/com/zurrtum/create/client/AllPartialModels.java"
click node_render "https://github.com/zurrtum/create-fly/blob/26.3/src/client/java/com/zurrtum/create/client/foundation/render/AllRenderPipelines.java"
click node_buffers "https://github.com/zurrtum/create-fly/blob/26.3/src/client/java/com/zurrtum/create/client/catnip/render/CachedBuffers.java"
click node_flywheel "https://github.com/zurrtum/create-fly/blob/26.3/src/client/java/com/zurrtum/create/client/flywheel/backend/engine/EngineImpl.java"
click node_compiler "https://github.com/zurrtum/create-fly/blob/26.3/src/client/java/com/zurrtum/create/client/flywheel/backend/compile/PipelineCompiler.java"
click node_light "https://github.com/zurrtum/create-fly/blob/26.3/src/client/java/com/zurrtum/create/client/flywheel/backend/engine/LightStorage.java"
click node_recipe_compat "https://github.com/zurrtum/create-fly/blob/26.3/src/client/java/com/zurrtum/create/client/compat/jei/JeiClientPlugin.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_mod,node_blocks,node_items,node_registries toneBlue
class node_steam,node_steam_entity,node_contraption,node_psi,node_railways toneAmber
class node_storage_manager,node_storage_api,node_storage_types,node_sync toneMint
class node_client_init,node_models,node_render,node_buffers,node_flywheel,node_compiler,node_light toneRose
class node_recipe_compat,node_player toneIndigo
```

## Components

### Content and Registration

- [Mod Initialization](https://github.com/zurrtum/create-fly/blob/26.3/src/main/java/com/zurrtum/create/Create.java): `src/main/java/com/zurrtum/create/Create.java`
- [Content Blocks](https://github.com/zurrtum/create-fly/blob/26.3/src/main/java/com/zurrtum/create/AllBlocks.java): `src/main/java/com/zurrtum/create/AllBlocks.java`
- [Content Items](https://github.com/zurrtum/create-fly/blob/26.3/src/main/java/com/zurrtum/create/AllItems.java): `src/main/java/com/zurrtum/create/AllItems.java`
- [Create Registries](https://github.com/zurrtum/create-fly/blob/26.3/src/main/java/com/zurrtum/create/api/registry/CreateRegistries.java): `src/main/java/com/zurrtum/create/api/registry/CreateRegistries.java`

### Kinetics and Contraptions

- [Steam Engine](https://github.com/zurrtum/create-fly/blob/26.3/src/main/java/com/zurrtum/create/content/kinetics/steamEngine/SteamEngineBlock.java): `src/main/java/com/zurrtum/create/content/kinetics/steamEngine/SteamEngineBlock.java`
- [Engine Behavior](https://github.com/zurrtum/create-fly/blob/26.3/src/main/java/com/zurrtum/create/content/kinetics/steamEngine/SteamEngineBlockEntity.java): `src/main/java/com/zurrtum/create/content/kinetics/steamEngine/SteamEngineBlockEntity.java`
- [Contraption Assembly](https://github.com/zurrtum/create-fly/blob/26.3/src/main/java/com/zurrtum/create/content/contraptions/Contraption.java): `src/main/java/com/zurrtum/create/content/contraptions/Contraption.java`
- [Portable Interface](https://github.com/zurrtum/create-fly/blob/26.3/src/main/java/com/zurrtum/create/content/contraptions/actors/psi/PortableStorageInterfaceBlockEntity.java): `src/main/java/com/zurrtum/create/content/contraptions/actors/psi/PortableStorageInterfaceBlockEntity.java`
- [Railway Manager](https://github.com/zurrtum/create-fly/blob/26.3/src/main/java/com/zurrtum/create/content/trains/GlobalRailwayManager.java): `src/main/java/com/zurrtum/create/content/trains/GlobalRailwayManager.java`

### Mounted Storage

- [Mounted Storage Manager](https://github.com/zurrtum/create-fly/blob/26.3/src/main/java/com/zurrtum/create/content/contraptions/MountedStorageManager.java): `src/main/java/com/zurrtum/create/content/contraptions/MountedStorageManager.java`
- [Mounted Item Storage](https://github.com/zurrtum/create-fly/blob/26.3/src/main/java/com/zurrtum/create/api/contraption/storage/item/MountedItemStorage.java): `src/main/java/com/zurrtum/create/api/contraption/storage/item/MountedItemStorage.java`
- [Storage Types](https://github.com/zurrtum/create-fly/blob/26.3/src/main/java/com/zurrtum/create/AllMountedStorageTypes.java): `src/main/java/com/zurrtum/create/AllMountedStorageTypes.java`
- [Storage Sync Packet](https://github.com/zurrtum/create-fly/blob/26.3/src/main/java/com/zurrtum/create/infrastructure/packet/s2c/MountedStorageSyncPacket.java): `src/main/java/com/zurrtum/create/infrastructure/packet/s2c/MountedStorageSyncPacket.java`

### Client Rendering

- [Client Setup](https://github.com/zurrtum/create-fly/blob/26.3/src/client/java/com/zurrtum/create/client/Create.java): `src/client/java/com/zurrtum/create/client/Create.java`
- [Partial Models](https://github.com/zurrtum/create-fly/blob/26.3/src/client/java/com/zurrtum/create/client/AllPartialModels.java): `src/client/java/com/zurrtum/create/client/AllPartialModels.java`
- [Render Pipelines](https://github.com/zurrtum/create-fly/blob/26.3/src/client/java/com/zurrtum/create/client/foundation/render/AllRenderPipelines.java): `src/client/java/com/zurrtum/create/client/foundation/render/AllRenderPipelines.java`
- [Cached Buffers](https://github.com/zurrtum/create-fly/blob/26.3/src/client/java/com/zurrtum/create/client/catnip/render/CachedBuffers.java): `src/client/java/com/zurrtum/create/client/catnip/render/CachedBuffers.java`
- [Flywheel Engine](https://github.com/zurrtum/create-fly/blob/26.3/src/client/java/com/zurrtum/create/client/flywheel/backend/engine/EngineImpl.java): `src/client/java/com/zurrtum/create/client/flywheel/backend/engine/EngineImpl.java`
- [Shader Compiler](https://github.com/zurrtum/create-fly/blob/26.3/src/client/java/com/zurrtum/create/client/flywheel/backend/compile/PipelineCompiler.java): `src/client/java/com/zurrtum/create/client/flywheel/backend/compile/PipelineCompiler.java`
- [Light Storage](https://github.com/zurrtum/create-fly/blob/26.3/src/client/java/com/zurrtum/create/client/flywheel/backend/engine/LightStorage.java): `src/client/java/com/zurrtum/create/client/flywheel/backend/engine/LightStorage.java`

### Mod Integrations

- [Recipe Viewer Compatibility](https://github.com/zurrtum/create-fly/blob/26.3/src/client/java/com/zurrtum/create/client/compat/jei/JeiClientPlugin.java): `src/client/java/com/zurrtum/create/client/compat/jei/JeiClientPlugin.java`

### Other components

- **Minecraft Player**

## Connections

- Minecraft Player → Content Blocks: places blocks
- Mod Initialization → Content Blocks: registers content (evidence: `src/main/java/com/zurrtum/create/Create.java`)
- Mod Initialization → Content Items: registers content (evidence: `src/main/java/com/zurrtum/create/Create.java`)
- Mod Initialization → Create Registries: initializes registries (evidence: `src/main/java/com/zurrtum/create/Create.java`)
- Content Blocks → Steam Engine: includes engine block (evidence: `src/main/java/com/zurrtum/create/AllBlocks.java`)
- Steam Engine → Engine Behavior: uses block entity (evidence: `src/main/java/com/zurrtum/create/content/kinetics/steamEngine/SteamEngineBlock.java`)
- Contraption Assembly → Mounted Storage Manager: reads storage (evidence: `src/main/java/com/zurrtum/create/content/contraptions/Contraption.java`)
- Mounted Storage Manager → Mounted Item Storage: mounts storage (evidence: `src/main/java/com/zurrtum/create/content/contraptions/MountedStorageManager.java`)
- Mounted Storage Manager → Storage Types: looks up types (evidence: `src/main/java/com/zurrtum/create/content/contraptions/MountedStorageManager.java`)
- Mounted Storage Manager → Storage Sync Packet: sends updates (evidence: `src/main/java/com/zurrtum/create/content/contraptions/MountedStorageManager.java`)
- Mod Initialization → Client Setup: separates client setup
- Client Setup → Partial Models: registers models
- Client Setup → Render Pipelines: registers rendering (evidence: `src/client/java/com/zurrtum/create/client/foundation/render/AllRenderPipelines.java`)
- Render Pipelines → Cached Buffers: uses buffers
- Flywheel Engine → Shader Compiler: compiles pipelines
- Light Storage → Flywheel Engine: feeds visualization (evidence: `src/client/java/com/zurrtum/create/client/flywheel/backend/engine/LightStorage.java`)
- Recipe Viewer Compatibility → Minecraft Player: shows recipes
