# chemiofitor4096/tinkersassembly architecture

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

- Interactive diagram: https://gitdiagram.com/chemiofitor4096/tinkersassembly
- Repository: https://github.com/chemiofitor4096/tinkersassembly

## Overview

Tinkers’ Assembly is a Minecraft addon that connects Create machines with Tinkers’ Construct tools. Its main workflow assembles tagged templates through Create’s sequenced Deployers, records part materials on the intermediate item, and builds a finished tool. Separate machine workflows cut material-bound parts with the Saw, cast parts with the Spout, and repair or swap tool parts with Deployers. The graph also includes filter attributes and documented JEI/KubeJS support. Some subsystem links are documented in the README rather than shown in sampled implementation; those are marked unverified or omitted.

Main entry points: [`src/main/java/com/chemiofitor/tassembly/mixin/SequencedAssemblyRecipeMixin.java`](https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/mixin/SequencedAssemblyRecipeMixin.java) (Sequence processing), [`src/main/java/com/chemiofitor/tassembly/deployer/DeployerRecipeHandler.java`](https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/deployer/DeployerRecipeHandler.java) (Deployer repair and swap), [`src/main/java/com/chemiofitor/tassembly/TinkersAssembly.java`](https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/TinkersAssembly.java) (Mod initialization), [`src/main/java/com/chemiofitor/tassembly/registry/TAItems.java`](https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/registry/TAItems.java) (Templates and items)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_assembly["Tool assembly"]
  node_entry["Mod initialization"]
  node_items["Templates and items<br/>[TAItems.java]"]
  node_tags["Template tags<br/>[TATagProvider.java]"]
  node_recipes["Assembly recipes"]
  node_sequence["Sequence processing"]
  node_state["Assembly state"]
  node_incomplete["Intermediate item"]
  node_builder["Tool construction<br/>[ToolBuilder.java]"]
  node_result_api["Custom result handlers"]
  node_recipe_api["Handler registry"]
end

subgraph group_machines["Machine operations"]
  node_deployer["Deployer repair and swap"]
  node_repair["Repair logic"]
  node_swap["Part swap logic"]
  node_saw_mixin["Saw integration"]
  node_cutting["Material cutting"]
  node_spout_mixin["Spout integration"]
  node_casting["Material casting"]
end

subgraph group_integration["Player integrations"]
  node_jei["JEI recipe displays"]
  node_kubejs["KubeJS templates"]
end

subgraph group_filters["Create filters"]
  node_attributes["Filter attributes"]
  node_attribute_impl["Attribute implementations<br/>[ToolAttribute.java]"]
end

node_player(("Player / recipes"))
node_create["Create machines"]

node_entry -->|"registers"| node_items
node_entry -->|"registers"| node_attributes
node_entry -->|"registers"| node_deployer
node_items -->|"supplies templates"| node_tags
node_recipes -->|"uses template tags"| node_tags
node_player -.->|"feeds template and parts"| node_create
node_create -.->|"runs sequence"| node_sequence
node_sequence -->|"reads and writes"| node_state
node_sequence -->|"checks intermediate"| node_incomplete
node_sequence -->|"builds final tool"| node_builder
node_sequence -->|"finds handler"| node_recipe_api
node_recipe_api -->|"returns handler"| node_result_api
node_incomplete -->|"reads assembly data"| node_state
node_create -.->|"requests recipe search"| node_deployer
node_deployer -->|"invokes swap"| node_swap
node_deployer -->|"invokes repair"| node_repair
node_create -.->|"runs saw cutting"| node_saw_mixin
node_saw_mixin -->|"uses material logic"| node_cutting
node_create -.->|"runs spout casting"| node_spout_mixin
node_spout_mixin -.->|"delegates casting"| node_casting
node_player -.->|"views recipes"| node_jei
node_jei -->|"shows saw recipes"| node_cutting
node_player -.->|"adds templates"| node_kubejs
node_attributes -->|"registers types"| node_attribute_impl

