Tinkers‘ Search

🔍 Tinker’s Search

📖 中文

📦 关于

Tinker’s Search 是一个 匠魂 (Tinkers’ Construct) 模组的辅助扩展，为冶炼炉界面添加了流体搜索、合金查询与快速交互功能。

😊 支持版本

Tinker’s Search 支持 匠魂 (Tinkers’ Construct) 的所有版本（包括 1.18.2 / 1.19.2 / 1.20.1）。

✨ 功能特性

• 🔎 流体搜索 – 在冶炼炉界面中快速搜索熔融流体
• 🈶 拼音搜索 – 支持全拼和首字母搜索（如输入 tong、t 可匹配「铜」）
• 📑 三 Tab 页面 – 冶炼炉 / 材料 / 合金，一键切换
• 🧪 合金查询 – 独立合金 Tab，输入材料名即可查询合金配方、执行次数、后续可延伸合金链，并实时判断当前冶炼炉是否满足条件
• 📚 全部材料 – 独立材料 Tab，列出所有与合金相关的流体；未在冶炼炉中的流体显示 locked 状态，不可移动
• 📋 卡片式展示 – 清晰展示每种流体的图标、名称和数量
• 🔍 流体详情页 – 右键流体卡片打开悬浮详情窗口，展示浇筑配方、可制作部件、属性与词条。悬浮窗口不关闭冶炼炉界面，可继续浏览其他流体
• ⭐ 收藏系统 – 卡片右上角星标一键收藏，收藏区独立展示
• 🖱️ JEI 集成 – 左键/右键点击流体卡片图标可快速查询 JEI 配方/用途（JEI 为可选前置）
• 🔖 书签支持 – 按 A 键将流体添加到 JEI 书签（仅 1.18.2，1.19.2 及 1.20.1 暂不支持）
• 🔄 一键刷新 – 手动刷新流体列表
• 📜 滚动查看 – 支持滚动浏览大量流体

🎮 操作指南

| 操作 | 功能 |
|—|—|
| 点击左侧 Tab 按钮 | 打开/关闭搜索面板 |
| 点击面板顶部 Tab | 切换冶炼炉 / 材料 / 合金页面 |
| 搜索框输入 | 按名称或拼音过滤（支持全拼、首字母） |
| 左键点击卡片图标 | 查看 JEI 配方（需要 JEI） |
| 右键点击卡片图标 | 查看 JEI 用途（需要 JEI） |
| 左键点击卡片主体 | 将流体移至冶炼炉底部（locked 状态时拦截） |
| 右键点击卡片主体 | 打开流体详情悬浮窗口 |
| 点击卡片右上角星标 | 收藏/取消收藏该流体 |
| 按 A 键（鼠标悬停图标时） | 添加到 JEI 书签（需要 JEI） |
| 详情页滚动 / 翻页 / 搜索 | 浏览更多部件与浇筑配方 |

⚙️ 前置要求

| 模组 | 必需 | 说明 |
|—|—|—|
| Tinkers’ Construct | ✅ 必需 | 核心依赖 |
| Mantle | ✅ 必需 | Tinkers’ Construct 前置 |
| JEI (Just Enough Items) | ❌ 可选 | 提供配方查询和书签功能 |

💡 没有 JEI 也能正常使用搜索、拼音、详情页和流体移动功能，只是无法使用 JEI 相关的交互。

📥 下载

提供两个版本，功能完全相同，唯一区别是是否内置拼音支持：

| 版本 | 文件后缀 | 拼音搜索 | 文件体积 | 推荐场景 |
|—|—|—|———-|—|
| 完整版 | 无后缀 | ✅ | 约 520 KB | 默认选择，开箱即用 |
| 精简版 | -lite | ❌ | 约 215 KB | 不想为拼音功能多占体积，且搜索以中文/英文原文字面匹配为主 |

💡 Lite 版本只是不包含拼音搜索功能，其他所有功能（Tab 切换、合金查询、全部材料、详情页、收藏、JEI 集成、书签等）完全一致。

💡 完整版内置 pinyin4j（Jar-in-Jar 打包），无需单独安装；Lite 版本则不打包 pinyin4j，体积更小。

🛠️ 开发构建

git clone https://github.com/leipishu/TinkersSearch.git
cd TinkersSearch

# 构建完整版（含 pinyin4j）
./gradlew build

# 构建 Lite 版（不含 pinyin4j）
./gradlew build -PincludePinyin4j=false

构建产物位于 build/libs/ 目录。

📄 许可证

本项目采用 GNU Lesser General Public License v3.0 开源协议。

详见 LICENSE.txt。

🙏 致谢

