How to put mods in Minecraft Java Edition step by step

There is no Minecraft 1.22. In 2026 Mojang Studios switched Java Edition to year-based version numbers, so a lot of older tutorials now point you at loaders and files that won’t run on 26.3 “Wilderness Bound.” This guide covers the current way to put mods in Minecraft: choose a loader that matches your exact version, put the right .jar files in the right folder, and get the game to launch without crashing.

Quick answer: how to put mods in Minecraft (Java Edition, 2026)

You install a mod loader, run its profile once so the mods folder appears, drop the mod .jar files and their dependencies into that folder, then launch the loader profile again. On Java 26.3 the whole process takes about five minutes.

If it worked, the title screen shows your loader. NeoForge adds a Mods button on its own. Fabric adds one once you install a mod like Mod Menu by TerraformersMC.

If you play on Xbox, PlayStation, Switch or a phone, you have Bedrock Edition. Skip to the Bedrock section below, because .jar mods won’t run there.

Before you start: Java vs Bedrock, and what changed in 2026

Mods need Minecraft: Java Edition on Windows, macOS or Linux. In 2026 Java Edition also got new version numbers, a new Java requirement and unobfuscated code, and all three change which files you should download.

Which edition do I have?

If you start the game from the Minecraft Launcher on a computer and the title screen says “Minecraft: Java Edition,” you have Java Edition. If you got it from the Microsoft Store, an app store or a console store, you almost certainly have Bedrock.

PC Game Pass and recent PC purchases include both editions. On a PC, you may already own Java Edition without realising it.

The new 26.x version numbers, explained in one minute

Java Edition now numbers releases by year and update: 26.1, 26.2 and 26.3 were the 2026 releases. Hotfixes add a third number. For example, 26.1.2 was a hotfix released April 9, 2026, according to the Minecraft Wiki.

The latest full release is 26.3 “Wilderness Bound.” Minecraft.net and Fabric’s release post both date it September 15, 2026. It added the Dappled Forest biome, the poplar wood set and cushions you can sit on. Under the hood, it also moved windowing and input from GLFW to SDL3. Because rendering and input changed, mods built for 26.2 often need an update before they work on 26.3.

For you, this means one thing. When a mod page lists “26.3,” that is the version to pick. Mod files for 1.21.x won’t load on 26.3, even though the numbers look close.

Java 25: what you need to install (and what the launcher already bundles)

Since 26.1 Snapshot 1, Java Edition has required Java 25. According to Mojang’s snapshot post on Minecraft.net, the launcher ships the Microsoft Build of OpenJDK 25. All 26.4 snapshots also need Java SE 25 or newer.

The official Minecraft Launcher handles this for you. You need your own Java 25 install in three cases:

• You want to double-click a loader installer distributed as a .jar file.
• You run a modded server.
• You use a third-party launcher that doesn’t download Java itself.

Older installs such as Java 17 or Java 21 cause the “unsupported class version” type of failure. Installing the Microsoft Build of OpenJDK 25, or any other Java 25 distribution, fixes it.

Why 26.1 being unobfuscated matters

Minecraft 26.1 was the first Java Edition release without code obfuscation, as the NeoForge team noted in its 26.1 announcement. Before that, every update meant mapping scrambled names back to readable ones, and that slowed loaders down.

Without that step, Fabric and NeoForge kept up with 26.2 and 26.3 much faster than they used to. It is also a big reason most new mods now target Fabric and NeoForge first.

Don’t mod the 26.4 snapshots

26.4 Snapshot 7 came out on November 3, 2026. Mojang says it contains the final gameplay features of 26.4. Snapshots still break mods every week, and a world opened in a snapshot can’t safely go back to 26.3.

Pick your mod loader: Fabric vs NeoForge vs Forge

A mod loader is the small program that lets Minecraft load mod files. The right loader is whichever one the mod you want was built for. All three main loaders have builds for 26.3.

