# kichu-bot/zephyr-hauler architecture

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

- Interactive diagram: https://gitdiagram.com/kichu-bot/zephyr-hauler
- Repository: https://github.com/kichu-bot/zephyr-hauler

## Overview

Zephyr Hauler is a Minecraft mod for transporting captured inventories by customizable hot-air balloons. Players configure destinations through docks, hubs, and a controller; launched haulers carry cargo through weather- and weight-sensitive flight, then deliver it at a dock. The tree and README identify additional maintenance, automated-station, launcher, wind-reading, and upgrade features. Sampled code confirms key entity, dock, hub, controller, component, and network paths; some peripheral feature links are documented or implied but not verified in excerpts.

Main entry points: [`src/main/java/com/zephyrhauler/entity/ZephyrHaulerEntity.java`](https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/entity/ZephyrHaulerEntity.java) (Balloon flight), [`src/main/java/com/zephyrhauler/item/ZephyrHaulerItem.java`](https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/item/ZephyrHaulerItem.java) (Hauler item), [`src/main/java/com/zephyrhauler/client/gui/screen/ZephyrControllerScreen.java`](https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/client/gui/screen/ZephyrControllerScreen.java) (Fleet controls), [`src/main/java/com/zephyrhauler/item/ZephyrControllerItem.java`](https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/item/ZephyrControllerItem.java) (Controller item)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_logistics["Flight logistics"]
  node_hauler_item["Hauler item"]
  node_hauler_entity["Balloon flight"]
  node_data_components["Hauler data"]
end

subgraph group_infrastructure["Docks and stations"]
  node_dock["Zephyr dock"]
  node_dock_state["Dock state"]
  node_hub["Zephyr hub"]
  node_hub_state["Hub network"]
  node_maintenance["Maintenance station"]
  node_auto_station["Auto station"]
end

subgraph group_control["Fleet control"]
  node_controller["Controller item"]
  node_controller_menu["Controller menu"]
  node_network["Network handlers<br/>[ModNetwork.java]"]
  node_dock_entry["Saved destinations<br/>[DockEntry.java]"]
  node_mod_init["Mod registration<br/>[ZephyrHauler.java]"]
end

subgraph group_features["Flight extensions"]
  node_wind_system["Wind model"]
  node_wind_sensor["Wind sensor"]
  node_launcher["Launcher"]
  node_recipes["Hauler upgrades"]
end

subgraph group_presentation["Player interface"]
  node_controller_screen["Fleet controls"]
  node_client_setup["Client setup"]
end

node_player(("Player"))
node_minecraft(("Minecraft world"))

node_player -.->|"uses"| node_hauler_item
node_hauler_item -->|"spawns"| node_hauler_entity
node_hauler_entity -->|"checks destination"| node_dock_state
node_dock_state -->|"spawns delivery"| node_hauler_entity
node_hauler_entity -->|"checks link"| node_hub_state
node_dock -->|"rescans nearby"| node_hub_state
node_hub -->|"reports network"| node_hub_state
node_player -.->|"manages fleet"| node_controller_screen
node_controller_screen -->|"sends actions"| node_network
node_network -->|"dispatches actions"| node_controller
node_controller -->|"stores destinations"| node_dock_entry
node_controller_screen -->|"uses menu"| node_controller_menu
node_controller_menu -->|"accepts item"| node_controller
node_hauler_entity -->|"reads flight data"| node_data_components
node_hauler_entity -->|"calculates wind"| node_wind_system
node_wind_sensor -->|"reads currents"| node_wind_system
node_maintenance -.->|"repairs"| node_hauler_item
node_auto_station -.->|"handles haulers"| node_hauler_item
node_launcher -.->|"launches"| node_hauler_entity
node_recipes -->|"sets upgrades"| node_data_components
node_mod_init -->|"registers"| node_data_components
node_mod_init -->|"registers"| node_hauler_item
node_client_setup -->|"registers screen"| node_controller_screen
node_hauler_entity -.->|"travels in"| node_minecraft

