The basic steps to install an add-on in Minecraft

Installing an add-on in Minecraft means downloading a file, moving it to your game folder, and enabling it in your world settings. The exact steps depend on whether you play Minecraft Java Edition or Bedrock Edition — they use different file types and installation paths. Java Edition uses mod loaders like Forge or Fabric, while Bedrock Edition (the version on Windows 10, Xbox, Nintendo Switch, and mobile) uses .mcaddon files that you can import directly into the game.

The fastest route is usually to download an add-on from a site like CurseForge or Planet Minecraft, place the file in the right folder, and restart your game. Most add-ons come with instructions, but the process is the same whether you are adding a new weapon, changing how mobs behave, or altering the world's appearance.

Key Takeaways

  • Minecraft Java Edition requires a mod loader like Forge or Fabric installed before you can add mods, while Bedrock Edition can import .mcaddon files directly without extra software.
  • Download add-ons only from trusted sites like CurseForge, Planet Minecraft, or the official Minecraft Marketplace to avoid malware.
  • Java Edition mods go into your .minecraft/mods folder; Bedrock add-ons are imported through the game's settings menu or by opening the .mcaddon file.
  • Always back up your world before installing a new add-on, because some add-ons can cause crashes or corrupt save files if they conflict with other mods.

Installing add-ons in Minecraft Java Edition

Java Edition requires a mod loader — software that lets Minecraft read mod files. The two most common loaders are Forge and Fabric. Forge works with more mods but runs slower; Fabric is lighter and faster but has fewer mods available. Download the installer for your Minecraft version from the official Forge or Fabric website, run it, and choose "Install Client" when prompted.

Once the loader is installed, open your .minecraft folder. On Windows, press Windows key + R, type %appdata%, and open the .minecraft folder. On Mac, open Finder, press Command + Shift + G, paste ~/Library/Application Support/minecraft, and hit Enter. On Linux, the folder is ~/.minecraft. Inside, create a folder called "mods" if it does not already exist.

Download your add-on file (usually a .jar or .zip file) from CurseForge or Planet Minecraft, then drag it into the mods folder. Launch Minecraft, select your mod loader from the profile dropdown, and start a world. The mod should load automatically. If the game crashes, check that the mod version matches your Minecraft version — a mod built for version 1.19 will not work in version 1.20.

Installing add-ons in Minecraft Bedrock Edition

Bedrock Edition (Windows 10, Xbox, Nintendo Switch, PlayStation, and mobile) uses .mcaddon files instead of a mod loader. Download a .mcaddon file from CurseForge, Planet Minecraft, or the official Minecraft Marketplace. On Windows 10, simply double-click the file — it will open Minecraft automatically and ask you to confirm the import. On mobile or console, download the file, find it in your downloads folder, and open it with Minecraft.

After import, the add-on appears in your world settings under "Behavior Packs" or "Resource Packs" depending on what it modifies. Create a new world, toggle the add-on on, and start playing. Unlike Java Edition, Bedrock add-ons do not require a separate launcher or folder navigation — the game handles everything.

If you want to use multiple add-ons together, import each one separately, then enable all of them in the same world. Bedrock will load them in the order you enabled them, which matters if two add-ons change the same thing. If your world crashes after adding an add-on, disable it in the world settings and try again.

Where to download add-ons safely

CurseForge is the largest repository for both Java and Bedrock add-ons. Search for what you want, check the download count and user reviews, and download the file directly from the site. Planet Minecraft is another trusted source with user-created add-ons and a rating system. The official Minecraft Marketplace (built into the game) sells add-ons, many of which are free.

Avoid downloading add-ons from random websites or links shared in Discord servers without checking the source first. Malicious files can contain viruses or steal your login information. Stick to sites with user reviews and download counts — if an add-on has thousands of downloads and positive reviews, it is almost certainly safe.

Backing up your world before installing

Before you install a new add-on, save a copy of your world. In Java Edition, go to your .minecraft/saves folder and copy your world folder to another location on your computer. In Bedrock Edition, open the world settings, select "Edit World," and choose "Make a Copy." If the add-on causes problems, you can delete it and restore your backup without losing progress.

Some add-ons change how blocks or items work in ways that can corrupt a world if you remove the add-on later. Keeping a backup means you can experiment without risk. If a world crashes after you add an add-on, restore the backup, disable the add-on, and try a different one.

Fixing common installation problems

If your game crashes after installing an add-on, the most common cause is a version mismatch. Check that the add-on supports your Minecraft version — the download page always lists which versions it works with. If you are on Java Edition, make sure you installed the correct mod loader version for your game version.

If the add-on loads but does not work, it may conflict with another add-on you have installed. Try disabling other add-ons one at a time to find the conflict. Some add-ons also require other mods to run first — check the add-on's description page for dependencies. In Bedrock Edition, the order you enable add-ons matters; try moving the new add-on to the top of the list in world settings.

If you cannot find the .minecraft folder on Windows, make sure hidden files are visible. Open File Explorer, click the View tab, and check "Hidden items." The .minecraft folder will then appear in your AppData/Roaming directory.

Using multiple add-ons together

You can install as many add-ons as you want, but too many can slow down your game or cause crashes. Start with one or two and add more gradually so you can identify which one causes problems if something breaks. In Java Edition, load order matters — some mods need to load before others. Most mod loaders handle this automatically, but check the add-on's page if you have conflicts.

In Bedrock Edition, enable add-ons in the world settings menu. The order you see them in that menu is the order they load. If two add-ons change the same thing (like how a zombie looks), the one lower in the list will override the one above it. Experiment with the order if you want a specific add-on's changes to take priority.

Frequently Asked Questions

Can I use Java Edition mods on Bedrock Edition?

No. Java Edition uses .jar and .zip files that require a mod loader; Bedrock uses .mcaddon files. They are not compatible. If you want a specific mod, check whether a Bedrock version exists on CurseForge or Planet Minecraft. Many popular mods have been ported to Bedrock, but not all.

Will add-ons work on a multiplayer server?

In Java Edition, all players on a server must have the same mods installed for the server to work correctly. In Bedrock Edition, the server owner enables add-ons in the world settings, and they apply to all players automatically — players do not need to install anything themselves. Check your server's rules before adding mods.

What happens if I remove an add-on from my world?

In Java Edition, removing a mod can corrupt your world if the mod added custom blocks or items that are now missing. Bedrock is more forgiving — you can usually disable an add-on without breaking the world, though blocks or items from that add-on will disappear. Always back up before removing an add-on you have been using for a while.

Do add-ons work on Minecraft Realms?

Bedrock add-ons work on Realms if the Realm owner enables them in the world settings. Java Edition mods do not work on Realms — only on single-player worlds or private servers you host yourself. Check Realms documentation for the current add-on support on your platform.

Why does my game crash when I load a world with an add-on?

The most common causes are a version mismatch (the add-on does not support your Minecraft version), a missing dependency (another mod the add-on needs), or a conflict with another add-on. Check the add-on's page for supported versions and required mods, disable other add-ons to test for conflicts, and restore your world backup if the crash corrupted it.