Fabric (lightweight, fast updates)

Fabric’s 26.3 post on fabricmc.net tells players to install the latest stable Fabric Loader, which was 0.19.5 when it was written. Fabric’s 26.1 post had listed 0.18.4, so the loader updates several times a year.

Fabric is small and updates quickly. Popular client mods such as Sodium (CaffeineMC) and Iris Shaders release here first. The trade-off is that most Fabric mods also need Fabric API, which is a separate download.

NeoForge (big content mods, the Forge successor)

NeoForge started in 2023 as a fork of Forge, made by most of Forge’s former team. It is now where many large content mods are developed.

Its version numbers have four parts. The first three are the Minecraft version and the last is the NeoForge build. 26.1.0.1-beta was the first build for 26.1. For 26.3, a server-hosting listing shows 26.3.0.1-beta released on September 15, 2026, and newer 26.3.0.x builds have come out since. Always get the newest one from neoforged.net.

Forge (legacy versions and older packs)

Minecraft Forge still releases builds. Its official files site lists 26.3 – 66.1.0 as the recommended download. Use Forge when a mod or modpack specifically says it needs Forge, which is common for older versions such as 1.20.1.

On 26.x, more new mods target NeoForge. A mod built for Forge won’t automatically run on NeoForge on current versions, and the reverse is also true.

Can you mix Fabric and NeoForge mods?

Not in a normal setup. A Fabric mod won’t load on NeoForge, and a NeoForge mod won’t load on Fabric. Community bridge projects such as Sinytra Connector, together with Forgified Fabric API, have let some Fabric mods run on NeoForge for certain versions. They lag behind new releases and aren’t a beginner option.

If the mods you want are split between loaders, pick the loader that has the mods you care about most. Then look for versions of the others built for that loader. Our Fabric vs NeoForge comparison covers that decision in more detail.

Reading a mod file name: loader, mod version, Minecraft version

Most mistakes come from downloading a file for the wrong loader or game version. Mod file names usually tell you both:

Check the mod page as well. Modrinth and CurseForge both list the supported game versions and loaders for every file. The first example is the trickiest: the mod’s own version (26.1.0) looks like a game version, but the “mc26.1.2” part tells you which game version it actually needs.

Method 1: Install mods manually (no CurseForge needed)

Installing by hand works with every loader and takes about five minutes: run the loader installer, run the profile once, copy the files into the folder. It is also the best way to understand what a mod manager does for you.

Install Fabric Loader

1. Open the Minecraft Launcher, choose the “Latest release” installation, and play 26.3 once. Then close the game.
2. Download the Fabric installer from fabricmc.net. There is a Windows .exe and a universal .jar.
3. Open it, stay on the Client tab, choose Minecraft version 26.3 and the latest loader version, and leave “Create profile” ticked.
4. Click Install.
5. Reopen the Minecraft Launcher. A profile called something like “fabric-loader-26.3” now appears in the version dropdown next to the Play button.

Install NeoForge

1. Play vanilla 26.3 once from the launcher, as with Fabric.
2. Download the newest 26.3 installer from neoforged.net.
3. Run the installer .jar. You need Java 25 installed for this, as explained above. Choose “Install client” and confirm.
4. Select the new NeoForge profile in the Minecraft Launcher.

Forge works the same way. Use the installer from files.minecraftforge.net and choose “Install client.”

Find the mods folder on Windows, macOS and Linux

The mods folder sits inside your .minecraft game directory. If it isn’t there, launch the loader profile once and the loader creates it, as Fabric’s documentation explains. That fixes the common “I don’t have a mods folder in .minecraft” problem.

You can also create the folder yourself. Name it exactly mods, in lowercase.

Add dependencies (Fabric API, libraries)

Fabric API is a separate mod that provides shared code most Fabric mods depend on. Download the build tagged for your game version from Modrinth or CurseForge. A third-party listing showed 0.162.0+26.3 dated October 6, 2026. Then put the .jar in the same mods folder as your other mods.

