Version Mod Sorter

Tired of swapping mods every time you switch Minecraft versions or loaders? Version Mod Sorter loads mods from version-specific and loader-specific folders so you don't have to.

How It Works

Place your mods in mods/<loader>/<version>/ (e.g. mods/fabric/1.20.4/), and only the mods matching the current loader and Minecraft version will be loaded — in addition to mods in the regular mods/ folder.

You can also drop mods directly in mods/<loader>/ (e.g. mods/fabric/) to share them across all Minecraft versions of that loader. Subfolders inside a version folder are also picked up, so you can organize mods by category.

The version folder is automatically created on first launch. Just drop your mods in and go.

Folder structure example:

mods folder

📁 mods
├─ version-mod-sorter-x.x.x.jar
│  (VMS itself)
├─ ModA.jar
│  (mods/ root: loaded on every loader and version)
├─ 📁 fabric
│  ├─ ModB.jar
│  │  (Fabric: loaded on every version)
│  └─ 📁 26.1.2
│     ├─ ModC.jar
│     │  (Fabric MC26.1.2 only)
│     └─ 📁 folder
│        └─ ModD.jar
│           (subfolders can be used for organization)
├─ 📁 forge
│  ├─ ModE.jar
│  │  (Forge: loaded on every version)
│  └─ 📁 1.21.4
│     └─ ModF.jar
│        (Forge MC1.21.4 only)
└─ 📁 neoforge
   ├─ ModG.jar
   │  (NeoForge: loaded on every version)
   └─ 📁 1.20.6
      └─ ModH.jar
         (NeoForge MC1.20.6 only)

Features

Works with Fabric, Forge, and NeoForge — a single jar supports all three
Per-loader shared folder for mods that work across all Minecraft versions
Subfolder organization inside each version folder
No need for separate game directories or instances
No Minecraft class modifications or bytecode patching

Crash Analysis (Fabric)

When the game crashes on Fabric, VMS analyzes the cause and shows a dialog. It checks crash reports (crash-reports/) first, then falls back to the tail of logs/latest.log.

It detects two categories of crashes and shows the involved mods and suggested fixes:

Mod conflicts — when multiple mods modify the same code and collide, both mod names are shown with the suggestion to remove one or check for updates
Version mismatch — when a mod references code that does not exist in the current Minecraft version, the mod name is shown with the suggestion to move it to the matching version folder, update it, or remove it

For crashes that match neither category, VMS still lists mods inferred from the stack trace. If the loader itself reports a mod resolution failure (Mod resolution failed, etc.), VMS stays silent because the loader already shows its own error screen.

Example crash analysis dialog

Requirements

Fabric Loader 0.13.0+ / Forge 41.1.0 (MC 1.19)+ / NeoForge 20.6.62-beta (MC 1.20.6)+

Notes

The version folder name must exactly match the Minecraft version reported by the loader.
Startup may take slightly longer when loading mods.
This mod relies on internal loader implementations. A major loader update may cause it to stop working, but it will never affect the game or other mods.