🩹 Utility Nexus Fixes

A small patch mod that stops known third-party crashes and quiets the harmless log spam left behind when a modpack's mod list changes.

✨ Overview

Utility Nexus Fixes collects targeted compatibility and log-noise patches so packs don't have to hunt for a matching set of mod versions, or live with a console full of errors that don't matter. Every patch is a no-op when the thing it targets isn't there — nothing is bundled and nothing is a hard dependency. Built for NeoForge 21.1.249 on Minecraft 1.21.1. What it covers: Iris / Sodium — fixes the SodiumGameOptions$PerformanceSettings startup crash from the Iris 1.8.12 × Sodium 0.8.13+ class rename Broken entity names — a malformed CustomName no longer throws once per tick with a stack trace Stale-save log spam — a configurable filter drops known-harmless lines left over after a mod-list change

🎯 Features

🌕 Iris / Sodium compat patch

Fixes a startup crash (MixinTransformerError / ClassNotFoundException: SodiumGameOptions$PerformanceSettings) that occurs when Iris 1.8.12's bundled Sodium-compat mixins target a class name (SodiumGameOptions) that Sodium renamed to SodiumOptions in 0.8.13+.

• Both mods are treated as optional dependencies — the patch only activates when both are present
• Client-side only; nothing changes on a server or when Iris/Sodium are absent

🏷️ Lenient entity CustomName parsing

Stops the endless Failed to parse entity custom name warning — with a full stack trace, once per tick — that a datapack tick function can trigger when it writes a malformed CustomName to an entity (for example an unquoted string instead of a JSON text component).

• The bad value falls back to plain text instead of throwing, so the entity still gets a readable name
• Implemented as a targeted mixin on the vanilla load path; valid names are untouched

🔇 Configurable benign-log filter

Drops a small, config-controlled allow-list of harmless log lines produced by stale save data after a mod-list change. Everything not on the list is left completely alone, and the filter never touches this mod's own logging.

• Default patterns: Tried to load invalid item: 'Item must not be minecraft:air', unknown-item and unknown-fluid registry keys, and Ignoring unknown attribute 'forge:…'
• Fully editable — add or remove substrings, or switch the whole filter off

Note: the forge: attribute lines come from old entity data using Forge-era attribute ids that NeoForge renamed. The filter only silences the warning; the stale modifier values themselves (from removed mods) are dropped by the game as before.

⚙️ Configuration Reference

File: config/utility_nexus/fixes/config.toml

📋 Requirements

🎮 How to Use

1. Install NeoForge 21.1.249 for Minecraft 1.21.1.
2. Place Utility Nexus Fixes in your mods folder.
3. No setup required — every patch applies automatically when its target is detected.
4. To keep or drop different log lines, edit [logfilter] in config/utility_nexus/fixes/config.toml.

🙏 Credits

Developed by Stalking Dragons.

https://codex.skdragons.com/
Codex Stalking Dragons — Minecraft Modding