Learning how to install Minecraft mods starts with identifying which edition you play: traditional mods are for Java Edition, while Bedrock Edition uses add-ons.
The right loader and matching version matter just as much as the mod itself, and a few checks before you launch can prevent frustrating crashes.
Know which Minecraft edition you have
Minecraft: Java Edition is available on Windows, macOS, and Linux.
It supports community-created mods, which are installed with a mod loader such as Forge or Fabric.
A Java mod typically works only with a particular Minecraft version and loader.
Minecraft: Bedrock Edition is the version found on consoles, mobile devices, and Windows.
It uses resource packs and behavior packs, often grouped as add-ons.
These are different from Java mods and follow Bedrock’s in-game activation process.
Minecraft’s official Bedrock Add-Ons guide explains the distinction and notes that add-ons work in single-player, multiplayer, and Realms worlds, but not on personal non-Realms servers.
If you are unsure, check the title screen or the game installation listed in the Minecraft Launcher.
A mod file intended for Java will not install as a Bedrock add-on, and a Bedrock add-on will not work in Java Edition.
Before installing a Java mod
Check the mod’s download page for four details: the Minecraft version, the required loader, any dependencies, and whether it is client-side, server-side, or required on both.
For example, a mod built for Minecraft 1.20.1 and Fabric will not normally work with Minecraft 1.21 and Forge.
Similar names do not mean the files are interchangeable.
- Back up worlds. Copy important saves before opening them with a new mod setup.
A mod can change blocks or world data, and removing it later may leave missing content.
- Use a reputable source. Prefer the mod author’s page or a well-known mod hosting service.
Minecraft Support says Java mods come from third-party sites, are not created or reviewed by Mojang, and may cause the game to malfunction.
- Check the file type. Java mods commonly download as
.jarfiles.Avoid running unexpected installers or files that ask for unrelated account details.
- Confirm dependencies. Some mods require a library mod or another component.
Install only the dependencies listed by the author, matching the same game version and loader.
Modding is community-supported rather than officially supported by Minecraft Support.
Review the official Java Edition mods guidance if you want to understand the support limitations and basic precautions.
How to install Minecraft mods with a loader
1. Choose the mod loader the mod requires
Read the mod’s requirements before downloading a loader.
Forge and Fabric are common choices, but they are separate systems.
Quilt is another loader used by some mods.
Install the one named by the mod author; do not assume a mod made for one loader will work with another.
Get the loader from its official website, and select the Minecraft version required by your mod.
Follow the loader’s current installation instructions.
Many installers create a separate profile or installation in the Minecraft Launcher.
If an installer offers an option to change an unrelated browser setting or asks for credentials, stop and verify that you are on the loader’s official site.
2. Launch the loader profile once
Open the Minecraft Launcher and select the installation created by the loader.
Start the game once without adding mods, then close it.
This initial launch lets the loader create the folders and files it needs.
If the profile does not appear, check the loader’s installation instructions and the Launcher’s Installations tab.
3. Find the game’s mods folder
The usual Java Edition game directory is named .minecraft.
On Windows, it is commonly located in %AppData%\.minecraft; on macOS, it is commonly ~/Library/Application Support/minecraft; and on Linux, it is commonly ~/.minecraft.
These locations can differ if you changed the game directory or use a launcher that manages separate instances.
Open the specific game directory used by the loader profile and look for a folder named mods.
If it does not exist, create a folder named exactly mods in that directory.
Do not put the mod in resourcepacks, saves, or the main Minecraft folder itself.
4. Add the mod file and check its dependencies
Move the downloaded .jar mod file into the correct mods folder.
Keep the file as a .jar; do not extract it unless the mod’s own instructions specifically say to.
Add any required library mods to the same folder, making sure they match the loader and Minecraft version too.
5. Start Minecraft with the same loader and version
In the Launcher, select the loader installation that matches the mod, then start the game.
The title screen or a loader menu may show which mods loaded.
Open a test world first, especially if the mod changes terrain, inventory, creatures, or world generation.
Once it works, use a copy of your main save before testing there.
Installing Bedrock add-ons
For Bedrock, use the Minecraft Marketplace for its built-in add-on catalog, or follow the add-on creator’s instructions for compatible files.
Marketplace content is available through Minecraft’s Marketplace and library.
On other platforms, file import options vary by device, and console file access is more restricted than on a computer or phone.
Avoid guides that promise Java-style mod folders on consoles.
To activate an add-on in a new single-player world, open Play, choose Create New, then select the relevant resource packs or behavior packs and activate the desired pack before creating the world.
For an existing world, use its pencil/edit control, open Resource Packs or Behavior Packs, and activate the pack.
These steps are listed in Minecraft’s official instructions for activating Bedrock add-ons.
Remember that add-on availability and setup can depend on platform, account access, and whether the content is Marketplace content.
The official directions cover Realms setup separately; when joining a Realm, add-ons active on that Realm download and apply automatically on supported Bedrock devices.
Common Minecraft mod installation problems
The game crashes at startup
Remove the most recently added mod and launch again.
Then check that every remaining mod supports the exact Minecraft version and loader you selected.
A dependency conflict, missing library, or incompatible Java runtime can also prevent a loader profile from starting.
Read the crash message and the mod’s compatibility notes before reinstalling components.
The mod does not appear in game
Confirm that you launched the loader profile rather than the standard game profile.
Check that the file is in the mods folder for that profile’s game directory, and make sure the download is a mod rather than a resource pack or shader.
Some launchers create a separate folder for every instance, so the default .minecraft folder may not be the one in use.
The world reports missing content
That message often means a world was created or saved with a mod that is now absent.
Close the world without saving if possible, restore the matching mod and version, or load a backup.
Removing a content mod from a world can delete or alter blocks and items associated with it.
A Bedrock add-on fails to load
Restart Minecraft, confirm the add-on is activated in the correct world’s resource or behavior pack settings, and check for conflicts with other packs.
Minecraft recommends disabling conflicting add-ons, reordering packs that affect the same assets, or testing one add-on in a new world.
If a pack seems corrupted or incomplete, redownload it from its source.
Install one mod at a time
For a simple first setup, select one mod, verify its Minecraft version and loader, install the loader profile, place the mod file in that profile’s mods folder, and launch a copied or new world.
If it loads correctly, add the next mod and repeat; when a crash appears, you will know which recent change to investigate.