---
title: "How to Install Minecraft Mods Without Crashing Your Game"
description: "Forge, NeoForge, and Fabric explained: how to choose a mod loader and match Java versions to avoid startup errors."
url: "https://www.alemasone.com/en/install-minecraft-mods-without-crashing/"
language: "en"
published: 2024-09-11
updated: 2026-09-19
categories: ["Gaming"]
translations:
  it: "https://www.alemasone.com/it/installare-mod-minecraft/"
  es: "https://www.alemasone.com/es/instalar-mods-minecraft-sin-errores/"
  fr: "https://www.alemasone.com/fr/installer-mods-minecraft-sans-erreur/"
  pt: "https://www.alemasone.com/pt/como-instalar-mods-minecraft-sem-erros/"
  de: "https://www.alemasone.com/de/minecraft-mods-installieren-ohne-abstuerze/"
---

# How to Install Minecraft Mods Without Crashing Your Game

If Minecraft crashes as soon as you add a mod, nine times out of ten there is one reason: **the versions don't match**. The mod must be made for your version of Minecraft, for your mod loader, and it must run with the Java version that specific release requires. If even one of those three is wrong, the game will close before you reach the menu.

If you are returning to modding after a few years, two things might catch you off guard. After 1.21, Minecraft: Java Edition changed its numbering system: as of March 24, 2026, versions are named by year and update number, such as **26.1**, 26.2, and so on. Also, mod loaders aren't just [Forge](https://files.minecraftforge.net/) anymore: there is also [NeoForge](https://neoforged.net/), which branched off from Forge in 2023, and [Fabric](https://fabricmc.net/).

Let's look at which loader to choose, how to install it, where to get mods, and how to make everything work together.

## Choosing a mod loader

The official launcher doesn't load mods on its own: you need a mod loader, a program that is added to the game to allow it to read mod code. There are several different ones and **they are not compatible with each other**: a mod written for Fabric won't run on Forge, and vice versa.

