Перейти к содержимому
Mineforgian

Mixin Helper

Utility mod for modpack developers that provides complete control over mixin behavior

Загрузки
2K
Подписчики
4
Обновлён
12 июня 2026 г.
Лицензия
GPL-3.0-only

Опубликован 22 марта 2026 г.

Исходный кодСообщить об ошибке

Mixin Helper

Take control of mixin conflicts in your modpack. Mixin Helper lets you blacklist, prioritize, and surgically modify mixins from any loaded mod — all from a single JSON config file. No code, no recompiling, no removing mods.

Documentation

Full documentation, guides, and examples at https://tysontheember.dev/mixin-helper/intro/

⚠️ USE AT YOUR OWN RISK ⚠️

This is an advanced tool. If you don't know what mixins are or how they work, this mod is not for you.

While there are guardrails Mixin Helper directly interferes with how other mods patch the game. Incorrect use will break things. This includes but is not limited to:

  • Game crashes with difficult-to-diagnose stacktraces
  • Broken mod features that may not be immediately obvious
  • World corruption — back up your worlds before making changes
  • Incompatible save files if disabled mixins affect world data

Do NOT report bugs to mod authors if you have modified their mixins with this tool. Any issues caused by Mixin Helper are your responsibility.

Features

  • Mixin Blacklisting — Disable individual mixins, entire mixin configs, or block all mixins targeting a specific class
  • Priority Control — Override mixin execution order to resolve load-order conflicts between mods
  • Method Removal — Neutralize or remove specific injected methods without disabling the entire mixin
  • Audit Report — Generate a detailed JSON report of every loaded mixin config, including annotations, to diagnose conflicts fast

Supported Versions

Minecraft Version Loader Status
1.20.1 Forge Fully Supported
1.20.1 Fabric Fully Supported
1.21.1 NeoForge Fully Supported
1.21.1 Fabric Fully Supported

How It Works

  1. Install Mixin Helper — drop the jar in your mods folder
  2. Launch the game — a default config is generated at config/mixinhelper.json
  3. Check the audit report at config/mixinhelper-report.json to see every mixin loaded in your game
  4. Edit the config to blacklist, reprioritize, or strip methods as needed
  5. Restart and you're done

Quick Example

Two mods crash because they both modify the same class? Blacklist the offending mixin:

{
  "enabled": true,
  "blacklist": {
    "mixins": ["com.conflictingmod.mixin.MixinLevelRenderer"],
    "mixinConfigs": [],
    "targetClasses": []
  }
}

Need finer control? Neutralize a single injected method instead of the whole mixin:

{
  "methodRemovals": {
    "rules": [
      {
        "targetClass": "net.minecraft.world.level.Level",
        "method": "brokenMethod",
        "action": "nop"
      }
    ]
  }
}

Use Cases

  • Modpack developers resolving mod conflicts without waiting for mod authors to fix them
  • Server admins disabling specific mod behaviors that cause instability
  • Debugging which mixins are causing crashes or unexpected behavior
  • Fine-tuning mod interactions by controlling execution order

Notes

  • Config changes require a full game restart — mixins load very early in startup
  • Mixin Helper itself has no mixins — it uses the Mixin plugin system to intercept other mods
  • Zero runtime performance impact — all work is done during startup

Ченджлог

1.1.1+neoforge-1211Релиз1.21.1 · 12 июня 2026 г.

v1.1.1

Fixed

  • Mixin names in the audit log are no longer recorded with a doubled dot before the class name (for example org.example.mixin..FooMixin). Mixin appends a trailing dot to the configured package internally; the audit log and the string-list blacklist matching now join the full name with a single separator, so annotation scanning and blacklist lookups resolve correctly.

v1.1.0

Added

  • Guardrails system to prevent accidental modifications to critical classes that could corrupt worlds or crash the JVM
    • Protects chunk generation classes (ChunkGenerator, NoiseBasedChunkGenerator, WorldGenRegion, LevelChunk, ChunkStatus)
    • Protects palette container classes (PalettedContainer, LinearPalette, HashMapPalette, Palette)
    • Protects mixin system internals (org.spongepowered.asm.*)
    • Protects JVM/classloader internals (java.lang.ClassLoader, sun.misc.Unsafe, jdk.internal.*)
    • Protects threading classes (BlockableEventLoop, TickTask)
    • Protects world persistence classes (LevelStorageSource, net.minecraft.nbt.*, LevelData)
  • New guardrails config section with:
    • enabled — master toggle (default: true)
    • bypassProtectedClasses — override protection at your own risk (default: false)
    • additionalProtectedPatterns — add your own protected class prefixes
    • excludeFromProtection — selectively unprotect specific classes (requires bypass)
  • Early config validation logs warnings at startup when protected classes are referenced
  • Guardrails block target-class blacklisting and method removal/nop on protected classes by default
