# creators-of-aeronautics/simulated-project architecture

> Architecture diagram of the GitHub repository creators-of-aeronautics/simulated-project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/creators-of-aeronautics/simulated-project
- Repository: https://github.com/creators-of-aeronautics/simulated-project

## Overview

This repository is a suite of Minecraft mods extending Create with physics-based contraptions. The main player-facing journey is to assemble and control simulated contraptions, then equip them for flight with Aeronautics or land travel with Offroad. The tree also shows supporting engine, inventory, display, and crystallization systems. README descriptions establish the broad product capabilities; sampled source confirms selected runtime details, but does not establish the wiring among most feature subsystems.

Main entry points: [`aeronautics/common/src/main/java/dev/eriksonn/aeronautics/Aeronautics.java`](https://github.com/creators-of-aeronautics/simulated-project/blob/main/aeronautics/common/src/main/java/dev/eriksonn/aeronautics/Aeronautics.java) (Aeronautics Mod), [`simulated/common/src/main/java/dev/simulated_team/simulated/content/blocks/portable_engine/PortableEngineBlockEntity.java`](https://github.com/creators-of-aeronautics/simulated-project/blob/main/simulated/common/src/main/java/dev/simulated_team/simulated/content/blocks/portable_engine/PortableEngineBlockEntity.java) (Portable Engine), [`simulated/common/src/main/java/dev/simulated_team/simulated`](https://github.com/creators-of-aeronautics/simulated-project/tree/main/simulated/common/src/main/java/dev/simulated_team/simulated) (Contraption Assembly), [`aeronautics/common/src/main/java/dev/eriksonn/aeronautics/content/blocks/levitite`](https://github.com/creators-of-aeronautics/simulated-project/tree/main/aeronautics/common/src/main/java/dev/eriksonn/aeronautics/content/blocks/levitite) (Levitite Systems)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_simulated["Simulated Core"]
  node_assembly["Contraption Assembly"]
  node_controls["Redstone Components"]
  node_portable_engine["Portable Engine"]
  node_engine_display["Engine Display"]
end

subgraph group_aero["Aeronautics Flight"]
  node_aero_runtime["Aeronautics Mod<br/>[Aeronautics.java]"]
  node_hot_air["Hot-Air Flight"]
  node_propellers["Propeller Flight"]
  node_levitite["Levitite Systems"]
  node_crystallization["Crystallization API"]
  node_levitite_service["Levitite Service"]
end

subgraph group_offroad["Offroad Vehicles"]
  node_offroad_runtime["Offroad Mod<br/>[Offroad.java]"]
  node_wheels["Land Vehicle Parts"]
  node_mounted_storage["Mounted Storage"]
  node_neoforge_storage["NeoForge Storage"]
end

subgraph group_support["Runtime Support"]
  node_inventory_service["Inventory Service"]
  node_peripheral_service["Peripheral Service"]
end

node_player(("Player"))
node_game["Minecraft / Create"]
node_computer["ComputerCraft"]

node_player -->|"assembles"| node_assembly
node_assembly -->|"uses controls"| node_controls
node_player -->|"adds flight"| node_aero_runtime
node_aero_runtime -->|"provides"| node_hot_air
node_aero_runtime -->|"provides"| node_propellers
node_aero_runtime -->|"provides"| node_levitite
node_levitite -->|"supports growth"| node_crystallization
node_levitite_service -->|"supplies fluid and item"| node_game
node_player -->|"adds land travel"| node_offroad_runtime
node_offroad_runtime -->|"provides parts"| node_wheels
node_wheels -->|"uses storage"| node_mounted_storage
node_mounted_storage -->|"loads platform service"| node_neoforge_storage
node_player -->|"operates"| node_portable_engine
node_portable_engine -->|"reads fuel inventory"| node_inventory_service
node_engine_display -->|"reads burn data"| node_portable_engine
node_portable_engine -->|"generates kinetic power"| node_game
node_peripheral_service -.->|"registers peripherals"| node_computer
node_assembly -->|"integrates with"| node_game

click node_assembly "https://github.com/creators-of-aeronautics/simulated-project/tree/main/simulated/common/src/main/java/dev/simulated_team/simulated"
click node_controls "https://github.com/creators-of-aeronautics/simulated-project/tree/main/simulated/common/src/main/java/dev/simulated_team/simulated"
click node_portable_engine "https://github.com/creators-of-aeronautics/simulated-project/blob/main/simulated/common/src/main/java/dev/simulated_team/simulated/content/blocks/portable_engine/PortableEngineBlockEntity.java"
click node_engine_display "https://github.com/creators-of-aeronautics/simulated-project/blob/main/simulated/common/src/main/java/dev/simulated_team/simulated/content/display_sources/PortableEngineDisplaySource.java"
click node_inventory_service "https://github.com/creators-of-aeronautics/simulated-project/blob/main/simulated/common/src/main/java/dev/simulated_team/simulated/service/SimInventoryService.java"
click node_peripheral_service "https://github.com/creators-of-aeronautics/simulated-project/blob/main/simulated/common/src/main/java/dev/simulated_team/simulated/service/compat/SimPeripheralService.java"
click node_aero_runtime "https://github.com/creators-of-aeronautics/simulated-project/blob/main/aeronautics/common/src/main/java/dev/eriksonn/aeronautics/Aeronautics.java"
click node_hot_air "https://github.com/creators-of-aeronautics/simulated-project/tree/main/aeronautics/common/src/main/java/dev/eriksonn/aeronautics/content/blocks/hot_air"
click node_propellers "https://github.com/creators-of-aeronautics/simulated-project/tree/main/aeronautics/common/src/main/java/dev/eriksonn/aeronautics/content/blocks/propeller"
click node_levitite "https://github.com/creators-of-aeronautics/simulated-project/tree/main/aeronautics/common/src/main/java/dev/eriksonn/aeronautics/content/blocks/levitite"
click node_crystallization "https://github.com/creators-of-aeronautics/simulated-project/blob/main/aeronautics/common/src/main/java/dev/eriksonn/aeronautics/api/levitite_blend_crystallization/LevititeCrystallizerManager.java"
click node_levitite_service "https://github.com/creators-of-aeronautics/simulated-project/blob/main/aeronautics/common/src/main/java/dev/eriksonn/aeronautics/service/AeroLevititeService.java"
click node_offroad_runtime "https://github.com/creators-of-aeronautics/simulated-project/blob/main/offroad/common/src/main/java/dev/ryanhcode/offroad/Offroad.java"
click node_wheels "https://github.com/creators-of-aeronautics/simulated-project/tree/main/offroad/common/src/main/java/dev/ryanhcode/offroad"
click node_mounted_storage "https://github.com/creators-of-aeronautics/simulated-project/blob/main/offroad/common/src/main/java/dev/ryanhcode/offroad/service/OffroadMountedStorageService.java"
click node_neoforge_storage "https://github.com/creators-of-aeronautics/simulated-project/blob/main/offroad/neoforge/src/main/java/dev/ryanhcode/offroad/neoforge/service/NeoForgeOffroadMountedStorageService.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_assembly,node_controls,node_portable_engine,node_engine_display toneBlue
class node_aero_runtime,node_hot_air,node_propellers,node_levitite,node_crystallization,node_levitite_service toneAmber
class node_offroad_runtime,node_wheels,node_mounted_storage,node_neoforge_storage toneMint
class node_inventory_service,node_peripheral_service toneRose
class node_player,node_game,node_computer toneIndigo
```

## Components

### Simulated Core

- [Contraption Assembly](https://github.com/creators-of-aeronautics/simulated-project/tree/main/simulated/common/src/main/java/dev/simulated_team/simulated): `simulated/common/src/main/java/dev/simulated_team/simulated`
- [Redstone Components](https://github.com/creators-of-aeronautics/simulated-project/tree/main/simulated/common/src/main/java/dev/simulated_team/simulated): `simulated/common/src/main/java/dev/simulated_team/simulated`
- [Portable Engine](https://github.com/creators-of-aeronautics/simulated-project/blob/main/simulated/common/src/main/java/dev/simulated_team/simulated/content/blocks/portable_engine/PortableEngineBlockEntity.java): `simulated/common/src/main/java/dev/simulated_team/simulated/content/blocks/portable_engine/PortableEngineBlockEntity.java`
- [Engine Display](https://github.com/creators-of-aeronautics/simulated-project/blob/main/simulated/common/src/main/java/dev/simulated_team/simulated/content/display_sources/PortableEngineDisplaySource.java): `simulated/common/src/main/java/dev/simulated_team/simulated/content/display_sources/PortableEngineDisplaySource.java`

### Aeronautics Flight

- [Aeronautics Mod](https://github.com/creators-of-aeronautics/simulated-project/blob/main/aeronautics/common/src/main/java/dev/eriksonn/aeronautics/Aeronautics.java): `aeronautics/common/src/main/java/dev/eriksonn/aeronautics/Aeronautics.java`
- [Hot-Air Flight](https://github.com/creators-of-aeronautics/simulated-project/tree/main/aeronautics/common/src/main/java/dev/eriksonn/aeronautics/content/blocks/hot_air): `aeronautics/common/src/main/java/dev/eriksonn/aeronautics/content/blocks/hot_air`
- [Propeller Flight](https://github.com/creators-of-aeronautics/simulated-project/tree/main/aeronautics/common/src/main/java/dev/eriksonn/aeronautics/content/blocks/propeller): `aeronautics/common/src/main/java/dev/eriksonn/aeronautics/content/blocks/propeller`
- [Levitite Systems](https://github.com/creators-of-aeronautics/simulated-project/tree/main/aeronautics/common/src/main/java/dev/eriksonn/aeronautics/content/blocks/levitite): `aeronautics/common/src/main/java/dev/eriksonn/aeronautics/content/blocks/levitite`
- [Crystallization API](https://github.com/creators-of-aeronautics/simulated-project/blob/main/aeronautics/common/src/main/java/dev/eriksonn/aeronautics/api/levitite_blend_crystallization/LevititeCrystallizerManager.java): `aeronautics/common/src/main/java/dev/eriksonn/aeronautics/api/levitite_blend_crystallization/LevititeCrystallizerManager.java`
- [Levitite Service](https://github.com/creators-of-aeronautics/simulated-project/blob/main/aeronautics/common/src/main/java/dev/eriksonn/aeronautics/service/AeroLevititeService.java): `aeronautics/common/src/main/java/dev/eriksonn/aeronautics/service/AeroLevititeService.java`

### Offroad Vehicles

- [Offroad Mod](https://github.com/creators-of-aeronautics/simulated-project/blob/main/offroad/common/src/main/java/dev/ryanhcode/offroad/Offroad.java): `offroad/common/src/main/java/dev/ryanhcode/offroad/Offroad.java`
- [Land Vehicle Parts](https://github.com/creators-of-aeronautics/simulated-project/tree/main/offroad/common/src/main/java/dev/ryanhcode/offroad): `offroad/common/src/main/java/dev/ryanhcode/offroad`
- [Mounted Storage](https://github.com/creators-of-aeronautics/simulated-project/blob/main/offroad/common/src/main/java/dev/ryanhcode/offroad/service/OffroadMountedStorageService.java): `offroad/common/src/main/java/dev/ryanhcode/offroad/service/OffroadMountedStorageService.java`
- [NeoForge Storage](https://github.com/creators-of-aeronautics/simulated-project/blob/main/offroad/neoforge/src/main/java/dev/ryanhcode/offroad/neoforge/service/NeoForgeOffroadMountedStorageService.java): `offroad/neoforge/src/main/java/dev/ryanhcode/offroad/neoforge/service/NeoForgeOffroadMountedStorageService.java`

### Runtime Support

- [Inventory Service](https://github.com/creators-of-aeronautics/simulated-project/blob/main/simulated/common/src/main/java/dev/simulated_team/simulated/service/SimInventoryService.java): `simulated/common/src/main/java/dev/simulated_team/simulated/service/SimInventoryService.java`
- [Peripheral Service](https://github.com/creators-of-aeronautics/simulated-project/blob/main/simulated/common/src/main/java/dev/simulated_team/simulated/service/compat/SimPeripheralService.java): `simulated/common/src/main/java/dev/simulated_team/simulated/service/compat/SimPeripheralService.java`

### Other components

- **Player**
- **Minecraft / Create**
- **ComputerCraft**

## Connections

- Player → Contraption Assembly: assembles
- Contraption Assembly → Redstone Components: uses controls
- Player → Aeronautics Mod: adds flight
- Aeronautics Mod → Hot-Air Flight: provides
- Aeronautics Mod → Propeller Flight: provides
- Aeronautics Mod → Levitite Systems: provides
- Levitite Systems → Crystallization API: supports growth
- Levitite Service → Minecraft / Create: supplies fluid and item
- Player → Offroad Mod: adds land travel
- Offroad Mod → Land Vehicle Parts: provides parts
- Land Vehicle Parts → Mounted Storage: uses storage
- Mounted Storage → NeoForge Storage: loads platform service
- Player → Portable Engine: operates
- Portable Engine → Inventory Service: reads fuel inventory
- Engine Display → Portable Engine: reads burn data
- Portable Engine → Minecraft / Create: generates kinetic power
- Peripheral Service → ComputerCraft: registers peripherals
- Contraption Assembly → Minecraft / Create: integrates with