JEI Trim Hider

*** # 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 文件放入整合包内，玩家下载整合包即可使用。