Other dependencies work the same way. A mod page lists required libraries, such as Cloth Config or Architectury API, under “Dependencies.” Each one goes in the mods folder as a separate .jar, matching your loader and game version.

Launch and confirm mods loaded (the Mods menu)

Select the loader profile in the launcher and click Play. The first launch with mods is slower than vanilla.

To confirm the mods loaded:

• NeoForge and Forge: the title screen has a Mods button that lists every loaded mod.
• Fabric: install Mod Menu to get the same button. Without it, the only signs are the mods’ own changes and the log file.

If the game launched but nothing changed, you probably started the vanilla “Latest release” profile by mistake.

Method 2: Use a mod manager (CurseForge App, Modrinth App, Prism Launcher)

A mod manager is the easiest way for beginners and the only sensible way to run modpacks. It creates a separate instance with the right loader and Java, downloads dependencies, and keeps your vanilla game untouched.

CurseForge App

The CurseForge App runs on the Overwolf framework. It has the largest catalogue of Minecraft modpacks. Create a profile, choose 26.3 and a loader, then click Install on any mod and the app fetches dependencies for you.

It is the easiest option for big CurseForge packs. The costs are ads and the Overwolf layer.

Modrinth App

The Modrinth App is free, ad-free and open source. It is still labeled beta. You create an instance, pick a loader and version, and browse Modrinth with filters already set to your instance.

If you have used the r2modman mod manager for Thunderstore games, the profile-based approach will feel familiar.

Prism Launcher (both platforms, no Overwolf)

Prism Launcher is a free, open-source launcher. It can import modpacks from both CurseForge and Modrinth and keeps each setup in its own instance. You sign in with your Microsoft account, so you still need to own Java Edition.

Prism suits players who run several versions side by side, for example a 26.3 Fabric instance, an older Forge pack and a vanilla snapshot instance. Its settings take longer to learn, but you are tied to neither platform.

Installing a full modpack

A modpack is a pre-built set of mods, configs and a fixed loader version. Install it as a whole, not mod by mod:

1. Search for the pack in your app of choice.
2. Click Install. The app creates a new instance with the exact loader and game version the pack needs.
3. Give the instance enough RAM in its settings. Many large packs suggest 6 to 8 GB, and the pack page usually lists a number.
4. Launch from the app, not from the vanilla Minecraft Launcher profile.

Don’t update a modpack’s Minecraft version yourself. Wait for the pack author to release an update.

How to add mods on Bedrock (Windows, mobile, console)

Bedrock Edition can’t run Java mods. It uses add-ons: behavior packs and resource packs packaged as .mcpack or .mcaddon files. A .mcpack is a single pack, while a .mcaddon bundles related packs together.

Import .mcaddon / .mcpack files

On Windows, Android and iOS:

1. Download the add-on from its creator’s official page.
2. Open the file. On Windows, double-click it. On mobile, tap it and choose Minecraft. The game opens and shows “Import started” and then “Successfully imported.”
3. Create or edit a world, go to Behavior Packs and Resource Packs, and activate the packs.
4. If the add-on page asks for them, turn on the experimental toggles listed under Experiments. Worlds with experiments enabled can’t have them turned off later.

Marketplace add-ons

On Xbox, PlayStation and Switch, the Minecraft Marketplace is the only way to get add-ons. Consoles can’t import files from outside. This is the honest answer to “I bought Minecraft on Xbox/Switch, can I get mods?”: you get Marketplace add-ons, not Java mods. Marketplace items are bought with Minecoins and work on any Bedrock device signed in to the same Microsoft account.

Add-ons on a Bedrock server

A Bedrock Dedicated Server can’t load .mcaddon or .mcpack files directly. Both formats are zip archives.

