# gtnewhorizons/applied-energistics-2-unofficial architecture

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

- Interactive diagram: https://gitdiagram.com/gtnewhorizons/applied-energistics-2-unofficial
- Repository: https://github.com/gtnewhorizons/applied-energistics-2-unofficial

## Overview

Applied Energistics 2 Unofficial is a Minecraft mod for managing matter, energy, and automation through in-world networked systems. A representative storage workflow exposes a storage bus as a networked inventory; the storage-reshuffle tile accesses network storage to scan or start a reshuffle, with a GUI for configuration and results. The tree also shows crafting, power, spatial storage, and compass subsystems. Several of these are represented by their source directories because their implementation was not sampled; their internal links are therefore left unasserted.

Main entry points: [`src/main/java/appeng/tile/misc/TileStorageReshuffle.java`](https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/tile/misc/TileStorageReshuffle.java) (Reshuffle Tile), [`src/main/java/appeng/parts/misc/PartStorageBus.java`](https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/parts/misc/PartStorageBus.java) (Storage Bus), [`src/main/java/appeng/client/gui/implementations/GuiStorageReshuffle.java`](https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/client/gui/implementations/GuiStorageReshuffle.java) (Reshuffle GUI), [`src/main/java/appeng/spatial/StorageHelper.java`](https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/spatial/StorageHelper.java) (Spatial Transfer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storage["Network Storage"]
  node_storagebus["Storage Bus"]
  node_storagegrid["Storage Grid"]
  node_reshuffle["Reshuffle Tile"]
  node_reshufflegui["Reshuffle GUI"]
  node_storagecontainer["Bus Container"]
end

subgraph group_crafting["Crafting"]
  node_crafting["Crafting Machines"]
  node_craftingtile["Crafting Storage Tile"]
end

subgraph group_spatial["Spatial Systems"]
  node_spatialcell["Spatial Cell"]
  node_spatialhelper["Spatial Transfer<br/>[StorageHelper.java]"]
  node_spatialworld["Spatial World"]
  node_compass["Compass Service"]
end

subgraph group_api["API And Core"]
  node_stacktypes["Stack Types<br/>[IAEStackType.java]"]
  node_itemstacks["Item Stacks<br/>[IAEItemStack.java]"]
  node_itemlist["Stack Lists<br/>[IItemList.java]"]
  node_inventoryapi["Inventory API<br/>[IMEInventory.java]"]
  node_gridapi["Grid API<br/>[IGrid.java]"]
  node_apientry["API Entry<br/>[AEApi.java]"]
  node_energy["Power Network"]
end

node_user(("Player"))

node_storagebus -->|"posts updates"| node_storagegrid
node_reshuffle -->|"reads grid"| node_storagegrid
node_reshuffle -->|"gets monitors"| node_inventoryapi
node_storagecontainer -.->|"configures bus"| node_storagebus
node_user -.->|"configures"| node_reshufflegui
node_reshufflegui -.->|"controls"| node_reshuffle
node_spatialcell -->|"uses transfer"| node_spatialhelper
node_spatialhelper -->|"uses provider"| node_spatialworld
node_apientry -.->|"exposes APIs"| node_gridapi
node_stacktypes -->|"creates lists"| node_itemlist
node_craftingtile -.->|"supports"| node_crafting

click node_storagebus "https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/parts/misc/PartStorageBus.java"
click node_storagegrid "https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/me/cache/GridStorageCache.java"
click node_reshuffle "https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/tile/misc/TileStorageReshuffle.java"
click node_reshufflegui "https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/client/gui/implementations/GuiStorageReshuffle.java"
click node_storagecontainer "https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/container/implementations/ContainerStorageBus.java"
click node_stacktypes "https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/api/storage/data/IAEStackType.java"
click node_itemstacks "https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/api/storage/data/IAEItemStack.java"
click node_itemlist "https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/api/storage/data/IItemList.java"
click node_inventoryapi "https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/api/storage/IMEInventory.java"
click node_gridapi "https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/api/networking/IGrid.java"
click node_apientry "https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/api/AEApi.java"
click node_crafting "https://github.com/gtnewhorizons/applied-energistics-2-unofficial/tree/master/src/main/java/appeng/block/crafting"
click node_craftingtile "https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/tile/crafting/TileCraftingStorageTile.java"
click node_energy "https://github.com/gtnewhorizons/applied-energistics-2-unofficial/tree/master/src/main/java/appeng/api/networking/energy"
click node_spatialcell "https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/items/storage/ItemSpatialStorageCell.java"
click node_spatialhelper "https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/spatial/StorageHelper.java"
click node_spatialworld "https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/spatial/StorageWorldProvider.java"
click node_compass "https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/services/CompassService.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_storagebus,node_storagegrid,node_reshuffle,node_reshufflegui,node_storagecontainer toneBlue
class node_crafting,node_craftingtile toneAmber
class node_spatialcell,node_spatialhelper,node_spatialworld,node_compass toneMint
class node_stacktypes,node_itemstacks,node_itemlist,node_inventoryapi,node_gridapi,node_apientry,node_energy toneRose
class node_user toneIndigo
```

## Components

### Network Storage

- [Storage Bus](https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/parts/misc/PartStorageBus.java): `src/main/java/appeng/parts/misc/PartStorageBus.java`
- [Storage Grid](https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/me/cache/GridStorageCache.java): `src/main/java/appeng/me/cache/GridStorageCache.java`
- [Reshuffle Tile](https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/tile/misc/TileStorageReshuffle.java): `src/main/java/appeng/tile/misc/TileStorageReshuffle.java`
- [Reshuffle GUI](https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/client/gui/implementations/GuiStorageReshuffle.java): `src/main/java/appeng/client/gui/implementations/GuiStorageReshuffle.java`
- [Bus Container](https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/container/implementations/ContainerStorageBus.java): `src/main/java/appeng/container/implementations/ContainerStorageBus.java`

### Crafting

- [Crafting Machines](https://github.com/gtnewhorizons/applied-energistics-2-unofficial/tree/master/src/main/java/appeng/block/crafting): `src/main/java/appeng/block/crafting`
- [Crafting Storage Tile](https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/tile/crafting/TileCraftingStorageTile.java): `src/main/java/appeng/tile/crafting/TileCraftingStorageTile.java`

### Spatial Systems

- [Spatial Cell](https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/items/storage/ItemSpatialStorageCell.java): `src/main/java/appeng/items/storage/ItemSpatialStorageCell.java`
- [Spatial Transfer](https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/spatial/StorageHelper.java): `src/main/java/appeng/spatial/StorageHelper.java`
- [Spatial World](https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/spatial/StorageWorldProvider.java): `src/main/java/appeng/spatial/StorageWorldProvider.java`
- [Compass Service](https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/services/CompassService.java): `src/main/java/appeng/services/CompassService.java`

### API And Core

- [Stack Types](https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/api/storage/data/IAEStackType.java): `src/main/java/appeng/api/storage/data/IAEStackType.java`
- [Item Stacks](https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/api/storage/data/IAEItemStack.java): `src/main/java/appeng/api/storage/data/IAEItemStack.java`
- [Stack Lists](https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/api/storage/data/IItemList.java): `src/main/java/appeng/api/storage/data/IItemList.java`
- [Inventory API](https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/api/storage/IMEInventory.java): `src/main/java/appeng/api/storage/IMEInventory.java`
- [Grid API](https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/api/networking/IGrid.java): `src/main/java/appeng/api/networking/IGrid.java`
- [API Entry](https://github.com/gtnewhorizons/applied-energistics-2-unofficial/blob/master/src/main/java/appeng/api/AEApi.java): `src/main/java/appeng/api/AEApi.java`
- [Power Network](https://github.com/gtnewhorizons/applied-energistics-2-unofficial/tree/master/src/main/java/appeng/api/networking/energy): `src/main/java/appeng/api/networking/energy`

### Other components

- **Player**

## Connections

- Storage Bus → Storage Grid: posts updates (evidence: `src/main/java/appeng/parts/misc/PartStorageBus.java`)
- Reshuffle Tile → Storage Grid: reads grid (evidence: `src/main/java/appeng/tile/misc/TileStorageReshuffle.java`)
- Reshuffle Tile → Inventory API: gets monitors (evidence: `src/main/java/appeng/tile/misc/TileStorageReshuffle.java`)
- Bus Container → Storage Bus: configures bus
- Player → Reshuffle GUI: configures
- Reshuffle GUI → Reshuffle Tile: controls (evidence: `src/main/java/appeng/client/gui/implementations/GuiStorageReshuffle.java`)
- Spatial Cell → Spatial Transfer: uses transfer (evidence: `src/main/java/appeng/items/storage/ItemSpatialStorageCell.java`)
- Spatial Transfer → Spatial World: uses provider (evidence: `src/main/java/appeng/spatial/StorageHelper.java`)
- API Entry → Grid API: exposes APIs
- Stack Types → Stack Lists: creates lists (evidence: `src/main/java/appeng/api/storage/data/IAEStackType.java`)
- Crafting Storage Tile → Crafting Machines: supports (evidence: `src/main/java/appeng/tile/crafting/TileCraftingStorageTile.java`)