click node_hauler_item "https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/item/ZephyrHaulerItem.java"
click node_hauler_entity "https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/entity/ZephyrHaulerEntity.java"
click node_dock "https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/block/ZephyrDockBlock.java"
click node_dock_state "https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/block/entity/ZephyrDockBlockEntity.java"
click node_hub "https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/block/ZephyrHubBlock.java"
click node_hub_state "https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/block/entity/ZephyrHubBlockEntity.java"
click node_maintenance "https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/block/entity/ZephyrStationBlockEntity.java"
click node_auto_station "https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/block/entity/ZephyrAutoStationBlockEntity.java"
click node_controller "https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/item/ZephyrControllerItem.java"
click node_controller_menu "https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/menu/ZephyrControllerMenu.java"
click node_controller_screen "https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/client/gui/screen/ZephyrControllerScreen.java"
click node_network "https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/registry/ModNetwork.java"
click node_dock_entry "https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/component/DockEntry.java"
click node_data_components "https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/component/ZephyrDataComponents.java"
click node_wind_system "https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/util/ZephyrWindSystem.java"
click node_wind_sensor "https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/block/entity/WindSensorBlockEntity.java"
click node_launcher "https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/block/entity/ZephyrLauncherBlockEntity.java"
click node_recipes "https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/recipe/ZephyrHaulerUpgradeRecipe.java"
click node_client_setup "https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/client/ClientModEvents.java"
click node_mod_init "https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/ZephyrHauler.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_hauler_item,node_hauler_entity,node_data_components toneBlue
class node_dock,node_dock_state,node_hub,node_hub_state,node_maintenance,node_auto_station toneAmber
class node_controller,node_controller_menu,node_network,node_dock_entry,node_mod_init toneMint
class node_wind_system,node_wind_sensor,node_launcher,node_recipes toneRose
class node_controller_screen,node_client_setup,node_player,node_minecraft toneIndigo
```

## Components

### Flight logistics

- [Hauler item](https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/item/ZephyrHaulerItem.java): `src/main/java/com/zephyrhauler/item/ZephyrHaulerItem.java`
- [Balloon flight](https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/entity/ZephyrHaulerEntity.java): `src/main/java/com/zephyrhauler/entity/ZephyrHaulerEntity.java`
- [Hauler data](https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/component/ZephyrDataComponents.java): `src/main/java/com/zephyrhauler/component/ZephyrDataComponents.java`

### Docks and stations

- [Zephyr dock](https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/block/ZephyrDockBlock.java): `src/main/java/com/zephyrhauler/block/ZephyrDockBlock.java`
- [Dock state](https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/block/entity/ZephyrDockBlockEntity.java): `src/main/java/com/zephyrhauler/block/entity/ZephyrDockBlockEntity.java`
- [Zephyr hub](https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/block/ZephyrHubBlock.java): `src/main/java/com/zephyrhauler/block/ZephyrHubBlock.java`
- [Hub network](https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/block/entity/ZephyrHubBlockEntity.java): `src/main/java/com/zephyrhauler/block/entity/ZephyrHubBlockEntity.java`
- [Maintenance station](https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/block/entity/ZephyrStationBlockEntity.java): `src/main/java/com/zephyrhauler/block/entity/ZephyrStationBlockEntity.java`
- [Auto station](https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/block/entity/ZephyrAutoStationBlockEntity.java): `src/main/java/com/zephyrhauler/block/entity/ZephyrAutoStationBlockEntity.java`

### Fleet control

- [Controller item](https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/item/ZephyrControllerItem.java): `src/main/java/com/zephyrhauler/item/ZephyrControllerItem.java`
- [Controller menu](https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/menu/ZephyrControllerMenu.java): `src/main/java/com/zephyrhauler/menu/ZephyrControllerMenu.java`
- [Network handlers](https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/registry/ModNetwork.java): `src/main/java/com/zephyrhauler/registry/ModNetwork.java`
- [Saved destinations](https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/component/DockEntry.java): `src/main/java/com/zephyrhauler/component/DockEntry.java`
- [Mod registration](https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/ZephyrHauler.java): `src/main/java/com/zephyrhauler/ZephyrHauler.java`

### Flight extensions

- [Wind model](https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/util/ZephyrWindSystem.java): `src/main/java/com/zephyrhauler/util/ZephyrWindSystem.java`
- [Wind sensor](https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/block/entity/WindSensorBlockEntity.java): `src/main/java/com/zephyrhauler/block/entity/WindSensorBlockEntity.java`
- [Launcher](https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/block/entity/ZephyrLauncherBlockEntity.java): `src/main/java/com/zephyrhauler/block/entity/ZephyrLauncherBlockEntity.java`
- [Hauler upgrades](https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/recipe/ZephyrHaulerUpgradeRecipe.java): `src/main/java/com/zephyrhauler/recipe/ZephyrHaulerUpgradeRecipe.java`

### Player interface

- [Fleet controls](https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/client/gui/screen/ZephyrControllerScreen.java): `src/main/java/com/zephyrhauler/client/gui/screen/ZephyrControllerScreen.java`
- [Client setup](https://github.com/kichu-bot/zephyr-hauler/blob/main/src/main/java/com/zephyrhauler/client/ClientModEvents.java): `src/main/java/com/zephyrhauler/client/ClientModEvents.java`

### Other components

- **Player**
- **Minecraft world**

## Connections

- Player → Hauler item: uses (evidence: `README.md`)
- Hauler item → Balloon flight: spawns (evidence: `src/main/java/com/zephyrhauler/item/ZephyrHaulerItem.java`)
- Balloon flight → Dock state: checks destination (evidence: `src/main/java/com/zephyrhauler/entity/ZephyrHaulerEntity.java`)
- Dock state → Balloon flight: spawns delivery (evidence: `src/main/java/com/zephyrhauler/block/entity/ZephyrDockBlockEntity.java`)
- Balloon flight → Hub network: checks link (evidence: `src/main/java/com/zephyrhauler/entity/ZephyrHaulerEntity.java`)
- Zephyr dock → Hub network: rescans nearby (evidence: `src/main/java/com/zephyrhauler/block/ZephyrDockBlock.java`)
- Zephyr hub → Hub network: reports network (evidence: `src/main/java/com/zephyrhauler/block/ZephyrHubBlock.java`)
- Player → Fleet controls: manages fleet (evidence: `src/main/java/com/zephyrhauler/client/gui/screen/ZephyrControllerScreen.java`)
- Fleet controls → Network handlers: sends actions (evidence: `src/main/java/com/zephyrhauler/client/gui/screen/ZephyrControllerScreen.java`)
- Network handlers → Controller item: dispatches actions (evidence: `src/main/java/com/zephyrhauler/registry/ModNetwork.java`)
- Controller item → Saved destinations: stores destinations (evidence: `src/main/java/com/zephyrhauler/item/ZephyrControllerItem.java`)
- Fleet controls → Controller menu: uses menu (evidence: `src/main/java/com/zephyrhauler/client/gui/screen/ZephyrControllerScreen.java`)
- Controller menu → Controller item: accepts item (evidence: `src/main/java/com/zephyrhauler/menu/ZephyrControllerMenu.java`)
- Balloon flight → Hauler data: reads flight data (evidence: `src/main/java/com/zephyrhauler/entity/ZephyrHaulerEntity.java`)
- Balloon flight → Wind model: calculates wind (evidence: `src/main/java/com/zephyrhauler/entity/ZephyrHaulerEntity.java`)
- Wind sensor → Wind model: reads currents (evidence: `src/main/java/com/zephyrhauler/block/entity/WindSensorBlockEntity.java`)
- Maintenance station → Hauler item: repairs (evidence: `README.md`)
- Auto station → Hauler item: handles haulers (evidence: `src/main/java/com/zephyrhauler/block/entity/ZephyrAutoStationBlockEntity.java`)
- Launcher → Balloon flight: launches
- Hauler upgrades → Hauler data: sets upgrades (evidence: `src/main/java/com/zephyrhauler/recipe/ZephyrHaulerUpgradeRecipe.java`)
- Mod registration → Hauler data: registers (evidence: `src/main/java/com/zephyrhauler/ZephyrHauler.java`)
- Mod registration → Hauler item: registers (evidence: `src/main/java/com/zephyrhauler/ZephyrHauler.java`)
- Client setup → Fleet controls: registers screen (evidence: `src/main/java/com/zephyrhauler/client/ClientModEvents.java`)
- Balloon flight → Minecraft world: travels in (evidence: `README.md`)