1.1.1+forge-1201Релиз1.20.1 · 12 июня 2026 г.

v1.1.1

Fixed

  • Mixin names in the audit log are no longer recorded with a doubled dot before the class name (for example org.example.mixin..FooMixin). Mixin appends a trailing dot to the configured package internally; the audit log and the string-list blacklist matching now join the full name with a single separator, so annotation scanning and blacklist lookups resolve correctly.

v1.1.0

Added

  • Guardrails system to prevent accidental modifications to critical classes that could corrupt worlds or crash the JVM
    • Protects chunk generation classes (ChunkGenerator, NoiseBasedChunkGenerator, WorldGenRegion, LevelChunk, ChunkStatus)
    • Protects palette container classes (PalettedContainer, LinearPalette, HashMapPalette, Palette)
    • Protects mixin system internals (org.spongepowered.asm.*)
    • Protects JVM/classloader internals (java.lang.ClassLoader, sun.misc.Unsafe, jdk.internal.*)
    • Protects threading classes (BlockableEventLoop, TickTask)
    • Protects world persistence classes (LevelStorageSource, net.minecraft.nbt.*, LevelData)
  • New guardrails config section with:
    • enabled — master toggle (default: true)
    • bypassProtectedClasses — override protection at your own risk (default: false)
    • additionalProtectedPatterns — add your own protected class prefixes
    • excludeFromProtection — selectively unprotect specific classes (requires bypass)
  • Early config validation logs warnings at startup when protected classes are referenced
  • Guardrails block target-class blacklisting and method removal/nop on protected classes by default
1.1.1+fabric-1211Релиз1.21.1 · 12 июня 2026 г.

v1.1.1

Fixed

  • Mixin names in the audit log are no longer recorded with a doubled dot before the class name (for example org.example.mixin..FooMixin). Mixin appends a trailing dot to the configured package internally; the audit log and the string-list blacklist matching now join the full name with a single separator, so annotation scanning and blacklist lookups resolve correctly.

v1.1.0

Added

  • Guardrails system to prevent accidental modifications to critical classes that could corrupt worlds or crash the JVM
    • Protects chunk generation classes (ChunkGenerator, NoiseBasedChunkGenerator, WorldGenRegion, LevelChunk, ChunkStatus)
    • Protects palette container classes (PalettedContainer, LinearPalette, HashMapPalette, Palette)
    • Protects mixin system internals (org.spongepowered.asm.*)
    • Protects JVM/classloader internals (java.lang.ClassLoader, sun.misc.Unsafe, jdk.internal.*)
    • Protects threading classes (BlockableEventLoop, TickTask)
    • Protects world persistence classes (LevelStorageSource, net.minecraft.nbt.*, LevelData)
  • New guardrails config section with:
    • enabled — master toggle (default: true)
    • bypassProtectedClasses — override protection at your own risk (default: false)
    • additionalProtectedPatterns — add your own protected class prefixes
    • excludeFromProtection — selectively unprotect specific classes (requires bypass)
  • Early config validation logs warnings at startup when protected classes are referenced
  • Guardrails block target-class blacklisting and method removal/nop on protected classes by default
1.1.1+fabric-1201Релиз1.20.1 · 12 июня 2026 г.

v1.1.1

Fixed

  • Mixin names in the audit log are no longer recorded with a doubled dot before the class name (for example org.example.mixin..FooMixin). Mixin appends a trailing dot to the configured package internally; the audit log and the string-list blacklist matching now join the full name with a single separator, so annotation scanning and blacklist lookups resolve correctly.

v1.1.0

Added

  • Guardrails system to prevent accidental modifications to critical classes that could corrupt worlds or crash the JVM
    • Protects chunk generation classes (ChunkGenerator, NoiseBasedChunkGenerator, WorldGenRegion, LevelChunk, ChunkStatus)
    • Protects palette container classes (PalettedContainer, LinearPalette, HashMapPalette, Palette)
    • Protects mixin system internals (org.spongepowered.asm.*)
    • Protects JVM/classloader internals (java.lang.ClassLoader, sun.misc.Unsafe, jdk.internal.*)
    • Protects threading classes (BlockableEventLoop, TickTask)
    • Protects world persistence classes (LevelStorageSource, net.minecraft.nbt.*, LevelData)
  • New guardrails config section with:
    • enabled — master toggle (default: true)
    • bypassProtectedClasses — override protection at your own risk (default: false)
    • additionalProtectedPatterns — add your own protected class prefixes
    • excludeFromProtection — selectively unprotect specific classes (requires bypass)
  • Early config validation logs warnings at startup when protected classes are referenced
  • Guardrails block target-class blacklisting and method removal/nop on protected classes by default
1.1.0+forge-1201Релиз1.20.1 · 23 марта 2026 г.

