JEI Trim Hider

JEI Trim Hider

\[英文介绍\]

厌倦了在 JEI 中翻阅成千上万条锻造纹饰配方吗？ 每次查询胸甲的用途时，游戏都会卡顿吗？

JEI Trim Hider 是一款轻量级客户端 JEI 附属模组，旨在清理 1.20+ 版本盔甲纹饰系统带来的杂乱内容。它能智能隐藏装饰性纹饰模板及其配方，同时保留重要的功能性升级（如下界合金升级）。

✨ 核心功能

• 智能筛选： 自动检测并隐藏 JEI 物品列表和配方查看器中的“装饰性纹饰”模板。
• 安全优先：严格保留功能性升级（例如下界合金升级、AllTheModium 升级）。如果模板会改变物品 ID 或属性，就会继续显示！
• 信息标签页备用方案：隐藏配方时，会在物品上添加 JEI“信息”（i）标签页，说明物品的用途。这样玩家无需加载 50 页配方，也能了解物品的作用。
• 可配置：
• 热重载：无需重启，即可在游戏中更改设置！只需编辑配置文件，然后切回游戏即可 _(请先阅读下方 Forge 和 Fabric 版本的警告)_。
• 黑名单/白名单：可按物品 ID 手动指定要隐藏或显示的物品，以处理整合包中的特殊情况。
• 全球支持：内置21 种语言的本地化！

⚙️ 配置

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

• hideTemplateItems（默认：true）：从侧边栏隐藏模板物品本身。
• hideTrimRecipes（默认：true）：按下“U”时隐藏锻造配方。
• whitelist：物品 ID 列表（例如["minecraft:sentry_armor_trim_smithing_template"]），这些物品永远不会被隐藏。
• blacklist：物品 ID 列表，这些物品始终会被隐藏（视为纹饰）。

⚠️ 警告

• 切换语言：如果玩家在游戏过程中途切换语言，JEI 信息标签页中的语言不会自动切换。必须重新进入世界（重新加载存档）才能完成语言切换。
• （仅限 Fabric 版本）不支持自动热重载：Fabric 版本不支持自动热重载。如果想在游戏过程中同步配置文件的更改，请输入并使用/reload命令。
• （仅限 Forge 版本）热重载问题：由于 Forge 的文件加载机制和当前的技术限制，在很短的时间内过于频繁地修改配置文件，可能会导致热重载失败或生成.bak文件。请勿使用带有实时自动保存功能的文本编辑器（例如 VS Code、IntelliJ IDEA 等）。我们强烈建议使用简单的系统自带编辑器，例如Windows 记事本。如果你坚持使用实时保存的编辑器，强烈建议不要在游戏世界中编辑配置文件。如果热重载失败或 JEI 停止更新，请尝试重新进入世界（不一定总是有效），或彻底重启游戏。注意：此模组的 NeoForge 版本完全支持配置实时热重载，不受此问题影响！

📦 整合包使用许可

本模组可自由加入并直接打包进任何整合包。你可以将 .jar 文件放入整合包中。

\[中文介绍\]

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