JEI Trim Hider

[English Description]

Tired of scrolling through thousands of Smithing Trim recipes in JEI? Is your game lagging whenever you look up the usage of a chestplate?

JEI Trim Hider is a lightweight client-side JEI addon designed to clean up the clutter caused by the 1.20+ Armor Trim system. It intelligently hides decorative trim templates and their recipes, while keeping important functional upgrades (like Netherite Upgrades) visible.

✨ Key Features

• Smart Filtering: Automatically detects and hides "Decorative Trim" templates from the JEI item list and recipe viewer.
• Safety First: Strictly preserves Functional Upgrades (e.g., Netherite Upgrade, AllTheModium Upgrades). If a template changes the item's ID or stats, it will remain visible!
• Info Tab Fallback: When a recipe is hidden, a JEI "Information" (i) tab is added to the item, explaining how to use it. This ensures players still know the item's purpose without loading 50 pages of recipes.
• Configurable:
  • Hot Reload: Change settings in-game without restarting! Just edit the config and tab back in (Please read the Forge and Fabric warnings below).
  • Blacklist/Whitelist: Manually force items (by ID) to be hidden or shown to handle edge cases in modpacks.
• Global Support: Built-in localization for 21 languages!

⚙️ Configuration

You can find the config file at .minecraft/config/jei_trim_hider/jei_trim_hider-client.toml.

• hideTemplateItems (Default: true): Hides the template item itself from the sidebar.
• hideTrimRecipes (Default: true): Hides the smithing recipes when you press 'U'.
• whitelist: List of Item IDs (e.g., ["minecraft:sentry_armor_trim_smithing_template"]) that will NEVER be hidden.
• blacklist: List of Item IDs that will ALWAYS be hidden (treated as trims).

⚠️ Warning

• Language Switch: If the player switches the game language midway, the language in the JEI Information tab will not switch automatically. You must re-enter the world (reload the save) to complete the language switch.
• (Fabric Version Only) No Automatic Hot Reload: The Fabric version does not support automatic hot reloading. If you want to synchronize configuration file changes while in-game, please type and use the /reload command.
• (Forge Version Only) Hot Reload Issues: Due to Forge's file loading mechanism and current technical limitations, modifying the configuration file too frequently in a very short time may cause the hot reload to fail or generate .bak files. Please DO NOT use text editors with real-time auto-saving features (such as VS Code, IntelliJ IDEA, etc.). We highly recommend using simple native editors like Windows Notepad. If you insist on using real-time saving editors, it is strongly advised NOT to edit the config while playing in a world. If the hot reload fails or JEI stops updating, please try re-entering the world (might not always work) or completely restarting the game. Note: The NeoForge version of this mod fully supports real-time config hot reloading and is NOT affected by this issue!

📦 Modpack Usage Permission

This mod can be freely included and bundled directly in any modpacks. You may put the .jar file inside your modpack.

[中文介绍]

受够了 JEI 里成千上万页的盔甲纹饰（Trim）配方吗？ 每次查询胸甲的用途（Usage）都会导致游戏卡顿？

JEI Trim Hider 是一个轻量级的 JEI 附属模组，专为解决 1.20+ 版本引入的锻造纹饰系统导致的 JEI 版面污染问题而生。它可以智能隐藏装饰性的纹饰模板及其配方，同时保留重要的功能性升级（如下界合金升级模板）。

✨ 核心功能

• 智能过滤：自动检测并隐藏“装饰性”的纹饰模板（Trim Templates）及其在 JEI 中的合成表。
• 安全识别：严格保留功能性升级（例如下界合金升级、ATM 模组的升级模板）。只要该模板能改变物品 ID 或属性，它就会被保留显示！
• 信息页补偿：当真实配方被隐藏时，模组会自动为该物品添加一个 JEI “信息 (i)” 标签页，用文字说明其用法。这样既净化了版面，又不会让萌新玩家以为该物品毫无用处。
• 高度可配置：
  • 热加载支持：无需重启游戏！修改配置文件后切回游戏，JEI 列表即刻刷新（Forge 与 Fabric 版玩家请务必阅读下方警告）。
  • 黑/白名单：支持通过物品 ID 强制隐藏或强制显示特定物品，方便整合包作者微调。
• 多语言支持：内置 21 种语言的本地化适配！

⚙️ 配置

配置文件位于 .minecraft/config/jei_trim_hider/jei_trim_hider-client.toml。

• hideTemplateItems (默认: true)：在 JEI 右侧搜索栏中隐藏纹饰模板物品。
• hideTrimRecipes (默认: true)：在查看用途（按U）时隐藏锻造台配方。
• whitelist：白名单。填写在此处的物品 ID 将永远不会被隐藏。
• blacklist：黑名单。填写在此处的物品 ID 将被强制隐藏（视为纹饰处理）。

⚠️ 警告

• 关于语言切换： 如果玩家在中途切换游戏语言，信息页（Info Tab）中的语言文字不会自动切换。必须重新进入存档（重载世界）才能完成语言的切换。
• 【Fabric 版独有】不支持自动热加载： Fabric 版本的配置文件不支持自动热加载。如果您想要在游戏中同步配置文件的修改，请输入 /reload 命令来进行重载同步。
• 【Forge 版独有】配置文件热加载失败问题： 由于 Forge 底层的文件读取机制以及作者目前的技术限制，如果在极短时间内频繁修改和保存配置文件，极易导致热加载失败，甚至生成配置文件损坏的 .bak 备份。请不要使用能够实时自动保存的文本编辑器（例如 VS Code、IntelliJ IDEA 等），强烈推荐使用 Windows 自带的“记事本（Notepad）”进行修改。如果您非要使用这些支持实时保存的高级软件，作者极度不推荐在游戏中（处于存档内）修改配置文件。如果已经出现了热加载失效或 JEI 卡死的问题，请尝试重新进入存档（有概率失效），或者直接重启整个游戏。注意：NeoForge 版本的本模组可以做到完美的实时配置热加载，完全不受此问题影响！

📦 整合包使用许可

本模组允许被任何整合包免费收录并直接打包分发。 欢迎直接把本模组 .jar 文件放入整合包内，玩家下载整合包即可使用。