MODS FIXER

The latest versions are previews and are still under active development. Some systems may be incomplete or may not work correctly in every modpack yet.

Mods Fixer is a compatibility, diagnostics, and optimization mod designed to detect and correct problems caused by other Minecraft mods.

Its long-term goal is much broader than fixing a specific type of incompatibility. Mods Fixer is intended to analyze problems originating inside mods and, whenever possible, correct their root cause while preserving the original functionality of the affected mods.

What does Mods Fixer do?

Minecraft modpacks can contain hundreds of mods made by different developers, using different systems and assumptions. This can create problems ranging from small performance issues to complete incompatibilities and crashes.

Mods Fixer is being developed to identify and handle problems such as:

• Mixin conflicts and incompatible code injections
• Conflicts between multiple mods modifying the same Minecraft systems
• Unnecessary or excessively expensive loops
• Repeated work that does not need to run every tick or frame
• Poorly optimized internal mod systems
• Unnecessarily complex processing pipelines
• Excessive calculations, scans, allocations, or updates
• Mod-specific performance problems
• Incorrect or unstable interactions between mods
• Crashes caused by mod incompatibilities
• Other problems originating from the implementation of individual mods

The objective is not simply to hide errors or disable problematic features.

Whenever possible, Mods Fixer should identify why a mod is causing a problem and find a safer or more efficient way for that mod to perform the same job.

Mod Compatibility

One of the main objectives of Mods Fixer is allowing mods that would normally conflict with each other to coexist.

Modern Minecraft mods frequently use Mixins, ASM, hooks, events, and other forms of code modification. Two mods may attempt to modify the same method or rely on incompatible assumptions about how Minecraft behaves.

Instead of immediately disabling one of them, Mods Fixer is intended to analyze the conflict and attempt to find a compatible solution that preserves the functionality of both mods.

If a safe solution cannot be found, Mods Fixer should not silently remove important functionality just to prevent a crash. In situations where compatibility cannot be achieved safely, allowing the original failure to remain visible is preferable to creating hidden or unpredictable behavior.

Performance Problems Inside Mods

Mods Fixer is also intended to detect inefficient structures inside individual mods.

For example, a mod might repeatedly scan thousands of objects every tick even when the result has not changed, perform the same calculation multiple times, generate unnecessary allocations, or use an excessively complicated system for a relatively simple task.

Mods Fixer aims to identify these situations and, when possible, replace or mitigate the inefficient behavior while keeping the mod's intended functionality unchanged.

This can potentially improve:

• CPU usage
• Frame stability
• Tick performance
• Memory usage
• Loading behavior
• Mod interaction stability

However, Mods Fixer does not replace specialized optimization mods.

Its responsibility is to correct problems whose root cause exists inside another mod. Other optimization projects can still independently optimize Minecraft systems such as ticks, chunks, rendering, networking, logging, or other global subsystems.

Adaptive Development

The future architecture of Mods Fixer is planned to become increasingly adaptive.

Instead of relying exclusively on a fixed list of known incompatibilities, the goal is for the system to progressively become capable of:

Observe → Detect → Attribute → Analyze → Experiment → Validate → Apply or Roll Back → Learn

This would allow Mods Fixer to investigate previously unknown problems instead of requiring every compatibility fix or optimization to be manually programmed beforehand.

Any experimental correction must be treated carefully. A performance improvement is not useful if it breaks the functionality of the affected mod.

For that reason, verification, rollback, diagnostics, and regression detection are important parts of the project's long-term design.

Does Mods Fixer fix every mod?

No.

Minecraft's modding ecosystem is extremely complex, and guaranteeing compatibility between every possible combination of mods is unrealistic.

Some conflicts may involve behavior that cannot be safely combined. Others may depend on systems that Mods Fixer does not yet understand or support.

The objective is therefore not to claim 100% compatibility, but to continuously expand the number and complexity of problems that can be diagnosed and safely corrected.

If Mods Fixer cannot confidently solve a problem, it should avoid making an unsafe modification.

Current Development Status

Mods Fixer is still under heavy development.

Current preview versions contain only part of the planned architecture, and some features may be incomplete, experimental, or ineffective depending on the modpack.

Because of this:

Do not expect the current preview versions to represent the final capabilities of Mods Fixer.

The project is being progressively rebuilt and expanded toward a more robust foundation before being considered fully stable.

Support for additional Minecraft versions and mod loaders is also planned after the main systems become sufficiently stable.

Client and Server Support

Some parts of Mods Fixer can already operate in client environments, but complete client-side support is still under development.

Future versions are planned to expand support for problems involving both client-side and server-side mods.

Feedback and Bug Reports

If Mods Fixer causes a problem, fails to resolve an incompatibility, or you find a mod combination that behaves incorrectly, reports are extremely useful for improving the system.

You can leave information in the CurseForge comments or join the Discord server:

https://discord.gg/9WZDxVY4m

When reporting a problem, providing the affected mods, their versions, the Minecraft version, mod loader version, and relevant logs can make diagnosing the problem much easier.

Mods Fixer is an experimental project with an ambitious objective: make heavily modded Minecraft more compatible, stable, and efficient by correcting problems at their source instead of simply hiding their consequences.