Skip to content

Detect Fabric mods that require a newer Fabric Loader - #197

Merged
pavog merged 3 commits into
masterfrom
fabric-loader-outdated
Nov 13, 2026
Merged

pavog merged 3 commits into
masterfrom
fabric-loader-outdated

Conversation

@pavog

@pavog pavog commented Nov 13, 2026

Copy link
Copy Markdown
Member
- Mod 'Foo' (foo) 1.0.0 requires version 99.0.0 or later of mod 'Fabric Loader' (fabricloader), but only the wrong version is present: 0.20.1!

Fabric Loader is a built-in mod with the id fabricloader, so a mod that needs a newer loader is reported like a missing mod dependency.
This happens regularly after a Fabric API update raises the minimum loader version.
FabricModDependencyProblem matched that line and reported "The mod 'Foo' is missing the required mod 'Fabric Loader'." with the solution "Install the mod 'Fabric Loader' with version >=99.0.0.".
The loader is part of the installation and not a file in the mods folder, so it has to be updated instead.

This PR adds FabricLoaderVersionProblem, which names the mod, the required and the installed loader version, and the new FabricLoaderUpdateSolution ("Update Fabric Loader to version 99.0.0 or later.").
FabricModDependencyProblem skips dependencies on fabricloader, so the line is not reported twice.

The pattern anchors on the id (fabricloader), and on the mod prefix the loader prints for it (unlike the java and minecraft built-ins).
An exact requirement (requires version 0.17.3 of) is reported the same way, because in practice it means the installed loader is too old.

Changes

  • add FabricLoaderVersionProblem with the patterns minimum and specific
  • add FabricLoaderUpdateSolution
  • add the translations mod-fabric-loader-version-problem and fabric-loader-update-solution
  • skip the Fabric Loader dependency in FabricModDependencyProblem
  • add the fixture fabric-loader-outdated.log, a real Fabric Loader 0.20.1 server log for Minecraft 26.3

Not covered: any version before, after and between requirements on the loader, which are rare.

@pavog
pavog requested a review from JulianVennen November 13, 2026 19:40
# Conflicts:
#	lang/en.json
#	src/Analyser/FabricAnalyser.php
#	src/Analysis/Problem/Fabric/FabricModDependencyProblem.php
@pavog
pavog merged commit ccd4608 into master Nov 13, 2026
3 checks passed
@pavog
pavog deleted the fabric-loader-outdated branch November 13, 2026 20:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants