# sefiraat/equivalencytech architecture

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

- Interactive diagram: https://gitdiagram.com/sefiraat/equivalencytech
- Repository: https://github.com/sefiraat/equivalencytech

## Overview

EquivalencyTech is a Minecraft server plugin that implements ProjectE-style EMC: players learn items by converting them to EMC, then synthesize learned items from their balance; automated chests extend that economy. Startup wires configuration, items, recipes, events, commands, and scheduled work. The graph preserves those documented capabilities, including crafting and optional Slimefun support. Source excerpts are partial, so chest processing and some registration details are shown only where the README or indexed references support them.

Main entry points: [`src/main/java/io/github/sefiraat/equivalencytech/EquivalencyTech.java`](https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/EquivalencyTech.java) (Plugin lifecycle), [`src/main/java/io/github/sefiraat/equivalencytech/commands/Commands.java`](https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/commands/Commands.java) (Commands), [`src/main/java/io/github/sefiraat/equivalencytech/item/EQItems.java`](https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/item/EQItems.java) (EquiTech items), [`src/main/java/io/github/sefiraat/equivalencytech/gui/GuiTransmutationOrb.java`](https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/gui/GuiTransmutationOrb.java) (Transmutation GUI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Plugin runtime"]
  node_plugin["Plugin lifecycle"]
  node_config["Configuration<br/>[ConfigMain.java]"]
  node_strings["Config strings<br/>[ConfigStrings.java]"]
  node_events["Event registration<br/>[ManagerEvents.java]"]
  node_scheduled["Scheduled tasks"]
end

subgraph group_economy["EMC economy"]
  node_emc["EMC definitions"]
  node_balances[("Player EMC<br/>[ConfigMain.java]")]
  node_learned[("Learned items<br/>[ConfigMain.java]")]
end

subgraph group_interfaces["Player interactions"]
  node_commands["Commands<br/>[Commands.java]"]
  node_orb_events["Orb and craft events"]
  node_orb_gui["Transmutation GUI"]
end

subgraph group_automation["Items and automation"]
  node_chest_events["Chest placement"]
  node_items["EquiTech items<br/>[EQItems.java]"]
  node_orb["Transmutation orb"]
  node_dissolution["Dissolution chest"]
  node_condensator["Condensator chest"]
  node_chest_tick["Automated chest tick"]
  node_chest_state[("Chest state")]
end

subgraph group_integrations["Recipes and integrations"]
  node_recipes["Crafting recipes<br/>[Recipes.java]"]
  node_slimefun["Slimefun addon"]
end

node_player(("Player"))
node_slimefun_service["Slimefun"]

node_plugin -->|"initializes"| node_config
node_plugin -->|"initializes"| node_items
node_plugin -->|"registers"| node_commands
node_plugin -->|"creates"| node_events
node_plugin -->|"creates"| node_scheduled
node_config -->|"creates"| node_strings
node_events -->|"creates"| node_orb_events
node_events -->|"creates"| node_chest_events
node_player -->|"invokes"| node_commands
node_commands -->|"reads and updates"| node_balances
node_commands -->|"grants"| node_orb
node_commands -->|"grants"| node_dissolution
node_player -->|"uses orb"| node_orb_events
node_orb_events -.->|"opens"| node_orb_gui
node_orb_gui -->|"looks up values"| node_emc
node_orb_gui -->|"updates balance"| node_balances
node_orb_gui -.->|"uses learned items"| node_learned
node_items -->|"builds"| node_orb
node_items -->|"builds"| node_dissolution
node_items -->|"builds"| node_condensator
node_player -->|"places chest"| node_chest_events
node_chest_events -.->|"records locations"| node_chest_state
node_scheduled -->|"schedules"| node_chest_tick
node_chest_tick -.->|"adds EMC"| node_balances
node_chest_tick -.->|"reads chest state"| node_chest_state
node_recipes -->|"defines item recipes"| node_items
node_plugin -->|"initializes"| node_emc
node_plugin -->|"initializes"| node_recipes
node_plugin -->|"checks support"| node_slimefun
node_slimefun -->|"integrates recipes"| node_recipes
node_slimefun -.->|"registers addon"| node_slimefun_service

click node_plugin "https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/EquivalencyTech.java"
click node_config "https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/configuration/ConfigMain.java"
click node_strings "https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/configuration/ConfigStrings.java"
click node_commands "https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/commands/Commands.java"
click node_events "https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/listeners/ManagerEvents.java"
click node_orb_events "https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/listeners/OrbOpenListener.java"
click node_chest_events "https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/listeners/ChestPlaceListener.java"
click node_orb_gui "https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/gui/GuiTransmutationOrb.java"
click node_emc "https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/recipes/EmcDefinitions.java"
click node_balances "https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/configuration/ConfigMain.java"
click node_learned "https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/configuration/ConfigMain.java"
click node_items "https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/item/EQItems.java"
click node_orb "https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/item/builders/TransmutationOrb.java"
click node_dissolution "https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/item/builders/DissolutionChest.java"
click node_condensator "https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/item/builders/CondensatorChest.java"
click node_chest_tick "https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/runnables/RunnableEQTick.java"
click node_chest_state "https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/statics/ContainerStorage.java"
click node_recipes "https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/recipes/Recipes.java"
click node_slimefun "https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/misc/SlimefunEQAddon.java"
click node_scheduled "https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/runnables/ManagerRunnables.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_plugin,node_config,node_strings,node_events,node_scheduled toneBlue
class node_emc,node_balances,node_learned toneAmber
class node_commands,node_orb_events,node_orb_gui toneMint
class node_chest_events,node_items,node_orb,node_dissolution,node_condensator,node_chest_tick,node_chest_state toneRose
class node_recipes,node_slimefun,node_player,node_slimefun_service toneIndigo
```

## Components

### Plugin runtime

- [Plugin lifecycle](https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/EquivalencyTech.java): `src/main/java/io/github/sefiraat/equivalencytech/EquivalencyTech.java`
- [Configuration](https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/configuration/ConfigMain.java): `src/main/java/io/github/sefiraat/equivalencytech/configuration/ConfigMain.java`
- [Config strings](https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/configuration/ConfigStrings.java): `src/main/java/io/github/sefiraat/equivalencytech/configuration/ConfigStrings.java`
- [Event registration](https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/listeners/ManagerEvents.java): `src/main/java/io/github/sefiraat/equivalencytech/listeners/ManagerEvents.java`
- [Scheduled tasks](https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/runnables/ManagerRunnables.java): `src/main/java/io/github/sefiraat/equivalencytech/runnables/ManagerRunnables.java`

### EMC economy

- [EMC definitions](https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/recipes/EmcDefinitions.java): `src/main/java/io/github/sefiraat/equivalencytech/recipes/EmcDefinitions.java`
- [Player EMC](https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/configuration/ConfigMain.java): `src/main/java/io/github/sefiraat/equivalencytech/configuration/ConfigMain.java`
- [Learned items](https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/configuration/ConfigMain.java): `src/main/java/io/github/sefiraat/equivalencytech/configuration/ConfigMain.java`

### Player interactions

- [Commands](https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/commands/Commands.java): `src/main/java/io/github/sefiraat/equivalencytech/commands/Commands.java`
- [Orb and craft events](https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/listeners/OrbOpenListener.java): `src/main/java/io/github/sefiraat/equivalencytech/listeners/OrbOpenListener.java`
- [Transmutation GUI](https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/gui/GuiTransmutationOrb.java): `src/main/java/io/github/sefiraat/equivalencytech/gui/GuiTransmutationOrb.java`

### Items and automation

- [Chest placement](https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/listeners/ChestPlaceListener.java): `src/main/java/io/github/sefiraat/equivalencytech/listeners/ChestPlaceListener.java`
- [EquiTech items](https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/item/EQItems.java): `src/main/java/io/github/sefiraat/equivalencytech/item/EQItems.java`
- [Transmutation orb](https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/item/builders/TransmutationOrb.java): `src/main/java/io/github/sefiraat/equivalencytech/item/builders/TransmutationOrb.java`
- [Dissolution chest](https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/item/builders/DissolutionChest.java): `src/main/java/io/github/sefiraat/equivalencytech/item/builders/DissolutionChest.java`
- [Condensator chest](https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/item/builders/CondensatorChest.java): `src/main/java/io/github/sefiraat/equivalencytech/item/builders/CondensatorChest.java`
- [Automated chest tick](https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/runnables/RunnableEQTick.java): `src/main/java/io/github/sefiraat/equivalencytech/runnables/RunnableEQTick.java`
- [Chest state](https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/statics/ContainerStorage.java): `src/main/java/io/github/sefiraat/equivalencytech/statics/ContainerStorage.java`

### Recipes and integrations

- [Crafting recipes](https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/recipes/Recipes.java): `src/main/java/io/github/sefiraat/equivalencytech/recipes/Recipes.java`
- [Slimefun addon](https://github.com/sefiraat/equivalencytech/blob/master/src/main/java/io/github/sefiraat/equivalencytech/misc/SlimefunEQAddon.java): `src/main/java/io/github/sefiraat/equivalencytech/misc/SlimefunEQAddon.java`

### Other components

- **Player**
- **Slimefun**

## Connections

- Plugin lifecycle → Configuration: initializes (evidence: `src/main/java/io/github/sefiraat/equivalencytech/EquivalencyTech.java`)
- Plugin lifecycle → EquiTech items: initializes (evidence: `src/main/java/io/github/sefiraat/equivalencytech/EquivalencyTech.java`)
- Plugin lifecycle → Commands: registers (evidence: `src/main/java/io/github/sefiraat/equivalencytech/EquivalencyTech.java`)
- Plugin lifecycle → Event registration: creates (evidence: `src/main/java/io/github/sefiraat/equivalencytech/EquivalencyTech.java`)
- Plugin lifecycle → Scheduled tasks: creates (evidence: `src/main/java/io/github/sefiraat/equivalencytech/EquivalencyTech.java`)
- Configuration → Config strings: creates (evidence: `src/main/java/io/github/sefiraat/equivalencytech/configuration/ConfigMain.java`)
- Event registration → Orb and craft events: creates (evidence: `src/main/java/io/github/sefiraat/equivalencytech/listeners/ManagerEvents.java`)
- Event registration → Chest placement: creates (evidence: `src/main/java/io/github/sefiraat/equivalencytech/listeners/ManagerEvents.java`)
- Player → Commands: invokes (evidence: `src/main/java/io/github/sefiraat/equivalencytech/commands/Commands.java`)
- Commands → Player EMC: reads and updates (evidence: `src/main/java/io/github/sefiraat/equivalencytech/commands/Commands.java`)
- Commands → Transmutation orb: grants (evidence: `src/main/java/io/github/sefiraat/equivalencytech/commands/Commands.java`)
- Commands → Dissolution chest: grants (evidence: `src/main/java/io/github/sefiraat/equivalencytech/commands/Commands.java`)
- Player → Orb and craft events: uses orb (evidence: `README.md`)
- Orb and craft events → Transmutation GUI: opens (evidence: `src/main/java/io/github/sefiraat/equivalencytech/listeners/OrbOpenListener.java`)
- Transmutation GUI → EMC definitions: looks up values
- Transmutation GUI → Player EMC: updates balance (evidence: `src/main/java/io/github/sefiraat/equivalencytech/gui/GuiTransmutationOrb.java`)
- Transmutation GUI → Learned items: uses learned items (evidence: `src/main/java/io/github/sefiraat/equivalencytech/gui/GuiTransmutationOrb.java`)
- EquiTech items → Transmutation orb: builds (evidence: `src/main/java/io/github/sefiraat/equivalencytech/item/EQItems.java`)
- EquiTech items → Dissolution chest: builds (evidence: `src/main/java/io/github/sefiraat/equivalencytech/item/EQItems.java`)
- EquiTech items → Condensator chest: builds (evidence: `src/main/java/io/github/sefiraat/equivalencytech/item/EQItems.java`)
- Player → Chest placement: places chest (evidence: `README.md`)
- Chest placement → Chest state: records locations (evidence: `src/main/java/io/github/sefiraat/equivalencytech/listeners/ChestPlaceListener.java`)
- Scheduled tasks → Automated chest tick: schedules (evidence: `src/main/java/io/github/sefiraat/equivalencytech/runnables/ManagerRunnables.java`)
- Automated chest tick → Player EMC: adds EMC (evidence: `src/main/java/io/github/sefiraat/equivalencytech/runnables/RunnableEQTick.java`)
- Automated chest tick → Chest state: reads chest state (evidence: `src/main/java/io/github/sefiraat/equivalencytech/runnables/RunnableEQTick.java`)
- Crafting recipes → EquiTech items: defines item recipes (evidence: `src/main/java/io/github/sefiraat/equivalencytech/recipes/Recipes.java`)
- Plugin lifecycle → EMC definitions: initializes (evidence: `src/main/java/io/github/sefiraat/equivalencytech/EquivalencyTech.java`)
- Plugin lifecycle → Crafting recipes: initializes (evidence: `src/main/java/io/github/sefiraat/equivalencytech/EquivalencyTech.java`)
- Plugin lifecycle → Slimefun addon: checks support (evidence: `src/main/java/io/github/sefiraat/equivalencytech/EquivalencyTech.java`)
- Slimefun addon → Crafting recipes: integrates recipes (evidence: `src/main/java/io/github/sefiraat/equivalencytech/misc/SlimefunEQAddon.java`)
- Slimefun addon → Slimefun: registers addon
