# leipishu/tinkerssearch architecture

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

- Interactive diagram: https://gitdiagram.com/leipishu/tinkerssearch
- Repository: https://github.com/leipishu/tinkerssearch

## Overview

Tinker’s Search is a Tinkers’ Construct add-on that augments the Smeltery screen with fluid search, material and alloy tabs, detail views, favorites, and optional JEI actions. The main user flow is opening the floating panel, filtering or browsing its fluid lists, then inspecting, moving, favoriting, or querying a fluid. Source-index references and excerpts support the panel’s connections to its data, alloy, and interaction handlers; several documented features have unsampled implementations, so their internal links are omitted.

Main entry points: [`src/main/java/top/leipishu/tinkerssearch/client/gui/FloatingSearchPanel.java`](https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/client/gui/FloatingSearchPanel.java) (Search panel), [`src/main/java/top/leipishu/tinkerssearch/client/gui/panel/PanelDataManager.java`](https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/client/gui/panel/PanelDataManager.java) (Panel data), [`src/main/java/top/leipishu/tinkerssearch/client/gui/PanelInteractionHandler.java`](https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/client/gui/PanelInteractionHandler.java) (Panel interactions), [`src/main/java/top/leipishu/tinkerssearch/alloy/AlloyQueryHandler.java`](https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/alloy/AlloyQueryHandler.java) (Alloy query)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_screen["Screen and interaction"]
  node_mod["Mod event entry<br/>[TinkersSearch.java]"]
  node_panel["Search panel"]
  node_interaction["Panel interactions"]
  node_searchbox["Search box<br/>[SearchBox.java]"]
  node_animation["Animation manager"]
end

subgraph group_domain["Fluid and alloy data"]
  node_paneldata["Panel data"]
  node_alloyquery["Alloy query"]
  node_alloyreader["Alloy recipes"]
  node_alloycalc["Alloy chain calculator"]
  node_smeltery["Smeltery fluid data"]
  node_smelteryclick["Fluid movement"]
end

subgraph group_detail["Recipes and details"]
  node_detailview["Fluid detail screen"]
  node_casting["Casting recipe lookup"]
  node_partcache["Fluid part cache"]
end

subgraph group_support["Preferences and integrations"]
  node_favorites["Favorites"]
  node_search["Fluid search<br/>[SearchHelper.java]"]
  node_pinyin["Pinyin matching<br/>[PinyinSearch.java]"]
  node_jei["JEI integration<br/>[Jei.java]"]
  node_config["Panel configuration<br/>[PanelConfig.java]"]
end

node_player(("Player"))

node_player -->|"browses"| node_panel
node_mod -->|"registers on screen"| node_panel
node_mod -->|"updates"| node_animation
node_panel -->|"delegates input"| node_interaction
node_panel -->|"reads list data"| node_paneldata
node_panel -->|"queries alloys"| node_alloyquery
node_interaction -->|"handles text input"| node_searchbox
node_interaction -->|"requests lookup"| node_jei
node_paneldata -->|"loads alloy data"| node_alloyquery
node_paneldata -->|"loads fluids"| node_smeltery
node_paneldata -->|"loads favorites"| node_favorites
node_paneldata -->|"filters fluids"| node_search
node_alloyquery -->|"loads recipes"| node_alloyreader
node_alloyquery -->|"calculates results"| node_alloycalc
node_alloyreader -.->|"provides recipes"| node_alloycalc
node_search -->|"matches pinyin"| node_pinyin
node_panel -->|"opens details"| node_detailview
node_detailview -.->|"shows casting"| node_casting
node_casting -->|"checks requirements"| node_partcache
node_interaction -.->|"moves fluid"| node_smelteryclick
node_panel -->|"uses layout settings"| node_config
node_panel -.->|"animates panel"| node_animation

