实用工具节点修复

🧟 Utility Nexus Fixes

一个轻量补丁模组，用于阻止已知的第三方崩溃，并消除整合包中模组列表变化后遗留的无害日志刷屏。

✨ 概述

Utility Nexus Fixes 汇集了针对性的兼容性与日志噪音补丁，使整合包无需费力寻找匹配的模组版本组合，也不必忍受满屏无关紧要的错误日志。每个补丁在其针对的目标不存在时均为空操作 — 不捆绑任何内容，也无硬性依赖。专为 Minecraft 1.21.1 上的 NeoForge 21.1.249 构建。

涵盖内容：

• Iris / Sodium — 修复 Iris 1.8.12 × Sodium 0.8.13+ 类名重命名导致的 SodiumGameOptions$PerformanceSettings 启动崩溃
• 损坏的实体名称 — 格式错误的 CustomName 不再每秒抛出一次带堆栈跟踪的异常
• 过时存档日志刷屏 — 一个可配置的过滤器用于丢弃模组列表更改后遗留的已知无害日志行

🎯 功能特性

🗡️ Iris / Sodium 兼容性补丁

修复当 Iris 1.8.12 捆绑的 Sodium 兼容 Mixin 针对一个类名（SodiumGameOptions）而 Sodium 在 0.8.13+ 中已将其重命名为 SodiumOptions 时发生的启动崩溃（MixinTransformerError / ClassNotFoundException: SodiumGameOptions$PerformanceSettings）。

• 两个模组均被视为可选依赖 — 仅当两者同时存在时补丁才会激活
• 仅客户端生效；在服务器端或未安装 Iris/Sodium 时不做任何更改

🏷️ 宽松的实体 CustomName 解析

阻止无尽的 Failed to parse entity custom name 警告 — 附带完整堆栈跟踪，每秒一次 — 该警告由数据包的 tick 函数在向实体写入格式错误的 CustomName（例如未加引号的字符串而非 JSON 文本组件）时触发。

• 错误值将回退为纯文本而不是抛出异常，因此实体仍能获得可读的名称
• 作为针对原版加载路径的定向 Mixin 实现；合法名称不受影响

🧹 可配置的无害日志过滤器

丢弃由模组列表更改后过时的存档数据产生的一小部分、由配置控制的白名单无害日志行。不在列表中的内容完全不受影响，且该过滤器从不触碰本模组自身的日志。

• 默认模式：Tried to load invalid item: 'Item must not be minecraft:air'、未知物品与未知流体注册表键、以及 Ignoring unknown attribute 'forge:…'
• 完全可编辑 — 添加或删除子字符串，或完全关闭整个过滤器

注意：forge: 属性行来自使用 Forge 时代属性 ID 的旧实体数据，NeoForge 已将其重命名。过滤器仅屏蔽警告；过时的修饰符值本身（来自已移除的模组）仍像以前一样由游戏丢弃。

⚙️ 配置参考

文件：config/utility_nexus/fixes/config.toml

键	默认值	备注
[logfilter]
logfilter.enabled	true	无害日志过滤器的主开关。
logfilter.patterns	(4 条内置行)	区分大小写的子字符串列表；包含任一子字符串的日志消息将被丢弃。可自由编辑。

📋 需求

Minecraft	1.21.1
NeoForge	21.1.249+
Java	21

🎮 使用方法

1. 为 Minecraft 1.21.1 安装 NeoForge 21.1.249。
2. 将 Utility Nexus Fixes 放入你的 mods 文件夹。
3. 无需额外设置 — 每个补丁在检测到其目标时自动生效。
4. 要保留或丢弃不同的日志行，请编辑 config/utility_nexus/fixes/config.toml 中的 [logfilter]。

🙏 致谢

由 Stalking Dragons 开发。

https://codex.skdragons.com/

Codex Stalking Dragons — Minecraft Modding