🩹 Mystical Realms Modpack Fixes

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

✨ Overview

Mystical Realms Modpack 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 Nether return portals — the return trip sends you back through the portal you actually came from, not whichever one happens to be closest Better Party — a corrupted max_health attribute no longer crashes the whole dedicated server mid-tick Corrupted health/absorption — a stray NaN/Infinity value can no longer get an entity permanently stuck; it's rejected outright, and saves already affected self-heal on load Better Villager Animations — an optional Spanish overlay for its hardcoded villager dialogue

🎯 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.

🔥 Nether return-portal fix

Vanilla sends a returning traveller to the closest existing portal at the scaled destination coordinates. When two portals sit near the same coordinates in the other dimension, the return trip can drop you at the wrong one. This fix remembers, per entity, which exit portal was paired with the portal you entered, and reuses it on the way back.

• Applies to Overworld↔Nether travel in both directions; other portal types are untouched
• Falls back to vanilla search when the remembered portal no longer exists
• The mapping is kept in memory only — it resets on a server or world reload

🛡️ Better Party member-health crash guard

Better Party builds each party member's HUD health from their vanilla health and max-health. Its PartyMemberHealth record throws an uncaught IllegalArgumentException whenever a player's generic.max_health is momentarily ≤ 0 or non-finite. That exception escapes the event bus and crashes the entire dedicated server mid-tick — for every player online — the instant a single player's attribute is corrupted. This patch sanitises the two health reads that feed the record and substitutes a safe finite value, logging a warning instead of taking the server down.

• Server-side only; activates only when Better Party is present
• Covers both the login and logout sync paths, so a bad value can no longer prevent a player from joining or stop the server
• It does not fix whatever corrupts the attribute in the first place — it only stops that corruption from killing the server

❤️ NaN/Infinity health & absorption guard

Some combat mods compute damage as a percentage of an entity's current health. If that percentage attribute is ever driven to Infinity by a bad affix roll, and the target's health happens to land on exactly 0 at that instant, the multiplication produces NaN — a value vanilla can never compare or reduce below zero, so the entity gets stuck: unkillable, unhealable, permanently broken, and the corruption survives every save. This patch guards the two vanilla setters that write health and absorption directly.

• Always on, client and server; no configuration
• Rejects any non-finite write before it reaches the entity's actual state, keeping the last good value
• Self-heals a player or mob that was already saved with corrupted health/absorption — no manual save editing needed, it recovers the moment it loads
• Does not patch whichever mod produced the bad value in the first place; it only hardens vanilla against receiving it

💀 Dangerous NeoForge boss health scaling fix

Dangerous NeoForge scales monster max health over time using a day-elapsed multiplier, and does this correctly for regular mobs by caching their true base health once and always recomputing trueBase × currentMultiplier. Its "boss" branch — taken for any mob whose saved NBT carries apotheosis:tier_augments_applied, i.e. any Apotheosis rarity-affixed mob — reads the mob's current, already-scaled max health instead of the true base and multiplies it again by the new factor, so every subsequent rescale compounds on top of the last one instead of scaling linearly. Left alone, Apotheosis-boosted mobs' health balloons exponentially the longer a world survives.

• Server-side only; activates only when Dangerous NeoForge is present
• Reuses the same base-health cache Dangerous NeoForge's own non-boss branch already relies on, so boss mobs scale linearly like every other mob
• Does not modify the Dangerous NeoForge jar — patched entirely via a soft mixin that only applies when that mod is loaded

💬 Better Villager Animations Spanish dialogue overlay

Better Villager Animations keeps its speech-bubble flavour text as hardcoded Java string literals, so ordinary lang files cannot translate it. This patch routes its two dialogue select(…) methods through a translation table and swaps the English line for Spanish whenever a matching entry exists.

• Client-side only; activates only when Better Villager Animations is present
• Applies to es_es only — English and every other language are left completely untouched
• The translation table is not bundled: it is read from a separately installed resource pack at assets/bettervillageranimations/dialogue/es_es.json, and reloads with resource packs. With no pack installed the overlay is a silent no-op.

⚙️ Configuration Reference

File: config/mystical_realms_modpack_fixes/config.toml

The Iris/Sodium, Better Party, NaN/Infinity health guard and Better Villager Animations patches have no configuration — they activate automatically (the health guard is always on) and are inert otherwise.

📋 Requirements

🎮 How to Use

1. Install NeoForge 21.1.249 for Minecraft 1.21.1.
2. Place Mystical Realms Modpack 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, or to toggle individual fixes, edit config/mystical_realms_modpack_fixes/config.toml ([logfilter] and [fixes]).
5. Optional: for the Spanish villager dialogue overlay, install a resource pack that provides assets/bettervillageranimations/dialogue/es_es.json.

🙏 Credits

Developed by Stalking Dragons.

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