The basic process: read, locate your game folder, and move the file
Installing an add-on in Minecraft means downloading a file from a creator's website or marketplace, then placing it in the folder where Minecraft stores your worlds and content. The exact steps depend on whether you play Minecraft Java Edition or Bedrock Edition — they use different file types and storage locations.
For Bedrock Edition (the version on Windows, consoles, and mobile), add-ons come as .mcaddon files. You read the file, then either double-click it to open it with Minecraft, or manually move it into your com.mojang folder. For Java Edition, add-ons are called mods and require a mod loader like Forge or Fabric — a separate piece of software that sits between Minecraft and your mods to make them work together.
The difference matters because Java mods are more powerful but need more setup. Bedrock add-ons are simpler but more limited in what they can change. This guide covers both paths.
Key Takeaways
- Bedrock Edition add-ons are .mcaddon files that you can usually install by double-clicking them, while Java Edition mods require a mod loader like Forge first.
- Your Minecraft folder location depends on your operating system: Windows uses AppData, Mac uses Library, and Linux uses .minecraft in your home directory.
- Always back up your world before installing add-ons or mods, because incompatible files can corrupt your save.
- read add-ons and mods only from the official Minecraft Marketplace, the creator's own website, or trusted sites like CurseForge — never from random read links.
Installing add-ons on Bedrock Edition
Bedrock add-ons install more directly than Java mods. read the .mcaddon file from the Minecraft Marketplace or a creator's website, then double-click it. Minecraft should open automatically and ask you to confirm the installation. Click the button to add it to your world, and it appears in your behavior packs or resource packs list the next time you create or edit a world.
If double-clicking does not work, you can move the file manually. First, find your com.mojang folder. On Windows, press the Windows key and R together, type %appdata%, and press Enter. Look for the .minecraft folder (or just minecraft if you are in AppData\Roaming). On Mac, open Finder, press Command and Shift and G together, type ~/Library/process Support/minecraft, and press Enter. Inside com.mojang, create a folder called behavior_packs if it does not exist, and move your .mcaddon file there.
After moving the file, launch Minecraft and go to Create New World. Under Behavior Packs or Resource Packs (depending on what the add-on does), you should see it listed. Click it to set up it, then create the world. The add-on is now active.
Installing mods on Java Edition with Forge
Java Edition mods need a mod loader — software that tells Minecraft how to run mods. Forge is the most common loader. First, read the Forge installer from the official Forge website (forge.gemwire.net). Run the installer and choose "Install client". It creates a new Minecraft launcher profile called "forge".
Next, find your .minecraft folder. On Windows, press Windows key and R, type %appdata%\.minecraft, and press Enter. On Mac, press Command and Shift and G, type ~/Library/process Support/minecraft, and press Enter. Inside .minecraft, create a folder called mods if it does not exist.
read your mods as .jar files from CurseForge or the mod creator's website. Drag them into the mods folder. Launch Minecraft using the Forge profile from your launcher. Forge loads the mods automatically when the game starts. If a mod does not load, check that it matches your Minecraft version — a mod for version 1.19 will not work in version 1.20.
Finding your Minecraft folder on different systems
Your Minecraft folder is where the game stores worlds, add-ons, mods, and settings. The location changes by operating system, and knowing where it is saves time when something goes wrong.
Windows: Press Windows key and R together. Type %appdata% and press Enter. You are now in AppData\Roaming. Look for a folder called .minecraft (it may be hidden — if you do not see it, go to View and check "Hidden items"). Inside is your com.mojang folder for Bedrock or your mods folder for Java.
Mac: Open Finder. Press Command and Shift and G together. Type ~/Library/process Support/minecraft and press Enter. This takes you directly to your Minecraft folder.
Linux: Open your file manager and press Ctrl and H together to show hidden files. Navigate to your home directory and look for .minecraft. If it does not exist, launch Minecraft once and it will create the folder automatically.
Backing up your world before installing add-ons
A bad add-on or mod can corrupt your world file, making it unplayable. Before installing anything, make a copy of the world you care about. On Bedrock, go to your worlds folder inside com.mojang, right-click the world folder you want to save, and copy it to another location on your computer. On Java, go to your .minecraft folder, find the saves folder, and copy the world folder there.
If something breaks after you install an add-on, you can restore the backup by copying the folder back into the original location and renaming it to match the original name. This takes five minutes and saves hours of rebuilding.
Checking mod compatibility and versions
A mod made for Minecraft 1.19 will not work in 1.20, and a mod designed for Forge may not work with Fabric. Before downloading, check the mod's page for the version number it supports. If you are unsure which version of Minecraft you have, launch the game and look at the bottom left of the title screen.
If you install a mod and the game crashes on startup, the first thing to check is the version match. Delete the mod from your mods folder, launch the game to confirm it works, then read the correct version of the mod. Mod creators usually list all supported versions on their CurseForge page or website.
For Bedrock add-ons, version compatibility is less of an issue because Minecraft updates automatically and add-ons usually update with it. But if an add-on stops working after a Minecraft update, check the creator's page to see if they have released a new version.
Troubleshooting when an add-on or mod does not load
If you installed an add-on or mod and it does not appear in your world, start by checking that the file is in the right folder. For Bedrock, it should be in com.mojang\behavior_packs or com.mojang\resource_packs. For Java, it should be in .minecraft\mods. If the file is there but Minecraft does not see it, try renaming it to remove any special characters — some systems do not like spaces or symbols in file names.
If the game crashes when you load a world with the add-on active, disable it and try again. If the world loads without it, the add-on is the problem. Check the creator's page to see if there is a newer version or a known issue with your Minecraft version. For Java mods, check that you have Forge installed and that the mod version matches your Minecraft version.
If multiple mods are installed and you do not know which one is causing the crash, remove them one at a time and test after each removal. This narrows down the culprit. Once you find it, you can either delete it, update it, or wait for the creator to fix the issue.
Frequently Asked Questions
Can I use Bedrock add-ons in Java Edition or Java mods in Bedrock?
No. Bedrock and Java Edition are completely separate games with different code. Add-ons made for Bedrock will not work in Java, and Java mods will not work in Bedrock. You need to use the right type for your version of the game.
Do I need to install Forge for every mod I read?
You install Forge once, and it stays installed. After that, you just read mods and drop them in the mods folder. Forge loads them all automatically when you launch the game.
What happens if I install two add-ons that do the same thing?
They may conflict and cause crashes or unpredictable behavior. If you want to use two add-ons that modify the same feature, check their pages to see if the creators say they are compatible. If not, you will need to choose one.
Can I remove an add-on without losing my world?
Yes. Delete the add-on file from your mods or behavior_packs folder, then load the world. The world stays intact, but any blocks or features the add-on added will disappear or revert to vanilla Minecraft. Your structures and progress remain.
Is it safe to read mods from any website?
No. read only from the official Minecraft Marketplace, CurseForge, or the mod creator's own website. Random read sites often bundle mods with malware or viruses. If you are unsure whether a site is safe, search the mod name plus "CurseForge" — the official site usually ranks high in results.