# dortythegreat/tradeaura architecture

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

- Interactive diagram: https://gitdiagram.com/dortythegreat/tradeaura
- Repository: https://github.com/dortythegreat/tradeaura

## Overview

TradeAura is a Meteor Client addon for automating villager trades and optionally managing the player’s inventory around them. The main workflow is to configure buy/sell rules, initiate a villager interaction manually or through Villager Aura, and let matching trades complete automatically. A separate inventory manager evaluates configured cleanup and crafting triggers between trades and runs multi-tick tasks. The README documents rendering and recovery capabilities; their detailed implementation paths are not fully evidenced by the excerpts, so those links are limited to documented relationships.

Main entry points: [`src/main/java/dortythegreat/tradeaura/modules/TradeAura.java`](https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/modules/TradeAura.java) (Trade Aura module), [`src/main/java/dortythegreat/tradeaura/inventory/InventoryManager.java`](https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/inventory/InventoryManager.java) (Inventory manager), [`src/main/java/dortythegreat/tradeaura/inventory/InventorySettings.java`](https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/inventory/InventorySettings.java) (Inventory settings), [`src/main/java/dortythegreat/tradeaura/inventory/CraftTask.java`](https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/inventory/CraftTask.java) (Crafting tasks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Addon entry"]
  node_addon["Addon registration<br/>[Addon.java]"]
  node_modulebase["Module base<br/>[AddonModule.java]"]
end

subgraph group_trading["Trading"]
  node_tradeaura["Trade Aura module<br/>[TradeAura.java]"]
  node_tradedata["Trade data<br/>[TradeData.java]"]
  node_rules["Buy/sell rules<br/>[TradeAura.java]"]
  node_aura["Villager Aura<br/>[TradeAura.java]"]
  node_tradeoutcome["Automatic trades<br/>[TradeAura.java]"]
  node_render["Villager overlay<br/>[TradeAura.java]"]
end

subgraph group_inventory["Inventory management"]
  node_invsettings["Inventory settings"]
  node_itemrules["Inventory item rules<br/>[ItemRule.java]"]
  node_invmanager["Inventory manager"]
  node_invtask["Task lifecycle<br/>[InvTask.java]"]
  node_droptask["Excess-item dropping<br/>[DropTask.java]"]
  node_crafttask["Crafting tasks<br/>[CraftTask.java]"]
  node_craftrecipes["Craft recipes<br/>[CraftRecipe.java]"]
  node_shulkertask["Shulker transfer<br/>[ShulkerTask.java]"]
  node_invhelper["Inventory operations<br/>[InvHelper.java]"]
  node_movement["Movement control"]
  node_amountmode["Amount modes<br/>[AmountMode.java]"]
  node_dropdirection["Drop direction<br/>[DropDirection.java]"]
end

subgraph group_support["Feedback and settings"]
end

node_player(("Player"))
node_game["Minecraft world"]

node_player -->|"configures"| node_tradeaura
node_addon -->|"registers"| node_tradeaura
node_tradeaura -->|"extends"| node_modulebase
node_player -->|"interacts with villager"| node_game
node_game -->|"opens trade interaction"| node_tradeaura
node_tradeaura -->|"optionally targets villagers"| node_aura
node_tradeaura -->|"matches trades"| node_rules
node_rules -->|"completes matching trades"| node_tradeoutcome
node_tradeaura -->|"uses trade data"| node_tradedata
node_tradeaura -->|"renders outcomes"| node_render
node_tradeaura -->|"runs inventory management"| node_invmanager
node_player -->|"configures"| node_invsettings
node_invsettings -->|"sets triggers"| node_invmanager
node_invmanager -->|"evaluates rules"| node_itemrules
node_invmanager -->|"starts drop task"| node_droptask
node_invmanager -->|"starts crafting task"| node_crafttask
node_invmanager -->|"starts shulker task"| node_shulkertask
node_droptask -->|"extends"| node_invtask
node_crafttask -->|"extends"| node_invtask
node_shulkertask -->|"extends"| node_invtask
node_crafttask -->|"executes recipe"| node_craftrecipes
node_droptask -->|"moves inventory items"| node_invhelper
node_crafttask -->|"uses inventory operations"| node_invhelper
node_shulkertask -->|"transfers items"| node_invhelper
node_shulkertask -->|"controls movement"| node_movement
node_invsettings -->|"configures amount mode"| node_amountmode
node_invsettings -->|"configures direction"| node_dropdirection
node_invmanager -->|"runs between trades"| node_tradeaura

click node_addon "https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/Addon.java"
click node_modulebase "https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/AddonModule.java"
click node_tradeaura "https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/modules/TradeAura.java"
click node_tradedata "https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/modules/TradeData.java"
click node_rules "https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/modules/TradeAura.java"
click node_aura "https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/modules/TradeAura.java"
click node_tradeoutcome "https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/modules/TradeAura.java"
click node_render "https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/modules/TradeAura.java"
click node_invsettings "https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/inventory/InventorySettings.java"
click node_itemrules "https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/inventory/ItemRule.java"
click node_invmanager "https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/inventory/InventoryManager.java"
click node_invtask "https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/inventory/InvTask.java"
click node_droptask "https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/inventory/DropTask.java"
click node_crafttask "https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/inventory/CraftTask.java"
click node_craftrecipes "https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/inventory/CraftRecipe.java"
click node_shulkertask "https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/inventory/ShulkerTask.java"
click node_invhelper "https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/inventory/InvHelper.java"
click node_movement "https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/inventory/MovementControl.java"
click node_amountmode "https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/inventory/AmountMode.java"
click node_dropdirection "https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/inventory/DropDirection.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_addon,node_modulebase toneBlue
class node_tradeaura,node_tradedata,node_rules,node_aura,node_tradeoutcome,node_render toneAmber
class node_invsettings,node_itemrules,node_invmanager,node_invtask,node_droptask,node_crafttask,node_craftrecipes,node_shulkertask,node_invhelper,node_movement,node_amountmode,node_dropdirection toneMint
class node_player,node_game toneIndigo
```

## Components

### Addon entry

- [Addon registration](https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/Addon.java): `src/main/java/dortythegreat/tradeaura/Addon.java`
- [Module base](https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/AddonModule.java): `src/main/java/dortythegreat/tradeaura/AddonModule.java`

### Trading

- [Trade Aura module](https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/modules/TradeAura.java): `src/main/java/dortythegreat/tradeaura/modules/TradeAura.java`
- [Trade data](https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/modules/TradeData.java): `src/main/java/dortythegreat/tradeaura/modules/TradeData.java`
- [Buy/sell rules](https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/modules/TradeAura.java): `src/main/java/dortythegreat/tradeaura/modules/TradeAura.java`
- [Villager Aura](https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/modules/TradeAura.java): `src/main/java/dortythegreat/tradeaura/modules/TradeAura.java`
- [Automatic trades](https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/modules/TradeAura.java): `src/main/java/dortythegreat/tradeaura/modules/TradeAura.java`
- [Villager overlay](https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/modules/TradeAura.java): `src/main/java/dortythegreat/tradeaura/modules/TradeAura.java`

### Inventory management

- [Inventory settings](https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/inventory/InventorySettings.java): `src/main/java/dortythegreat/tradeaura/inventory/InventorySettings.java`
- [Inventory item rules](https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/inventory/ItemRule.java): `src/main/java/dortythegreat/tradeaura/inventory/ItemRule.java`
- [Inventory manager](https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/inventory/InventoryManager.java): `src/main/java/dortythegreat/tradeaura/inventory/InventoryManager.java`
- [Task lifecycle](https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/inventory/InvTask.java): `src/main/java/dortythegreat/tradeaura/inventory/InvTask.java`
- [Excess-item dropping](https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/inventory/DropTask.java): `src/main/java/dortythegreat/tradeaura/inventory/DropTask.java`
- [Crafting tasks](https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/inventory/CraftTask.java): `src/main/java/dortythegreat/tradeaura/inventory/CraftTask.java`
- [Craft recipes](https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/inventory/CraftRecipe.java): `src/main/java/dortythegreat/tradeaura/inventory/CraftRecipe.java`
- [Shulker transfer](https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/inventory/ShulkerTask.java): `src/main/java/dortythegreat/tradeaura/inventory/ShulkerTask.java`
- [Inventory operations](https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/inventory/InvHelper.java): `src/main/java/dortythegreat/tradeaura/inventory/InvHelper.java`
- [Movement control](https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/inventory/MovementControl.java): `src/main/java/dortythegreat/tradeaura/inventory/MovementControl.java`
- [Amount modes](https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/inventory/AmountMode.java): `src/main/java/dortythegreat/tradeaura/inventory/AmountMode.java`
- [Drop direction](https://github.com/dortythegreat/tradeaura/blob/main/src/main/java/dortythegreat/tradeaura/inventory/DropDirection.java): `src/main/java/dortythegreat/tradeaura/inventory/DropDirection.java`

### Other components

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

## Connections

- Player → Trade Aura module: configures (evidence: `README.md`)
- Addon registration → Trade Aura module: registers (evidence: `src/main/java/dortythegreat/tradeaura/Addon.java`)
- Trade Aura module → Module base: extends (evidence: `src/main/java/dortythegreat/tradeaura/modules/TradeAura.java`)
- Player → Minecraft world: interacts with villager (evidence: `README.md`)
- Minecraft world → Trade Aura module: opens trade interaction (evidence: `README.md`)
- Trade Aura module → Villager Aura: optionally targets villagers (evidence: `README.md`)
- Trade Aura module → Buy/sell rules: matches trades (evidence: `README.md`)
- Buy/sell rules → Automatic trades: completes matching trades (evidence: `README.md`)
- Trade Aura module → Trade data: uses trade data (evidence: `src/main/java/dortythegreat/tradeaura/modules/TradeAura.java`)
- Trade Aura module → Villager overlay: renders outcomes (evidence: `README.md`)
- Trade Aura module → Inventory manager: runs inventory management (evidence: `src/main/java/dortythegreat/tradeaura/inventory/InventoryManager.java`)
- Player → Inventory settings: configures (evidence: `README.md`)
- Inventory settings → Inventory manager: sets triggers (evidence: `src/main/java/dortythegreat/tradeaura/inventory/InventoryManager.java`)
- Inventory manager → Inventory item rules: evaluates rules (evidence: `src/main/java/dortythegreat/tradeaura/inventory/InventoryManager.java`)
- Inventory manager → Excess-item dropping: starts drop task (evidence: `src/main/java/dortythegreat/tradeaura/inventory/InventoryManager.java`)
- Inventory manager → Crafting tasks: starts crafting task (evidence: `src/main/java/dortythegreat/tradeaura/inventory/InventoryManager.java`)
- Inventory manager → Shulker transfer: starts shulker task (evidence: `src/main/java/dortythegreat/tradeaura/inventory/InventoryManager.java`)
- Excess-item dropping → Task lifecycle: extends (evidence: `src/main/java/dortythegreat/tradeaura/inventory/DropTask.java`)
- Crafting tasks → Task lifecycle: extends (evidence: `src/main/java/dortythegreat/tradeaura/inventory/CraftTask.java`)
- Shulker transfer → Task lifecycle: extends (evidence: `src/main/java/dortythegreat/tradeaura/inventory/ShulkerTask.java`)
- Crafting tasks → Craft recipes: executes recipe (evidence: `src/main/java/dortythegreat/tradeaura/inventory/CraftTask.java`)
- Excess-item dropping → Inventory operations: moves inventory items (evidence: `src/main/java/dortythegreat/tradeaura/inventory/DropTask.java`)
- Crafting tasks → Inventory operations: uses inventory operations (evidence: `src/main/java/dortythegreat/tradeaura/inventory/CraftTask.java`)
- Shulker transfer → Inventory operations: transfers items (evidence: `src/main/java/dortythegreat/tradeaura/inventory/ShulkerTask.java`)
- Shulker transfer → Movement control: controls movement (evidence: `src/main/java/dortythegreat/tradeaura/inventory/ShulkerTask.java`)
- Inventory settings → Amount modes: configures amount mode (evidence: `src/main/java/dortythegreat/tradeaura/inventory/InventorySettings.java`)
- Inventory settings → Drop direction: configures direction (evidence: `src/main/java/dortythegreat/tradeaura/inventory/InventorySettings.java`)
- Inventory manager → Trade Aura module: runs between trades (evidence: `README.md`)
