ErythroCraft ClassloaderFix

Early ClassLoader Compatibility & Automatic Mod Repair for Minecraft

Version: 0.3.1 Beta
Mod Loader: NeoForge
Minecraft Version: 26.2
Developer: Hnterix
Developed by: ErythroCraft

Overview

ErythroCraft ClassloaderFix is an early-loading compatibility utility designed to identify and resolve specific Java ClassLoader conflicts and mod compatibility issues before they cause Minecraft to crash.

Modern Minecraft modpacks often combine different mod-loading environments, libraries, and compatibility layers. Especially when using Sinytra Connector, Fabric mods may encounter conflicts with NeoForge libraries or incompatible implementations of shared APIs.

ClassloaderFix aims to address these problems automatically while preserving the original mod files.

No manual JAR editing. No permanent modification of third-party mods.

Key Features

Early Mod Loading Integration

ClassloaderFix integrates into FancyModLoader's early service discovery process, allowing compatibility checks and supported repairs during mod discovery.

This helps resolve selected issues before the affected mods are initialized.

Automatic Compatibility Patching

For explicitly supported mod versions, ClassloaderFix can:

• Detect known library and ClassLoader conflicts.
• Identify incompatible embedded dependencies.
• Apply predefined compatibility corrections.
• Redirect affected mods to repaired runtime copies.
• Preserve the original mod JARs.

Intelligent Patch Cache

Instead of modifying the original files, ClassloaderFix generates compatible copies in a dedicated cache directory:

mods/.classloaderfix-cache/

These copies are used during Minecraft startup.

The original mods remain untouched, making the repair process easier to manage and reverse.

Version-Specific Safety Checks

ClassloaderFix uses SHA-256-based identification to match supported mod files.

This prevents compatibility patches intended for one specific build from being blindly applied to unrelated or unsupported versions.

Currently Supported Compatibility Fixes

Alchemistry + Connector Extras

Tested configuration:

This compatibility repair addresses known issues involving:

• Duplicate Forge configuration API classes.
• Conflicting IConfigSpec implementations.
• Incompatible configuration registry integration.
• Missing configuration service providers.

Verified results: Both original mod JARs were detected and redirected to compatible cached copies. Minecraft successfully started, loaded an existing world, and exited normally after saving.

How It Works

Minecraft Startup
       |
       v
FancyModLoader Early Services
       |
       v
ErythroCraft ClassloaderFix
       |
       +-- Identify supported mod versions
       |
       +-- Check known compatibility issues
       |
       +-- Generate or reuse compatible cache
       |
       +-- Redirect mod discovery
       |
       v
NeoForge + Sinytra Connector
       |
       v
Minecraft Initialization

Installation

1. Install the supported version of NeoForge.
2. Install Sinytra Connector and the required dependencies for your modpack.
3. Place the ClassloaderFix JAR inside your Minecraft mods folder.
4. Keep your supported third-party mods in their original, unmodified form.
5. Launch Minecraft normally.

ClassloaderFix automatically applies its predefined repairs when matching supported mod versions are detected.

Important Notes

ClassloaderFix is currently in beta.

• It is not a universal solution for every mod incompatibility.
• Only specifically implemented and supported fixes are available.
• Unsupported versions are not guaranteed to work.
• Compatibility patches may need updating when affected mods change.
• Back up your worlds before testing new mod combinations.

The current release focuses on proven, targeted compatibility repairs rather than unrestricted bytecode modification.

Future Development

Planned improvements include:

• Additional compatibility profiles.
• Improved ClassLoader conflict diagnostics.
• Detailed patch reports.
• Enhanced cache validation and recovery.
• Expanded support for known NeoForge and Fabric compatibility issues.

These features are development goals and are not necessarily available in the current release.

Credits

Project: ErythroCraft ClassloaderFix
Developer: Hnterix
Organization: ErythroCraft

ClassloaderFix is an independent compatibility utility and is not an official component of NeoForge, Sinytra Connector, Alchemistry, or Connector Extras.

ErythroCraft ClassloaderFix — Detect. Adapt. Load.