1. Rename the file to .zip and extract it.
2. Copy behavior packs into behavior_packs and resource packs into resource_packs.
3. Add each pack’s UUID and version, taken from its manifest.json, to the world’s world_behavior_packs.json and world_resource_packs.json.

Playing mods with friends (servers and LAN)

The server and every player need the same loader, the same game version and the same content mods. Client-only mods are the exception: only the player using them needs them.

How to tell the two apart:

• Content mods add blocks, items, mobs or dimensions. These go on the server and on every client, in the same versions.
• Client-only mods change what you see or how fast it runs, such as Sodium, Iris Shaders and most minimaps. Don’t put them on the server. Some will crash a dedicated server.
• Server-side mods such as admin or world-management tools often only need to be on the server.

To run a modded server, use the same installer you used for the client and choose “Install server,” or download Fabric’s server launcher. Run it with Java 25. Then copy the content mods into the server’s own mods folder.

For LAN play, the host opens the world to LAN and everyone else joins with the same mod list. A modpack instance is the easiest way to make sure everyone’s mods match.

Is it safe? How to download Minecraft mods without malware

Mods are code that runs on your PC, so where you download them from matters as much as which mods you choose. Stick to Modrinth, CurseForge and the official project pages that those listings link to.

The best-documented recent case: on June 18, 2025, Check Point Research described fake Minecraft mods spread through the Stargazers Ghost Network. That network is a group of GitHub accounts that star and promote malicious repositories so they look trustworthy. The fake mods were Java files posing as cheat and macro tools. They downloaded stealers that took Minecraft, Discord and Telegram tokens.

Check Point began tracking the campaign in March 2025 and estimated more than 1,500 infected devices.

The big platforms aren’t immune either. In June 2023, the fractureiser malware spread through compromised author accounts on CurseForge and Bukkit before it was cleaned up. Both platforms moderate uploads, and Modrinth reviews new projects before they go public. To the question “Is Modrinth safer than CurseForge?”: both are far safer than random sites, and neither is a guarantee.

Red flags that should stop a download:

• The “mod” is an .exe or arrives inside a password-protected archive.
• It is a cheat client or “free premium” tool. That is exactly the bait the Stargazers campaign used.
• The site re-hosts files from Modrinth or CurseForge with its own download buttons.
• It’s a small GitHub repo with lots of stars, no history and no matching Modrinth or CurseForge page.
• The file is offered for a version the official page doesn’t list.

Mods not working? Fix the most common problems

Most launch failures come from five causes: the wrong loader, a missing dependency, the wrong game version, duplicate mods, or the wrong Java version. The crash screen or log usually tells you which one it is.

Game crashes on launch

Open .minecraft/logs/latest.log or the newest file in .minecraft/crash-reports. Search for the words “missing,” “requires,” “incompatible” or a mod name. Fabric and NeoForge usually show a readable error screen that names the mod and what it needs.

If nothing obvious shows up, split your mods in half. Move half of them out of the folder and launch. If the game starts, the problem is in the half you removed. Keep halving until one mod is left. With 40 mods, it takes about six launches.

Mod doesn’t show up

This is the classic “I put the mod in the mods folder but it’s not showing up in game.” Check three things:

1. You launched the Fabric or NeoForge profile, not “Latest release.”
2. The file ends in .jar and isn’t still inside a .zip.
3. The mod is built for your loader.

On Fabric, remember there’s no Mods button without Mod Menu.

“Requires Fabric API” / missing dependency

The error names the mod it needs and usually a version range. Download that exact dependency from the same platform, for the same game version, and put it in mods. If you used a mod manager, reinstalling the mod through it usually fetches the dependency automatically.

Wrong Java version

Since 26.1, everything in the chain needs Java 25: installers, servers and third-party launchers. The official launcher includes Java 25 for the game itself. If an installer or server fails, install Java 25 and make sure it is the version your system uses by default.

Mods broke after a Minecraft update