| Loader | Features | When to choose it |
|--------|-----------------|-------------------|
| Forge | The veteran; the largest library of mods accumulated over the years | Older mods and modpacks |
| NeoForge | Born from a split in the Forge project; very active | Recent mods originally made for Forge |
| Fabric | Lightweight; updates quickly to new versions | Optimization mods and brand-new releases |
| [Quilt](https://quiltmc.org/en/) | Derived from Fabric; smaller community | Specific cases, if a mod requires it |

Start with the mods, not the loader: **first choose the mods you want, then install the loader they require**. If you do the opposite, you'll end up having to give up on some mods you were interested in.

Optimization and graphics mods, such as [Sodium and Iris](/en/best-minecraft-shaders-installation-guide/), are native to Fabric, which updates quickly for new versions. Large content mods—featuring machinery, new dimensions, and long progression systems—come from the Forge world, and for recent versions, mostly via NeoForge. Forge remains the go-to choice for modpacks on older versions, like 1.12.2 or 1.20.1.

## Verifying your Java version

Every Minecraft release requires a minimum version of Java; if you use an older one, the game won't start:

| Minecraft Version | Required Java |
|-----------------------|----------------|
| Up to 1.16.5 | Java 8 |
| 1.17 | Java 16 |
| From 1.18 to 1.20.4 | Java 17 |
| From 1.20.5 to 1.21.x | Java 21 |
| From 26.1 onwards | Java 25 |

The official launcher downloads and uses the correct version automatically: if you play with it and haven't changed anything, you're all set. Problems arise with third-party launchers, with the Forge installer (which is a `.jar` file and uses your system's Java), and with servers launched via command line.

To check which version you have installed:

```bash
java -version
```

If it's older than what you need, install an updated version of Java. The most common free distributions are [Adoptium Temurin](https://adoptium.net/) and [Amazon Corretto](https://aws.amazon.com/corretto/).

> **JRE or JDK?** To play, all you need is the runtime (JRE). The development kit (JDK) works just fine and won't cause harm, but it takes up more space and you only really need it if you are programming.

## Installing Forge or NeoForge

1. **Launch the version of the game** you want to mod once through the official launcher and play until you reach the main menu. This is necessary so that the files for that version can be downloaded.

2. **Download the installer** for your loader from its official website. For Forge, select your Minecraft version in the left-hand menu and click **Installer** under the *Recommended* build; this is more stable than the *Latest* one.

   ![Forge download page with the Installer button for the recommended version](launcher-minecraft-forge-installer.png "For Forge, choose the Recommended build for your version")

3. **Run the downloaded file** by double-clicking it. It is a `.jar` file, so you must have Java installed on your computer. Choose **Install client** and click **OK**.

4. **Restart the launcher**: in the list of profiles at the bottom left, there should be one named after your loader. If you don't see it, go to the **Installations** tab and check the **Mods** box (or "Open for mods"). Select it and launch the game once without any mods so that the necessary folders are created.

5. **Open the game folder.** The fastest way: in the **Installations** tab, hover your mouse over the profile and click the folder icon on the right. Alternatively, on Windows, type `%appdata%\.minecraft` into the File Explorer address bar; on macOS, it's `~/Library/Application Support/minecraft`; on Linux, it's `~/.minecraft`.

   ![Minecraft launcher Installations tab with the folder icon next to the Forge profile](launcher-minecraft-cartella-mod.png "The folder icon opens the profile directory directly")

6. **Copy your mod files `.jar`** into the `mods` folder. If it doesn't exist, create it using all lowercase letters.

7. **Restart the game** using the loader profile.

![Mod loader installer window with the Install client option selected](https://www.alemasone.com/it/installare-mod-minecraft/installer-forge-minecraft-client.png "In the installer, you must choose 'Install client,' not the server option")

The steps are the same for Fabric and NeoForge. However, with Fabric, almost every mod also requires the **Fabric API**, a library that you need to download and place in the `mods` folder along with the others.

![Minecraft mods folder open in File Explorer containing several .jar files](cartella-mods-minecraft-con-file-jar.png "Mods are simple .jar files that you copy into the mods folder")

## Where to download mods

There are two safe platforms: [CurseForge](https://www.curseforge.com/minecraft), the largest and oldest, and [Modrinth](https://modrinth.com/mods), which is more recent, has no intrusive ads, and features convenient filters for versions and loaders. Both verify the files being uploaded. Alternatively, an author's GitHub page is also fine.

Stay away from websites that republish other people's mods with download buttons everywhere: that's where you'll find infected files disguised as mods.

## Matching versions

This is where most time is wasted, so proceed in order. Before downloading a mod, check these three things on its page:

1. **Which Minecraft version** it was released for. It must be identical to yours, not just "close": a mod for the previous release will not work on the new one.
2. **Which loader.** Many mods exist in both versions, Forge and Fabric, and they are different files: downloading the wrong one is the most common mistake.
3. **What dependencies it requires.** Many mods rely on shared libraries, which must also be installed in the `mods` folder.

> **A separate profile for each group of mods.** Keep a separate game folder for every combination of mods. In the official launcher, you can set this up by modifying the profile directory. This way, you can have one configuration with your mods and one clean one, without moving files back and forth every time you switch.

If you don't want to manage any of this, use a launcher designed for mods, such as the CurseForge app, the Modrinth App, or [Prism Launcher](https://prismlauncher.org/). They automatically download the correct loaders, Java, and dependencies and keep instances separate. If you are installing more than three or four mods, I would go straight to one of these.

## When the game won't start

**It closes immediately, without any messages.** Usually, there is a mod for the wrong version. To find it quickly, remove half of your mods, try running it, and keep halving them until you find the culprit. The `latest.log` file in the `logs` folder often tells you the name already.

**A screen appears listing the erroring mods.** You've gotten lucky: the loader tells you which mod failed and why—usually due to a missing dependency.

![Mod loader screen listing the erroring mods with the missing dependency highlighted](launcher-minecraft-errori-mod-loader.png "When this list appears, the name of the culprit mod is already written there")

**An error regarding a Java version.** The message indicates the required number (for example, *class file version 69.0* means Java 25). Install that version or, in the official launcher, check that the profile is using the automatically downloaded Java.

**The game starts but stutters.** Mods consume memory. In the profile settings, you can increase the allocated memory, but don't overdo it: allocating more than 6-8 GB to a modded game actually worsens performance instead of improving it because it slows down memory management.

**The world breaks after removing a mod.** It happens: mods that add blocks and items leave traces in your save file. Always make a backup of the `saves` folder before modifying the mod list of an active world.

## FAQ

### Do mods work on Bedrock Edition too?

No. Forge, NeoForge, and Fabric only work with Java Edition. The Bedrock Edition—the one for consoles, phones, and the Microsoft Store—uses add-ons, which are much more limited and are primarily obtained from the in-game Marketplace.

### Can I use Forge and Fabric mods together?

No, they are incompatible: choose one or the other. There are compatibility layers, like Sinytra Connector, that allow some Fabric mods to run on NeoForge, but they are fragile and often create more problems than they solve.

### Are mods legal and safe?

Mods are legitimate: Mojang has always tolerated them, and the community has been developing them for fifteen years. Safety depends on where you download them from. CurseForge, Modrinth, or the author's own page are fine; sites that republish other people's files are not, as that is where you find malicious programs disguised as mods.

### Do I need a powerful computer?

For two or three lightweight mods, no problem. With large modpacks containing hundreds of mods, you need at least 16 GB of RAM and a modern processor: these are the packs that can overwhelm even mid-range gaming computers.

### How do I update mods when a new version of Minecraft is released?

They don't update themselves or all at once: every author has their own schedule, and some stay outdated forever. I usually wait a few weeks after a new version is released, check that my essential mods are updated, and only then move the world—after making a backup first. Mod launchers will notify you automatically when an update is available.

### Why did Minecraft go from 1.21 to 26.1?

Mojang changed the numbering system at the beginning of 2026: the first number is now the year, the second is the update for that year, and the third is the patches. After various 1.21.x versions, we moved to 26.1, then 26.2. This changes nothing for mods: you still need to get the file made specifically for your exact version.