How to install Minecraft mods (Fabric, NeoForge): step by step

How to install mods on Minecraft Java: pick Fabric or NeoForge, download mods safely, the mods folder on Windows, Mac and Linux, and play on a modded server.

Atualizado em

Mods add content to or improve Minecraft Java Edition: new creatures, a minimap, better performance… You need two things: a mod loader e o mods, for the same game version. On Bedrock (mobile, consoles), add-ons are installed differently.

1. Pick a mod loader

  • Fabric: light and updated very fast for each new version. Great for performance (Sodium) and quality-of-life mods. Most Fabric mods also need the Fabric API mod.
  • NeoForge (or the older Forge): used by many big mods and modpacks (tech, magic, adventure).

A mod is made for one loader: a Fabric mod does not work with NeoForge, and the other way round. Check the mod's page.

2. Install the loader

  1. Launch Minecraft once in the version you want, then close it.
  2. Download the installer from the official website: fabricmc.net for Fabric, neoforged.net for NeoForge.
  3. Open the installer, pick Client and the Minecraft version, then confirm.
  4. A new installation ("fabric-loader-…" or "neoforge-…") shows up in the Minecraft launcher.

3. Download mods safely

A mod is a program: only download it from Modrinth, CurseForge or its author's official website. Avoid sites that copy mods with ads and misleading "Download" buttons. Check the Minecraft version e o loader on the mod's page.

4. Put the mods in the mods folder

  • Windows: Windows key + R, type %appdata%\.minecraft, then open (or create) the mods folder.
  • macOS: ~/Library/Application Support/minecraft/mods.
  • Linux: ~/.minecraft/mods.

Drop the downloaded .jar files there (do not unzip them), then start the Fabric or NeoForge installation from the launcher. The "Mods" button in the main menu lists the loaded mods.

Even simpler: the Modrinth App and CurseForge apps create a separate installation and put the mods in it for you, so different mod lists never mix.

5. Play on a modded server

A modded server needs exactly the same mods (and versions) as the server: most offer a modpack or their own launcher, shown on their page. "Client-side" mods (performance, minimap, interface) usually work on any server.

Mind the rules: mods that give an advantage (seeing through blocks, flying, aim assist) are banned on almost every server. When in doubt, read the rules on the server's page.

6. Not working?

  • The game crashes at launch: a mod is for the wrong version or loader, or a dependency is missing (often Fabric API). Remove mods one by one to find the culprit.
  • "Incompatible mod set" on a server: your mods do not match the server's.
  • The game lags: add Sodium (Fabric) or give the game more memory, see how to allocate more RAM to Minecraft.

Want it to look great? Read how to install shaders.

Tens um servidor do Minecraft?

Publica-o gratuitamente e faz com que os jogadores o descubram.

Outros guias