The Minecraft Launcher updates “Latest release” automatically. To keep a modded game stable, create a new installation fixed to 26.3, or rely on your loader profile, which stays on its version.

FAQ

How do I import mod files to Minecraft?

Put the .jar file in the mods folder inside .minecraft, then launch your loader’s profile. There’s no import button on Java Edition. On Bedrock, opening a .mcpack or .mcaddon file imports it automatically.

Can you install Minecraft mods for free?

Yes. Fabric, NeoForge, Forge, the Modrinth App, Prism Launcher and the CurseForge App are all free, and so are almost all mods. You only pay for Minecraft itself, and for Marketplace content on Bedrock.

Can I install Minecraft mods without CurseForge?

Yes. You can install by hand from Modrinth or official project pages, or use the Modrinth App or Prism Launcher. CurseForge is one source among several, not a requirement.

Are Minecraft mods easy to install?

Yes, once the versions match. A mod manager makes it a few clicks. Installing by hand means running one installer and copying files into one folder. Most problems come from version mismatches, not from the install steps.

Where is the Minecraft mods folder?

%APPDATA%\.minecraft\mods on Windows, ~/Library/Application Support/minecraft/mods on macOS and ~/.minecraft/mods on Linux. If it’s missing, launch the loader profile once, or create a folder named mods yourself.

Should I use Fabric or Forge (NeoForge)?

Use whichever loader the mods you want are built for. Fabric is best for performance and visual mods like Sodium and Iris. NeoForge is best for large content and tech mods. Forge is mainly for older packs.

Can I use Fabric and Forge mods together?

Not in a normal setup. Bridge layers such as Sinytra Connector with Forgified Fabric API have let some Fabric mods run on NeoForge for certain versions, but they lag behind new releases and often break. Choose one loader per instance.

Can you put mods in Minecraft Bedrock, on console or on mobile?

Not Java mods. Bedrock on Windows and mobile can import .mcpack and .mcaddon add-ons. Xbox, PlayStation and Switch can only use add-ons from the Minecraft Marketplace.

Why aren’t my mods showing up in Minecraft?

The usual causes are launching the vanilla profile, a file for the wrong loader or version, a missing dependency like Fabric API, or the .jar sitting inside a subfolder or zip. On Fabric, you also need Mod Menu to see a Mods button.

Do I need Java installed to use Minecraft mods in 2026?

Not to play. The Minecraft Launcher includes the Microsoft Build of OpenJDK 25, which Java Edition has needed since 26.1. You do need Java 25 installed yourself to run .jar installers, host a modded server or use a launcher that doesn’t download Java.

Why is there no 1.22, and which version do I download mods for now?

Mojang switched to year-based numbers in 2026, so the version after 1.21.x was 26.1. Download mods for 26.3, the latest full release, and skip 26.4 snapshots until 26.4 is officially released.

Once your first modded instance loads, copy it before you add anything big. Keep that clean copy as your fallback and experiment in the duplicate, so you can always go back to a version that works.

What changed

• Nov 13, 2026 First published.

About the article

JO

Written by Jess Okonkwo

Jess writes about Minecraft, The Sims and survival and indie game mods, plus some of the weekly trending picks. She likes mods that change how a game plays rather than just how it looks.

• Fact-checked by Hollis Tremaine against the sources listed below before publication.
• Published November 13, 2026

Sources (8)

1. Fabric for Minecraft 26.3 (fabricmc.net)
2. Fabric for Minecraft 26.1 (fabricmc.net)
3. Minecraft Java Edition 26.3 (minecraft.net)
4. Java Edition 26.4 Snapshot 7 (minecraft.wiki)
5. Minecraft 26.1 Snapshot 1 (minecraft.net)
6. NeoForge for Minecraft 26.1 (neoforged.net)
7. NeoForge 26.3 server download (doomhosting.com)
8. Minecraft Forge downloads (files.minecraftforge.net)

Spotted an error? Tell us