# gt-impact/impact-core architecture

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

- Interactive diagram: https://gitdiagram.com/gt-impact/impact-core
- Repository: https://github.com/gt-impact/impact-core

## Overview

IMPACT CoreMod is a Minecraft 1.7.10 mod that extends GregTech with machines, processing, energy and network systems, world features, and client interfaces. The main lifecycle begins at the mod entry point, loads configuration and registrations, and initializes proxy-specific behavior; players then interact with features through machines, events, and GUIs. The tree also shows recipe/NEI support and virtual-world integration. Relationships below are limited to calls, imports, or registrations visible in the supplied excerpts and source index; unsampled subsystems are included without speculative links.

Main entry points: [`src/main/java/com/impact/impact.java`](https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/impact.java) (Mod entry), [`src/main/java/com/impact/mods/gregtech/tileentities/basic/GTMTE_LongDistancePipelineBase.java`](https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/mods/gregtech/tileentities/basic/GTMTE_LongDistancePipelineBase.java) (Long-distance pipes), [`src/main/java/com/impact/events/TickHandler.java`](https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/events/TickHandler.java) (Tick events), [`src/main/java/com/impact/mods/gregtech/Basic_Register.java`](https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/mods/gregtech/Basic_Register.java) (Machine registration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_lifecycle["Mod lifecycle"]
  node_entry["Mod entry<br/>[impact.java]"]
  node_config["Configuration<br/>[Config.java]"]
  node_common["Common proxy<br/>[CommonProxy.java]"]
  node_loader["Registration loader<br/>[MainLoader.java]"]
  node_events["Tick events<br/>[TickHandler.java]"]
end

subgraph group_machines["GregTech systems"]
  node_machine["GregTech machines<br/>[GTMTE_MBBase.java]"]
  node_registration["Machine registration"]
  node_pipeline["Long-distance pipes"]
  node_energy["Energy transfer"]
end

subgraph group_networks["Networks and worlds"]
  node_aerostat["Aerostat state"]
  node_satellite["Satellite networks"]
  node_virtual["Virtual worlds"]
end

subgraph group_client["Client interaction"]
  node_clientproxy["Client proxy<br/>[ClientProxy.java]"]
  node_gui["GUI routing<br/>[GUIHandler.java]"]
  node_clientevents["Client events<br/>[ClientEvent.java]"]
  node_network["Packet handler"]
end

subgraph group_recipes["Recipes and discovery"]
  node_recipe["Recipe definitions"]
  node_nei["NEI recipe views"]
  node_recipebuilder["Recipe builders"]
end

node_actor(("Server or player"))

node_actor -.->|"starts mod"| node_entry
node_entry -->|"loads config"| node_config
node_entry -->|"runs lifecycle"| node_loader
node_entry -->|"calls proxy"| node_common
node_entry -->|"registers handler"| node_gui
node_entry -->|"registers events"| node_events
node_events -->|"updates state"| node_aerostat
node_registration -->|"registers machines"| node_machine
node_pipeline -.->|"specializes"| node_energy
node_pipeline -->|"uses pipe block"| node_registration
node_clientproxy -->|"registers views"| node_nei
node_clientevents -->|"sends packets"| node_network
node_gui -.->|"serves interfaces"| node_actor
node_recipe -.->|"documents recipes"| node_nei
node_recipebuilder -.->|"builds recipes"| node_recipe

click node_entry "https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/impact.java"
click node_config "https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/core/Config.java"
click node_common "https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/core/CommonProxy.java"
click node_loader "https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/loader/MainLoader.java"
click node_events "https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/events/TickHandler.java"
click node_machine "https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/mods/gregtech/tileentities/multi/implement/GTMTE_MBBase.java"
click node_registration "https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/mods/gregtech/Basic_Register.java"
click node_pipeline "https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/mods/gregtech/tileentities/basic/GTMTE_LongDistancePipelineBase.java"
click node_energy "https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/mods/gregtech/tileentities/basic/GTMTE_LongDistancePipelineEnergy.java"
click node_aerostat "https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/common/managers/AeroStateNetworkManager.kt"
click node_satellite "https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/addon/gt/api/satellite/SatelliteNetworkManager.kt"
click node_virtual "https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/addon/vw/VirtualWorldIntegration.kt"
click node_clientproxy "https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/core/ClientProxy.java"
click node_gui "https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/client/gui/GUIHandler.java"
click node_clientevents "https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/events/ClientEvent.java"
click node_network "https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/network/GTNetworkHandler.kt"
click node_nei "https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/addon/nei/impactplugin/RecipeProcessorRegister.kt"
click node_recipebuilder "https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/recipe/recipe_builder/CraftingTableBuilder.kt"

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_entry,node_config,node_common,node_loader,node_events toneBlue
class node_machine,node_registration,node_pipeline,node_energy toneAmber
class node_aerostat,node_satellite,node_virtual,node_actor toneMint
class node_clientproxy,node_gui,node_clientevents,node_network toneRose
class node_recipe,node_nei,node_recipebuilder toneIndigo
```

## Components

### Mod lifecycle

- [Mod entry](https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/impact.java): `src/main/java/com/impact/impact.java`
- [Configuration](https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/core/Config.java): `src/main/java/com/impact/core/Config.java`
- [Common proxy](https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/core/CommonProxy.java): `src/main/java/com/impact/core/CommonProxy.java`
- [Registration loader](https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/loader/MainLoader.java): `src/main/java/com/impact/loader/MainLoader.java`
- [Tick events](https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/events/TickHandler.java): `src/main/java/com/impact/events/TickHandler.java`

### GregTech systems

- [GregTech machines](https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/mods/gregtech/tileentities/multi/implement/GTMTE_MBBase.java): `src/main/java/com/impact/mods/gregtech/tileentities/multi/implement/GTMTE_MBBase.java`
- [Machine registration](https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/mods/gregtech/Basic_Register.java): `src/main/java/com/impact/mods/gregtech/Basic_Register.java`
- [Long-distance pipes](https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/mods/gregtech/tileentities/basic/GTMTE_LongDistancePipelineBase.java): `src/main/java/com/impact/mods/gregtech/tileentities/basic/GTMTE_LongDistancePipelineBase.java`
- [Energy transfer](https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/mods/gregtech/tileentities/basic/GTMTE_LongDistancePipelineEnergy.java): `src/main/java/com/impact/mods/gregtech/tileentities/basic/GTMTE_LongDistancePipelineEnergy.java`

### Networks and worlds

- [Aerostat state](https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/common/managers/AeroStateNetworkManager.kt): `src/main/java/com/impact/common/managers/AeroStateNetworkManager.kt`
- [Satellite networks](https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/addon/gt/api/satellite/SatelliteNetworkManager.kt): `src/main/java/com/impact/addon/gt/api/satellite/SatelliteNetworkManager.kt`
- [Virtual worlds](https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/addon/vw/VirtualWorldIntegration.kt): `src/main/java/com/impact/addon/vw/VirtualWorldIntegration.kt`

### Client interaction

- [Client proxy](https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/core/ClientProxy.java): `src/main/java/com/impact/core/ClientProxy.java`
- [GUI routing](https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/client/gui/GUIHandler.java): `src/main/java/com/impact/client/gui/GUIHandler.java`
- [Client events](https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/events/ClientEvent.java): `src/main/java/com/impact/events/ClientEvent.java`
- [Packet handler](https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/network/GTNetworkHandler.kt): `src/main/java/com/impact/network/GTNetworkHandler.kt`

### Recipes and discovery

- **Recipe definitions**
- [NEI recipe views](https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/addon/nei/impactplugin/RecipeProcessorRegister.kt): `src/main/java/com/impact/addon/nei/impactplugin/RecipeProcessorRegister.kt`
- [Recipe builders](https://github.com/gt-impact/impact-core/blob/master/src/main/java/com/impact/recipe/recipe_builder/CraftingTableBuilder.kt): `src/main/java/com/impact/recipe/recipe_builder/CraftingTableBuilder.kt`

### Other components

- **Server or player**

## Connections

- Server or player → Mod entry: starts mod
- Mod entry → Configuration: loads config (evidence: `src/main/java/com/impact/impact.java`)
- Mod entry → Registration loader: runs lifecycle (evidence: `src/main/java/com/impact/impact.java`)
- Mod entry → Common proxy: calls proxy (evidence: `src/main/java/com/impact/impact.java`)
- Mod entry → GUI routing: registers handler (evidence: `src/main/java/com/impact/impact.java`)
- Mod entry → Tick events: registers events (evidence: `src/main/java/com/impact/impact.java`)
- Tick events → Aerostat state: updates state (evidence: `src/main/java/com/impact/events/TickHandler.java`)
- Machine registration → GregTech machines: registers machines (evidence: `src/main/java/com/impact/mods/gregtech/Basic_Register.java`)
- Long-distance pipes → Energy transfer: specializes
- Long-distance pipes → Machine registration: uses pipe block (evidence: `src/main/java/com/impact/mods/gregtech/tileentities/basic/GTMTE_LongDistancePipelineBase.java`)
- Client proxy → NEI recipe views: registers views (evidence: `src/main/java/com/impact/core/ClientProxy.java`)
- Client events → Packet handler: sends packets (evidence: `src/main/java/com/impact/events/ClientEvent.java`)
- GUI routing → Server or player: serves interfaces
- Recipe definitions → NEI recipe views: documents recipes
- Recipe builders → Recipe definitions: builds recipes