Added

  • Guardrails system to prevent accidental modifications to critical classes that could corrupt worlds or crash the JVM
    • Protects chunk generation classes (ChunkGenerator, NoiseBasedChunkGenerator, WorldGenRegion, LevelChunk, ChunkStatus)
    • Protects palette container classes (PalettedContainer, LinearPalette, HashMapPalette, Palette)
    • Protects mixin system internals (org.spongepowered.asm.*)
    • Protects JVM/classloader internals (java.lang.ClassLoader, sun.misc.Unsafe, jdk.internal.*)
    • Protects threading classes (BlockableEventLoop, TickTask)
    • Protects world persistence classes (LevelStorageSource, net.minecraft.nbt.*, LevelData)
  • New guardrails config section with:
    • enabled — master toggle (default: true)
    • bypassProtectedClasses — override protection at your own risk (default: false)
    • additionalProtectedPatterns — add your own protected class prefixes
    • excludeFromProtection — selectively unprotect specific classes (requires bypass)
  • Early config validation logs warnings at startup when protected classes are referenced
  • Guardrails block target-class blacklisting and method removal/nop on protected classes by default
1.1.0+fabric-1211Релиз1.21.1 · 23 марта 2026 г.

Added

  • Guardrails system to prevent accidental modifications to critical classes that could corrupt worlds or crash the JVM
    • Protects chunk generation classes (ChunkGenerator, NoiseBasedChunkGenerator, WorldGenRegion, LevelChunk, ChunkStatus)
    • Protects palette container classes (PalettedContainer, LinearPalette, HashMapPalette, Palette)
    • Protects mixin system internals (org.spongepowered.asm.*)
    • Protects JVM/classloader internals (java.lang.ClassLoader, sun.misc.Unsafe, jdk.internal.*)
    • Protects threading classes (BlockableEventLoop, TickTask)
    • Protects world persistence classes (LevelStorageSource, net.minecraft.nbt.*, LevelData)
  • New guardrails config section with:
    • enabled — master toggle (default: true)
    • bypassProtectedClasses — override protection at your own risk (default: false)
    • additionalProtectedPatterns — add your own protected class prefixes
    • excludeFromProtection — selectively unprotect specific classes (requires bypass)
  • Early config validation logs warnings at startup when protected classes are referenced
  • Guardrails block target-class blacklisting and method removal/nop on protected classes by default
1.1.0+fabric-1201Релиз1.20.1 · 23 марта 2026 г.

Added

  • Guardrails system to prevent accidental modifications to critical classes that could corrupt worlds or crash the JVM
    • Protects chunk generation classes (ChunkGenerator, NoiseBasedChunkGenerator, WorldGenRegion, LevelChunk, ChunkStatus)
    • Protects palette container classes (PalettedContainer, LinearPalette, HashMapPalette, Palette)
    • Protects mixin system internals (org.spongepowered.asm.*)
    • Protects JVM/classloader internals (java.lang.ClassLoader, sun.misc.Unsafe, jdk.internal.*)
    • Protects threading classes (BlockableEventLoop, TickTask)
    • Protects world persistence classes (LevelStorageSource, net.minecraft.nbt.*, LevelData)
  • New guardrails config section with:
    • enabled — master toggle (default: true)
    • bypassProtectedClasses — override protection at your own risk (default: false)
    • additionalProtectedPatterns — add your own protected class prefixes
    • excludeFromProtection — selectively unprotect specific classes (requires bypass)
  • Early config validation logs warnings at startup when protected classes are referenced
  • Guardrails block target-class blacklisting and method removal/nop on protected classes by default
1.1.0+neoforge-1211Релиз1.21.1 · 23 марта 2026 г.

Added

  • Guardrails system to prevent accidental modifications to critical classes that could corrupt worlds or crash the JVM
    • Protects chunk generation classes (ChunkGenerator, NoiseBasedChunkGenerator, WorldGenRegion, LevelChunk, ChunkStatus)
    • Protects palette container classes (PalettedContainer, LinearPalette, HashMapPalette, Palette)
    • Protects mixin system internals (org.spongepowered.asm.*)
    • Protects JVM/classloader internals (java.lang.ClassLoader, sun.misc.Unsafe, jdk.internal.*)
    • Protects threading classes (BlockableEventLoop, TickTask)
    • Protects world persistence classes (LevelStorageSource, net.minecraft.nbt.*, LevelData)
  • New guardrails config section with:
    • enabled — master toggle (default: true)
    • bypassProtectedClasses — override protection at your own risk (default: false)
    • additionalProtectedPatterns — add your own protected class prefixes
    • excludeFromProtection — selectively unprotect specific classes (requires bypass)
  • Early config validation logs warnings at startup when protected classes are referenced
  • Guardrails block target-class blacklisting and method removal/nop on protected classes by default

Комментарии

Загружаем…