click node_mod "https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/TinkersSearch.java"
click node_panel "https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/client/gui/FloatingSearchPanel.java"
click node_interaction "https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/client/gui/PanelInteractionHandler.java"
click node_searchbox "https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/client/gui/components/SearchBox.java"
click node_paneldata "https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/client/gui/panel/PanelDataManager.java"
click node_alloyquery "https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/alloy/AlloyQueryHandler.java"
click node_alloyreader "https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/alloy/TinkersAlloyReader.java"
click node_alloycalc "https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/alloy/AlloyResultCalculator.java"
click node_smeltery "https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/smeltery/SmelteryDataHelper.java"
click node_smelteryclick "https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/smeltery/SmelteryClickHandler.java"
click node_detailview "https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/client/gui/FluidDetailScreen.java"
click node_casting "https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/recipe/CastingRecipeHelper.java"
click node_partcache "https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/data/FluidPartDataCache.java"
click node_favorites "https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/data/FavoritesManager.java"
click node_search "https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/utils/SearchHelper.java"
click node_pinyin "https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/utils/pinyin/PinyinSearch.java"
click node_jei "https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/jei/Jei.java"
click node_config "https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/config/PanelConfig.java"
click node_animation "https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/client/animation/core/AnimationManager.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_mod,node_panel,node_interaction,node_searchbox,node_animation toneBlue
class node_paneldata,node_alloyquery,node_alloyreader,node_alloycalc,node_smeltery,node_smelteryclick toneAmber
class node_detailview,node_casting,node_partcache toneMint
class node_favorites,node_search,node_pinyin,node_jei,node_config toneRose
class node_player toneIndigo
```

## Components

### Screen and interaction

- [Mod event entry](https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/TinkersSearch.java): `src/main/java/top/leipishu/tinkerssearch/TinkersSearch.java`
- [Search panel](https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/client/gui/FloatingSearchPanel.java): `src/main/java/top/leipishu/tinkerssearch/client/gui/FloatingSearchPanel.java`
- [Panel interactions](https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/client/gui/PanelInteractionHandler.java): `src/main/java/top/leipishu/tinkerssearch/client/gui/PanelInteractionHandler.java`
- [Search box](https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/client/gui/components/SearchBox.java): `src/main/java/top/leipishu/tinkerssearch/client/gui/components/SearchBox.java`
- [Animation manager](https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/client/animation/core/AnimationManager.java): `src/main/java/top/leipishu/tinkerssearch/client/animation/core/AnimationManager.java`

### Fluid and alloy data

- [Panel data](https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/client/gui/panel/PanelDataManager.java): `src/main/java/top/leipishu/tinkerssearch/client/gui/panel/PanelDataManager.java`
- [Alloy query](https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/alloy/AlloyQueryHandler.java): `src/main/java/top/leipishu/tinkerssearch/alloy/AlloyQueryHandler.java`
- [Alloy recipes](https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/alloy/TinkersAlloyReader.java): `src/main/java/top/leipishu/tinkerssearch/alloy/TinkersAlloyReader.java`
- [Alloy chain calculator](https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/alloy/AlloyResultCalculator.java): `src/main/java/top/leipishu/tinkerssearch/alloy/AlloyResultCalculator.java`
- [Smeltery fluid data](https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/smeltery/SmelteryDataHelper.java): `src/main/java/top/leipishu/tinkerssearch/smeltery/SmelteryDataHelper.java`
- [Fluid movement](https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/smeltery/SmelteryClickHandler.java): `src/main/java/top/leipishu/tinkerssearch/smeltery/SmelteryClickHandler.java`

### Recipes and details

- [Fluid detail screen](https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/client/gui/FluidDetailScreen.java): `src/main/java/top/leipishu/tinkerssearch/client/gui/FluidDetailScreen.java`
- [Casting recipe lookup](https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/recipe/CastingRecipeHelper.java): `src/main/java/top/leipishu/tinkerssearch/recipe/CastingRecipeHelper.java`
- [Fluid part cache](https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/data/FluidPartDataCache.java): `src/main/java/top/leipishu/tinkerssearch/data/FluidPartDataCache.java`

### Preferences and integrations

- [Favorites](https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/data/FavoritesManager.java): `src/main/java/top/leipishu/tinkerssearch/data/FavoritesManager.java`
- [Fluid search](https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/utils/SearchHelper.java): `src/main/java/top/leipishu/tinkerssearch/utils/SearchHelper.java`
- [Pinyin matching](https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/utils/pinyin/PinyinSearch.java): `src/main/java/top/leipishu/tinkerssearch/utils/pinyin/PinyinSearch.java`
- [JEI integration](https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/jei/Jei.java): `src/main/java/top/leipishu/tinkerssearch/jei/Jei.java`
- [Panel configuration](https://github.com/leipishu/tinkerssearch/blob/master/src/main/java/top/leipishu/tinkerssearch/config/PanelConfig.java): `src/main/java/top/leipishu/tinkerssearch/config/PanelConfig.java`

### Other components

- **Player**

## Connections

- Player → Search panel: browses (evidence: `README.md`)
- Mod event entry → Search panel: registers on screen (evidence: `src/main/java/top/leipishu/tinkerssearch/TinkersSearch.java`)
- Mod event entry → Animation manager: updates (evidence: `src/main/java/top/leipishu/tinkerssearch/TinkersSearch.java`)
- Search panel → Panel interactions: delegates input (evidence: `src/main/java/top/leipishu/tinkerssearch/client/gui/FloatingSearchPanel.java`)
- Search panel → Panel data: reads list data (evidence: `src/main/java/top/leipishu/tinkerssearch/client/gui/FloatingSearchPanel.java`)
- Search panel → Alloy query: queries alloys (evidence: `src/main/java/top/leipishu/tinkerssearch/client/gui/FloatingSearchPanel.java`)
- Panel interactions → Search box: handles text input (evidence: `src/main/java/top/leipishu/tinkerssearch/client/gui/PanelInteractionHandler.java`)
- Panel interactions → JEI integration: requests lookup (evidence: `src/main/java/top/leipishu/tinkerssearch/client/gui/PanelInteractionHandler.java`)
- Panel data → Alloy query: loads alloy data (evidence: `src/main/java/top/leipishu/tinkerssearch/client/gui/panel/PanelDataManager.java`)
- Panel data → Smeltery fluid data: loads fluids (evidence: `src/main/java/top/leipishu/tinkerssearch/client/gui/panel/PanelDataManager.java`)
- Panel data → Favorites: loads favorites (evidence: `src/main/java/top/leipishu/tinkerssearch/client/gui/panel/PanelDataManager.java`)
- Panel data → Fluid search: filters fluids (evidence: `src/main/java/top/leipishu/tinkerssearch/client/gui/panel/PanelDataManager.java`)
- Alloy query → Alloy recipes: loads recipes (evidence: `src/main/java/top/leipishu/tinkerssearch/alloy/AlloyQueryHandler.java`)
- Alloy query → Alloy chain calculator: calculates results (evidence: `src/main/java/top/leipishu/tinkerssearch/alloy/AlloyQueryHandler.java`)
- Alloy recipes → Alloy chain calculator: provides recipes
- Fluid search → Pinyin matching: matches pinyin (evidence: `src/main/java/top/leipishu/tinkerssearch/utils/SearchHelper.java`)
- Search panel → Fluid detail screen: opens details (evidence: `src/main/java/top/leipishu/tinkerssearch/client/gui/FloatingSearchPanel.java`)
- Fluid detail screen → Casting recipe lookup: shows casting (evidence: `src/main/java/top/leipishu/tinkerssearch/client/gui/FluidDetailScreen.java`)
- Casting recipe lookup → Fluid part cache: checks requirements (evidence: `src/main/java/top/leipishu/tinkerssearch/recipe/CastingRecipeHelper.java`)
- Panel interactions → Fluid movement: moves fluid
- Search panel → Panel configuration: uses layout settings (evidence: `src/main/java/top/leipishu/tinkerssearch/client/gui/FloatingSearchPanel.java`)
- Search panel → Animation manager: animates panel