• Tinkers’ Construct – 提供冶炼炉 API
• JEI – 提供配方查询接口
• Mantle – Tinkers’ Construct 前置库
• pinyin4j – 提供汉字转拼音支持（仅完整版内置）
• 所有反馈问题和提出建议的用户

📞 联系方式

• 作者: Leipishu
• Issue Tracker: GitHub Issues

📖 English

📦 About

Tinker’s Search is an addon for Tinkers’ Construct that adds fluid search, alloy query, and quick interaction features to the Smeltery GUI.

😊 Supported Versions

Tinker’s Search supports all versions of Tinkers’ Construct (including 1.18.2 / 1.19.2 / 1.20.1).

✨ Features

• 🔎 Fluid Search – Quickly search molten fluids in the Smeltery GUI
• 🈶 Pinyin Search – Supports full pinyin and initials (e.g. tong or t matches “铜”)
• 📑 Three Tabs – Smeltery / Materials / Alloy, switch with one click
• 🧪 Alloy Query – Dedicated Alloy tab: enter a material name to query alloy recipes, craft count, chain results, and real-time feasibility
• 📚 All Materials – Dedicated Materials tab listing all alloy-relevant fluids; fluids not in the Smeltery show as locked and cannot be moved
• 📋 Card Display – Clear display of each fluid’s icon, name, and amount
• 🔍 Fluid Detail Screen – Right-click a fluid card to open a floating detail window showing casting recipes, craftable parts, stats, and traits. Does not close the Smeltery GUI, allowing you to keep browsing other fluids
• ⭐ Favorites – Star icon in the top-right of each card; dedicated favorites section
• 🖱️ JEI Integration – Left/right click fluid card icons to view JEI recipes/uses (JEI optional)
• 🔖 Bookmark Support – Press A to add fluids to JEI bookmarks (only for 1.18.2; 1.19.2 and 1.20.1 not yet supported)
• 🔄 One-Click Refresh – Manually refresh the fluid list
• 📜 Scroll Support – Scroll through large fluid lists

🎮 Controls

| Action | Function |
|—|—|
| Click left Tab button | Open/close the search panel |
| Click top Tab | Switch between Smeltery / Materials / Alloy |
| Search box input | Filter by name or pinyin (full pinyin, initials) |
| Left click card icon | View JEI recipe (requires JEI) |
| Right click card icon | View JEI uses (requires JEI) |
| Left click card body | Move fluid to bottom of Smeltery (blocked when locked) |
| Right click card body | Open fluid detail window |
| Click star icon | Toggle favorite |
| Press A (hovering icon) | Add to JEI bookmarks (requires JEI) |
| Detail screen scroll / page / search | Browse more parts and casting recipes |

⚙️ Requirements

| Mod | Required | Note |
|—|—|—|
| Tinkers’ Construct | ✅ Required | Core dependency |
| Mantle | ✅ Required | Tinkers’ Construct dependency |
| JEI (Just Enough Items) | ❌ Optional | Provides recipe lookup and bookmarks |

💡 The mod works fine without JEI for search, pinyin, detail screen, and fluid movement. Only JEI-related interactions are disabled.

📥 Download

Two builds are available. They are functionally identical except for whether pinyin support is bundled:

| Build | File Suffix | Pinyin Search | File Size | Recommended For |
|—|—|—|———–|—|
| Full | (none) | ✅ | ~520 KB | Default choice, works out of the box |
| Lite | -lite | ❌ | ~215 KB | Users who don’t want the extra pinyin size and prefer literal text matching |

💡 The Lite build only omits pinyin search. Every other feature (Tab switching, alloy query, all materials, detail screen, favorites, JEI integration, bookmarks, etc.) is fully included.

💡 The Full build bundles pinyin4j via Jar-in-Jar — no separate installation needed. The Lite build does not include pinyin4j, resulting in a smaller file size.

🛠️ Development Build

git clone https://github.com/leipishu/TinkersSearch.git
cd TinkersSearch

# Build Full (with pinyin4j)
./gradlew build

# Build Lite (without pinyin4j)
./gradlew build -PincludePinyin4j=false

Build artifacts are located in build/libs/.

📄 License

This project is licensed under the GNU Lesser General Public License v3.0.

See LICENSE.txt for details.

🙏 Credits

• Tinkers’ Construct – Smeltery API
• JEI – Recipe lookup API
• Mantle – Tinkers’ Construct library
• pinyin4j – Chinese pinyin conversion support (bundled in Full build only)
• All users who reported issues and suggested features

📞 Contact

• Author: Leipishu
• Issue Tracker: GitHub Issues

⚠️ Note: Tinker’s Search and Tinkers’ Construct are two separate mods. Please do not confuse them.

⚠️ 注意: Tinker’s Search 与 Tinkers’ Construct 是两个独立的模组，请勿混淆。

Made with ❤️ by Leipishu