Fix "requires version ... of minecraft, but only the wrong version is present"
The game stops before the title screen because a mod says which Minecraft version (or which version of another mod) it needs, and the one installed is outside that range.
A mod that asks for Minecraft 1.21.4 or later, on a Fabric 1.21.1 server, stops it with:
Incompatible mods found!net.fabricmc.loader.impl.FormattedException: Some of your mods are incompatible with the game or each other!A potential solution has been determined, this may resolve your problem: - Replace mod 'Example Mod' (examplemod) 1.0.0 with any version that is compatible with: - minecraft 1.21.1More details: - Mod 'Example Mod' (examplemod) 1.0.0 requires version 1.21.4 or later of 'Minecraft' (minecraft), but only the wrong version is present: 1.21.1!The same mod on a NeoForge 1.21.1 server:
Missing or unsupported mandatory dependencies: Mod ID: 'minecraft', Requested by: 'examplemod', Expected range: '[1.21.4,)', Actual version: '1.21.1'...Error during pre-loading phase: Mod examplemod requires minecraft 1.21.4 or aboveThe same messages appear for any other dependency, such as requires version 0.116.0 or later of 'Fabric API', or
Mod ID: 'neoforge' with an expected range.
Checked on 19 November 2026 on Fabric Loader 0.20.1 and NeoForge 21.1 servers for Minecraft 1.21.1.
If you are playing
Section titled “If you are playing”Download the mod’s build for the Minecraft version you run, or run the version the mod supports. For a dependency such as Fabric API, update it to a version inside the range the message names.
If it is your own mod
Section titled “If it is your own mod”The range comes from your mod’s metadata file. After a port it often still names the old version.
- Fabric: the
dependsblock ofsrc/main/resources/fabric.mod.json, such as"minecraft": "~1.21.1"(1.21.1 and any later 1.21.x). Fabric also accepts">=1.21.1", an exact"1.21.1"and other ranges (Fabric: project structure). - NeoForge: the
[[dependencies.examplemod]]entry withmodId="minecraft"insrc/main/resources/META-INF/neoforge.mods.toml. ItsversionRangeuses Maven’s range syntax, such as"[1.21.1,1.21.2)"(NeoForge: mod files). The MDK fills it fromminecraft_version_rangeingradle.properties, so change it there.
Set the range to the versions you built and tested against, rebuild, and run again.
In Linen
Section titled “In Linen”Crash Doctor in Linen reads the crash report and the log next to it, then names the mod, the line and what to change. It’s free. The update a mod to a new Minecraft version how-to lists what else changes in a port.