About ModernFix
ModernFix is a collection of patches to Minecraft's plumbing. It does not draw anything, does not change any gameplay rule, and adds no menu you will ever open by accident. What it changes is how the game starts up, how much memory it holds while it runs, and a long list of bugs: some Mojang's, some Forge's, some belonging to mods whose authors moved on years ago.
The reason to install it is almost always a modpack. On a 250-mod pack the things ModernFix targets are the things that hurt: a launch that takes four minutes, a memory ceiling you keep raising, a crash on world load that nobody can explain. On vanilla or a dozen mods it will still work, and you will struggle to notice. That gap between "transformative" and "unnoticeable" is real, it depends entirely on your setup, and this page is largely about working out which side of it you are on.
What it actually patches
The project describes itself as an all-in-one mod, which is accurate but not very informative. In practice the work falls into five groups:
- Launch process optimizations. The largest visible win. Mod loading is heavily parallel and heavily wasteful, and ModernFix rewrites parts of it, which also removes a class of random concurrency crashes that only appear on some launches and are therefore nearly impossible to report.
- Bugfix backports. Fixes that exist in newer Minecraft or newer Forge, applied to the version you are actually on. The example the project gives is worlds breaking when you remove a dimension mod on 1.18, the kind of fault that costs a save file.
- Patches for abandoned mods. When a mod is no longer maintained on your Minecraft version, ModernFix can patch around its problems so the pack works without waiting for an update that is not coming.
- A dynamic model loading system. Minecraft has loaded every model up front since 1.8. ModernFix can instead load them on demand, which the project describes as bringing memory use and loading times back toward 1.7.10 levels. This is switched off by default because it does not get along with everything; see the configuration section.
- Debug tooling. Aimed at working out which mod is responsible for a rare crash or freeze without bisecting a 300-mod list by hand.
Individual patches are toggleable, which matters more than it sounds: if one of them upsets a mod in your pack, you disable that patch rather than the whole mod.
The "twice as fast" claim, in context
The project's headline figure is that most Forge modpacks on Minecraft 1.16 to 1.19.2 will launch roughly twice as fast with ModernFix installed. That is the developer's own measurement rather than an independent benchmark, and the conditions are narrow and worth reading carefully: Forge, 1.16–1.19.2, modpacks.
It is a credible claim for that situation: those versions predate a lot of loader-side improvements, and a big Forge pack spends an enormous amount of its startup doing work that can be parallelised or skipped. It is not a promise about NeoForge on a current version, and it is certainly not a promise about a lightly modded profile, where there was not much startup cost to remove in the first place.
Memory: what the 3 GB figure means
ModernFix reduces memory use, and the project's specific claim is that with non-default options enabled a pack the size of All The Mods 8 can run in 3 GB of allocated memory or less. There is also a documented ultra-low-memory configuration for running in 512 MB.
Two things are worth separating here. Allocated memory is the ceiling you set in your launcher, the -Xmx figure. Memory actually used is how much of that the game occupies. ModernFix's memory work lets a pack fit under a lower ceiling; it does not mean your machine will report using 3 GB less than before. And the headline figure depends on turning on options that are off by default, dynamic model loading chief among them, so it describes what the mod is capable of rather than what a default install does.
Nobody has published a universal percentage for this, and any page quoting one made it up. What is reliably true is that the bigger and more model-heavy your pack, the more there is for ModernFix to save.
Which ModernFix you install depends on your version
This is the part that trips people up, and most write-ups have it wrong. ModernFix now effectively exists as two projects, and which one you need is decided by your Minecraft version and loader.
Upstream ModernFix, by embeddedt, is the original. Its current release line is NeoForge, up to Minecraft 26.1.2. It also still maintains Forge on 1.20.1, actively: that branch received updates within days of this page being written, which is unusual for a version that old and reflects how many packs are still there.
ModernFix-mVUS, by Coredex, is a fork that exists to fill the gaps. Its stated policy is to release builds for Minecraft versions upstream does not support, and to skip any version upstream does cover. It carries the same LGPL-3.0 licence and the same underlying code.
Two practical consequences:
- Minecraft 26.2 has no upstream build. Upstream stops at 26.1.2. If you are on 26.2, the mVUS fork is the only option, and it covers both Fabric and NeoForge there.
- Upstream has stopped releasing Fabric builds entirely. The newest upstream Fabric file targets Minecraft 1.20.1 and dates from December 2025; the highest Minecraft version with any upstream Fabric build is 1.21.4. The fork's own project page states the situation plainly. Fabric players above 1.21.4 need mVUS.
None of this makes the fork suspect: it is open source under the same licence, it is used several million times over, and it exists precisely because the gap was worth filling. But it is a different project by a different author, and you should know which one is in your mods folder.
Loaders and versions
- NeoForge: the current upstream focus. Builds through Minecraft 26.1.2, plus 1.20.x, 1.21, 1.21.1 and 1.21.4. For 26.2, mVUS.
- Forge: legacy but genuinely maintained. Upstream Forge builds cover 1.16.4 through 1.20.2, and the 1.20.1 branch is still receiving releases. Forge is also where the "twice as fast" startup claim applies most directly.
- Fabric: discontinued upstream, continued by mVUS. Upstream covers 1.16.4 up to 1.21.4; above that, the fork.
- Quilt: not listed as a supported loader by either project. Quilt can generally run Fabric mods, but that is a property of Quilt rather than a compatibility statement from ModernFix, so treat it as untested.
Does it need anything else?
This depends on which build you take, and getting it wrong is the most common installation failure:
- Upstream builds require nothing. Every current upstream file (NeoForge, Forge and the older Fabric ones) declares an empty dependency list. Upstream Fabric builds do not need Fabric API, despite what most guides assume.
- mVUS Fabric builds do require Fabric API. The 26.2 Fabric files list it as a required dependency, and the game will not start without it.
- mVUS NeoForge builds require nothing.
It has no dependency on any other performance mod. Sodium, Lithium and FerriteCore are companions, not prerequisites.
Client, server, or both
Both are supported, and both are optional: a server does not require its players to have it, and you can install it as a player on a server that has never heard of it.
- Single-player. One client install covers everything, since your game runs its own internal server.
- Joining a server. Install it client-side for the launch, memory and stability benefits. Nothing about it depends on the server.
- Running a server. Install it server-side. Servers get the same kind of wins for the same reasons (faster startup, lower memory footprint, the bugfix backports) independently of what any player has.
One honest caveat: the benefits documented for servers mirror the client ones. There is no published claim that it raises tick rate, so if your problem is TPS rather than startup or memory, Lithium is the mod aimed at that.
How it fits with Sodium, Lithium and FerriteCore
These four are frequently installed together and frequently confused. Broadly:
- Sodium replaces the renderer. It is the one that raises frame rates.
- Lithium optimizes game logic: ticking, mob AI, physics.
- FerriteCore shrinks the memory footprint of blockstate data.
- ModernFix targets loading, startup, broader memory use and bugs.
The developer is explicit about FerriteCore in particular, recommending it be installed always, on the grounds that Mojang's blockstate and model handling consumes memory badly as soon as a pack adds content. The two overlap on the subject of memory without doing the same job: FerriteCore compacts how blockstate data is stored, while ModernFix's dynamic model loading changes when models are loaded at all.
These are different systems, but "different systems" is not the same as "guaranteed never to collide": all four patch the game with Mixin, and any large stack can produce a conflict on a specific version combination. Keeping them all current is the practical defence, and a conflict when it happens is a bug to report rather than a reason to abandon the combination.
The one it will not work with
The developer advises against OptiFine in any modded setup, and says using it with ModernFix is not officially supported and may cause problems. The reasoning given is that OptiFine is closed-source, patches the game in ways that break Forge and other mods, and can slow launching dramatically, the exact thing ModernFix exists to speed up. Sodium on Fabric, or Embeddium on Forge, is the suggested replacement.
Configuration
A default install needs no configuration and that is how most people should leave it. Two things are worth knowing exist:
- Dynamic model loading is off by default, because it has known compatibility problems with some mods. It is the switch behind the most dramatic memory and loading claims, so it is worth trying on a big pack, but try it as a deliberate experiment, with a backup, not as routine setup.
- Individual patches can be turned off. If a crash traces to one specific ModernFix patch, disabling that patch is a far better fix than removing the mod.
The project wiki documents the patches individually and covers the ultra-low-memory configuration. Everything else in the config is aimed at modders debugging their own problems.
Licence and source
ModernFix is open source under LGPL-3.0, written by embeddedt, with the code, wiki and issue tracker on GitHub. It is Java Edition only: there is no Bedrock equivalent, and there cannot be, since it patches Minecraft's Java code directly. Official downloads are on Modrinth and CurseForge; the mVUS fork is published separately on Modrinth by its own author.
The install itself is a single file in a folder. The part worth slowing down for is choosing that file, because ModernFix is split across two projects and picking from the wrong one is the most common way this goes wrong.
First work out which project you need
Answer in this order:
- Minecraft 26.2? You need ModernFix-mVUS. Upstream has no 26.2 build. The fork covers both Fabric and NeoForge there.
- Fabric above 1.21.4? ModernFix-mVUS again; upstream no longer releases Fabric builds.
- NeoForge on 26.1.2 or below? Upstream ModernFix.
- Forge on 1.20.1 or older? Upstream ModernFix, which still ships releases for that branch.
The Download section on this page lists both projects together, upstream and mVUS, so the answer above becomes a filter on Minecraft version and loader rather than two project pages to compare. Each row links to the official Modrinth release; CurseForge and GitHub carry the same files. Sites that repackage mod JARs are not worth the risk.
NeoForge
- Install NeoForge for your Minecraft version and launch the profile once so its folders exist.
- In the Download section, take the NeoForge row for your exact Minecraft version. The current upstream release is
modernfix-neoforge-5.27.21+mc26.1.2.jar; on 26.2 the mVUS NeoForge file is the one to take instead.
- Drop it in that instance's
mods folder. On Windows the default profile uses %appdata%\.minecraft\mods; Prism, MultiMC and the CurseForge app each keep a separate folder per instance, and it must be that instance's folder.
- Launch. Nothing else to install.
Forge on 1.20.1 and older
- Install the Forge version your pack expects.
- Take the Forge file for your Minecraft version;
modernfix-forge-5.27.77+mc1.20.1.jar is the current 1.20.1 release.
- Place it in
mods and launch.
No dependency is needed. This is also the configuration the project's startup claim is drawn from, so if you are on a large 1.16–1.19.2 Forge pack this is where you should expect the most obvious difference.
Fabric, and anything on 26.2
Both routes go through ModernFix-mVUS.
- Install Fabric Loader (or NeoForge, for the NeoForge 26.2 build) and run the profile once.
- Install Fabric API first if you are taking a Fabric build. The mVUS Fabric files require it and will not start without it. The NeoForge builds do not need it.
- Download the mVUS file matching your Minecraft version and loader.
- Put both JARs in
mods and launch.
Do not install upstream ModernFix and mVUS at the same time. They are the same mod ID and the loader will refuse to start.
On a server
- Stop the server.
- Put the file matching the server's loader and Minecraft version into the server's
mods directory, plus Fabric API if this is a Fabric server taking an mVUS build.
- Start it and watch the console through to the "Done" line.
Players do not need it to connect, so you can add it without coordinating with anyone. If you want the client-side benefits too, install it separately in your own client.
Confirming it loaded
There is no screen to open, so use one of these:
- The mod list. The Mods button in the main menu should list ModernFix with a version number. That number also tells you which project you installed: upstream NeoForge and Forge files carry a
+mc version suffix, mVUS Fabric files use a -build.N suffix.
- The log. Search
logs/latest.log for modernfix. It appears early, while mixins are being applied. This is the only option on a server.
- The obvious one. Time your launch before and after on a large pack. This is the mod's headline benefit and it is the one thing you can actually observe without tooling.
When it goes wrong
The loader refuses to start and names a version. Nine times out of ten the file is for the wrong Minecraft version or the wrong loader. Both are in the filename; check it against your profile before anything else.
"Missing dependency: fabric" or similar. You have an mVUS Fabric build without Fabric API. Install it for the same Minecraft version.
Two ModernFix files at once. Updating by adding the new JAR without deleting the old one fails immediately, and so does mixing upstream with mVUS. Check the folder for a stale file.
A crash mentioning mixins. Look for Mixin apply failed or Critical injection failure. The useful information is not the first line: it is the deepest named class in the "Caused by" chain, which usually identifies the mod ModernFix is colliding with. Update both mods, then test with only those two installed to confirm.
A crash that traces to one ModernFix patch. Turn that patch off in the config rather than removing the mod. The project wiki lists what each one does.
Crashes after enabling dynamic model loading. Expected often enough that it ships disabled. Turn it back off before investigating anything else.
You installed it and nothing seems different. On vanilla or a small mod list, that is the normal outcome. The benefits scale with the size of the pack.
New to this? The step-by-step mod installation guide covers loaders and the mods folder in more detail, and our guide to mods that will not load covers version and dependency errors.