Skip to main content
Fabric API
Download

The Minecraft Mods Folder: Where Fabric API and Mods Belong

A complete guide to the Minecraft mods folder for Fabric players: finding it on Windows, macOS and Linux, organising files, spotting duplicates, and keeping profiles separate.

Every Fabric instruction ever written contains the same sentence: put it in the mods folder. The sentence assumes you can find the folder, recognise the right one among several installations, and keep it tidy, three assumptions that quietly account for a large share of all modding confusion.

The folder itself is simple: a single directory inside the Minecraft installation where the Loader looks for the library and mods at launch. Everything about it becomes easy once its address on your system is known and its contents are kept honest.

A working setup in this area rests on:

  • Windows: the .minecraft folder inside AppData Roaming
  • macOS: the minecraft folder inside Library Application Support
  • Linux: the .minecraft folder in your home directory
  • Custom instances: the instance's own folder, not the default one

Find It on Windows

Press the Windows key and R together, type %appdata% and press Enter, then open the .minecraft folder. The mods folder sits inside; if it does not exist yet, a first launch with the Loader installed creates it, or you can create it yourself with exactly that name.

Shortcuts betray many players: a desktop icon may point at a different launcher or instance. Always navigate from %appdata% so you are editing the installation the game actually uses.

Name pack files so their purpose survives memory: a prefix for the world or pack, the mod's short name, and its version reads clearly months later, when the midnight filename you chose in a hurry would say nothing at all.

Find It on macOS and Linux

On macOS, open Finder, use Go to Folder, and enter ~/Library/Application Support/minecraft. The Library folder is hidden by default, which is why the address must be typed rather than clicked toward.

On Linux, the folder is ~/.minecraft in your home directory, visible once hidden files are shown. In every system, a launcher instance from a third party app keeps its own private folder elsewhere, and that instance's folder is the correct target when you play through it.

A monthly two minute folder review catches the drift every setup accumulates: the disabled mod never re enabled, the duplicate from a re download, the library copied twice. Tidiness here is performance, stability, and sanity in one habit.

When mods seem ignored, the file is almost always in the wrong instance's folder. Verify the folder by the profile you actually launch.

What Belongs Inside

The folder should contain jar files only: the library, your mods, and nothing else. Zip archives the downloads arrived in, read me files, and extracted folders are clutter the Loader cannot use and may trip over.

A jar still zipped is invisible to the game. Extract once, move the jar, and delete the packaging so the folder shows only working files at a glance.

Fabric API itself obeys the same folder discipline as every other file here: one copy, current version, clearly named. The most common library fault in support threads is simply two copies from two eras sharing one folder.

Duplicates and Version Soup

Duplicates arrive innocently: a mod downloaded twice, an old library build left beside its replacement. Two builds of one component produce some of the strangest errors in modding, because the Loader's choice between them is not the one you would make.

Sort the folder by name monthly and evict the elderly. Every file should be able to answer for its presence: name, version, and the mod that needs it. File level habits from the download guide prevent most soup from forming.

Keep Profiles Separate

Different Minecraft versions deserve different folders, which the launcher supports through per profile game directories. Separation means a 1.20 library can never wander into a 1.21 launch and produce an evening of confusing errors.

Name each profile with its version, point it at its own directory, and treat the folders as sealed rooms. Moving day between versions is a deliberate copy and check, never a casual drag.

Frequently Asked Questions

Why is there no mods folder?

The Loader creates it on first launch. If it is missing, launch the game once with Fabric Loader installed, or create a folder named exactly 'mods' inside the Minecraft folder yourself. That is Fabric API behaving normally.

My mod is in the folder but does not load. Why?

The usual causes are a jar still inside its zip, a build for the wrong game version, or the file sitting in a different launcher instance's folder than the one you play. Fabric API is designed to work exactly that way.

Can I keep mods for two game versions in one folder?

Technically files coexist, but practically it invites version errors. Use separate game directories per profile so each version's library and mods stay sealed apart. In short, Fabric API is doing its job when that happens.

Should I delete old library builds?

Yes. Keep exactly one build per component in a folder. Duplicates cause unpredictable behaviour because the Loader may pick either copy. That is the expected behaviour with Fabric API installed.

Conclusion

The Minecraft Mods Folder comes down to the same discipline as the rest of a healthy Fabric setup: match versions exactly, change one thing at a time, and keep a written record of what you installed.

Follow that discipline and this part of your setup stops producing surprises, leaving the library to do its quiet work underneath the mods you actually play.

Daniel Osei

Reviewed by

Daniel Osei

Modding Tools Reviewer

Daniel tests Minecraft modding tools and libraries on real PCs and Android devices, checking installation, compatibility, and stability before anything is recommended here.

More about Daniel Osei