Skip to content

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.1
More 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 above

The 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.

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.

The range comes from your mod’s metadata file. After a port it often still names the old version.

  • Fabric: the depends block of src/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 with modId="minecraft" in src/main/resources/META-INF/neoforge.mods.toml. Its versionRange uses Maven’s range syntax, such as "[1.21.1,1.21.2)" (NeoForge: mod files). The MDK fills it from minecraft_version_range in gradle.properties, so change it there.

Set the range to the versions you built and tested against, rebuild, and run again.

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.