click node_entry "https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/TinkersAssembly.java"
click node_items "https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/registry/TAItems.java"
click node_tags "https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/data/TATagProvider.java"
click node_recipes "https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/data/recipe/ToolAssemblyRecipeGen.java"
click node_sequence "https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/mixin/SequencedAssemblyRecipeMixin.java"
click node_state "https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/assembly/ToolAssemblyNBT.java"
click node_incomplete "https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/item/IncompleteToolItem.java"
click node_builder "https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/assembly/ToolBuilder.java"
click node_result_api "https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/api/IAssemblyResultHandler.java"
click node_recipe_api "https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/api/TAssemblyRecipes.java"
click node_deployer "https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/deployer/DeployerRecipeHandler.java"
click node_repair "https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/deployer/ToolRepairLogic.java"
click node_swap "https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/deployer/ToolPartSwapLogic.java"
click node_saw_mixin "https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/mixin/SawBlockEntityMixin.java"
click node_cutting "https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/saw/MaterialCuttingHandler.java"
click node_spout_mixin "https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/mixin/FillingBySpoutMixin.java"
click node_casting "https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/spout/MaterialCastingHandler.java"
click node_jei "https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/compat/jei/TinkersAssemblyJeiPlugin.java"
click node_kubejs "https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/compat/kubejs/TAToolAssemblyRecipeJS.java"
click node_attributes "https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/registry/TAAttributeTypes.java"
click node_attribute_impl "https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/item/attribute/ToolAttribute.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_entry,node_items,node_tags,node_recipes,node_sequence,node_state,node_incomplete,node_builder,node_result_api,node_recipe_api toneBlue
class node_deployer,node_repair,node_swap,node_saw_mixin,node_cutting,node_spout_mixin,node_casting toneAmber
class node_jei,node_kubejs toneMint
class node_attributes,node_attribute_impl toneRose
class node_player,node_create toneIndigo
```

## Components

### Tool assembly

- [Mod initialization](https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/TinkersAssembly.java): `src/main/java/com/chemiofitor/tassembly/TinkersAssembly.java`
- [Templates and items](https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/registry/TAItems.java): `src/main/java/com/chemiofitor/tassembly/registry/TAItems.java`
- [Template tags](https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/data/TATagProvider.java): `src/main/java/com/chemiofitor/tassembly/data/TATagProvider.java`
- [Assembly recipes](https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/data/recipe/ToolAssemblyRecipeGen.java): `src/main/java/com/chemiofitor/tassembly/data/recipe/ToolAssemblyRecipeGen.java`
- [Sequence processing](https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/mixin/SequencedAssemblyRecipeMixin.java): `src/main/java/com/chemiofitor/tassembly/mixin/SequencedAssemblyRecipeMixin.java`
- [Assembly state](https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/assembly/ToolAssemblyNBT.java): `src/main/java/com/chemiofitor/tassembly/assembly/ToolAssemblyNBT.java`
- [Intermediate item](https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/item/IncompleteToolItem.java): `src/main/java/com/chemiofitor/tassembly/item/IncompleteToolItem.java`
- [Tool construction](https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/assembly/ToolBuilder.java): `src/main/java/com/chemiofitor/tassembly/assembly/ToolBuilder.java`
- [Custom result handlers](https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/api/IAssemblyResultHandler.java): `src/main/java/com/chemiofitor/tassembly/api/IAssemblyResultHandler.java`
- [Handler registry](https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/api/TAssemblyRecipes.java): `src/main/java/com/chemiofitor/tassembly/api/TAssemblyRecipes.java`

### Machine operations

- [Deployer repair and swap](https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/deployer/DeployerRecipeHandler.java): `src/main/java/com/chemiofitor/tassembly/deployer/DeployerRecipeHandler.java`
- [Repair logic](https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/deployer/ToolRepairLogic.java): `src/main/java/com/chemiofitor/tassembly/deployer/ToolRepairLogic.java`
- [Part swap logic](https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/deployer/ToolPartSwapLogic.java): `src/main/java/com/chemiofitor/tassembly/deployer/ToolPartSwapLogic.java`
- [Saw integration](https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/mixin/SawBlockEntityMixin.java): `src/main/java/com/chemiofitor/tassembly/mixin/SawBlockEntityMixin.java`
- [Material cutting](https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/saw/MaterialCuttingHandler.java): `src/main/java/com/chemiofitor/tassembly/saw/MaterialCuttingHandler.java`
- [Spout integration](https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/mixin/FillingBySpoutMixin.java): `src/main/java/com/chemiofitor/tassembly/mixin/FillingBySpoutMixin.java`
- [Material casting](https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/spout/MaterialCastingHandler.java): `src/main/java/com/chemiofitor/tassembly/spout/MaterialCastingHandler.java`

### Player integrations

- [JEI recipe displays](https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/compat/jei/TinkersAssemblyJeiPlugin.java): `src/main/java/com/chemiofitor/tassembly/compat/jei/TinkersAssemblyJeiPlugin.java`
- [KubeJS templates](https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/compat/kubejs/TAToolAssemblyRecipeJS.java): `src/main/java/com/chemiofitor/tassembly/compat/kubejs/TAToolAssemblyRecipeJS.java`

### Create filters

- [Filter attributes](https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/registry/TAAttributeTypes.java): `src/main/java/com/chemiofitor/tassembly/registry/TAAttributeTypes.java`
- [Attribute implementations](https://github.com/chemiofitor4096/tinkersassembly/blob/1.20.1-dev/src/main/java/com/chemiofitor/tassembly/item/attribute/ToolAttribute.java): `src/main/java/com/chemiofitor/tassembly/item/attribute/ToolAttribute.java`

### Other components

- **Player / recipes**
- **Create machines**

## Connections

- Mod initialization → Templates and items: registers (evidence: `src/main/java/com/chemiofitor/tassembly/TinkersAssembly.java`)
- Mod initialization → Filter attributes: registers (evidence: `src/main/java/com/chemiofitor/tassembly/TinkersAssembly.java`)
- Mod initialization → Deployer repair and swap: registers (evidence: `src/main/java/com/chemiofitor/tassembly/TinkersAssembly.java`)
- Templates and items → Template tags: supplies templates (evidence: `src/main/java/com/chemiofitor/tassembly/data/TATagProvider.java`)
- Assembly recipes → Template tags: uses template tags (evidence: `src/main/java/com/chemiofitor/tassembly/data/recipe/ToolAssemblyRecipeGen.java`)
- Player / recipes → Create machines: feeds template and parts
- Create machines → Sequence processing: runs sequence
- Sequence processing → Assembly state: reads and writes (evidence: `src/main/java/com/chemiofitor/tassembly/mixin/SequencedAssemblyRecipeMixin.java`)
- Sequence processing → Intermediate item: checks intermediate (evidence: `src/main/java/com/chemiofitor/tassembly/mixin/SequencedAssemblyRecipeMixin.java`)
- Sequence processing → Tool construction: builds final tool (evidence: `src/main/java/com/chemiofitor/tassembly/mixin/SequencedAssemblyRecipeMixin.java`)
- Sequence processing → Handler registry: finds handler (evidence: `src/main/java/com/chemiofitor/tassembly/mixin/SequencedAssemblyRecipeMixin.java`)
- Handler registry → Custom result handlers: returns handler (evidence: `src/main/java/com/chemiofitor/tassembly/api/TAssemblyRecipes.java`)
- Intermediate item → Assembly state: reads assembly data (evidence: `src/main/java/com/chemiofitor/tassembly/item/IncompleteToolItem.java`)
- Create machines → Deployer repair and swap: requests recipe search
- Deployer repair and swap → Part swap logic: invokes swap (evidence: `src/main/java/com/chemiofitor/tassembly/deployer/DeployerRecipeHandler.java`)
- Deployer repair and swap → Repair logic: invokes repair (evidence: `src/main/java/com/chemiofitor/tassembly/deployer/DeployerRecipeHandler.java`)
- Create machines → Saw integration: runs saw cutting
- Saw integration → Material cutting: uses material logic (evidence: `src/main/java/com/chemiofitor/tassembly/mixin/SawBlockEntityMixin.java`)
- Create machines → Spout integration: runs spout casting
- Spout integration → Material casting: delegates casting (evidence: `src/main/java/com/chemiofitor/tassembly/mixin/FillingBySpoutMixin.java`)
- Player / recipes → JEI recipe displays: views recipes
- JEI recipe displays → Material cutting: shows saw recipes (evidence: `src/main/java/com/chemiofitor/tassembly/compat/jei/TinkersAssemblyJeiPlugin.java`)
- Player / recipes → KubeJS templates: adds templates
- Filter attributes → Attribute implementations: registers types (evidence: `src/main/java/com/chemiofitor/tassembly/registry/TAAttributeTypes.java`)
