Tutorials

Step-by-step guides for installing mods, modpacks, plugins, and add-ons for both Java and Bedrock.

Read Documentation

Start Here

Installing Minecraft content is mostly about matching three things: your Minecraft version, your loader, and the project's target version. If one of those doesn't match, the game may crash or refuse to start and that's normal. Java has more moving parts (loaders, dependencies, Java versions). Bedrock is usually simpler: import the file, then enable it in world settings.

Below are step-by-step tutorials for both Java and Bedrock Edition. Use the table of contents on the left to jump to the exact workflow you need.


Java: Setup

For Java, you'll almost always install a mod loader first. The loader is what actually runs mods. If you're not sure which one to pick, start with this rule of thumb:

  • Forge / NeoForge: best when your must-have mods are Forge-based or you want classic modpack compatibility.
  • Fabric: best when you want a lightweight setup, fast version updates, and strong performance mods.

1) Check your Minecraft version (and Java)

  1. Decide your target Minecraft version (example: 1.20.1). Most mods only support a few versions.
  2. Pick one loader (Forge/NeoForge or Fabric). Do not mix loaders in the same instance.
  3. Client Java: if you use the official launcher, Java is usually handled automatically. Some third-party launchers let you choose a Java runtime-use the recommended one for your Minecraft version.
  4. Where mods live on Windows: %AppData%\\.minecraft\\mods (the folder may not exist until you run the loader once).
Safety checklist: Download mods and loaders from official sources, avoid re-upload sites, and don't run random executables. Mods should normally be .jar files.

2) Install Forge / NeoForge (client)

  1. Download the installer for your exact Minecraft version from the official site.
  2. Run the installer and choose Install client.
  3. Open the Minecraft Launcher and select the new Forge/NeoForge profile.
  4. Launch once to generate the mods folder and confirm it starts.
  5. Close the game before adding any mods.

3) Install Fabric (client)

  1. Download the Fabric Installer from the official Fabric website.
  2. Run the installer, select your Minecraft version, and click Install.
  3. Launch Fabric once so the instance creates its folders.
  4. Install Fabric API (many Fabric mods require it). Download the version that matches your Minecraft version.

Java: Install Content

This section covers the most common Java downloads and where they go. If you only remember one thing: match your Minecraft version and your loader.

1) Install mods (.jar) manually

  1. Install a loader first (Fabric or Forge/NeoForge) and launch it once.
  2. Download the mod file (usually .jar) for your exact Minecraft version and loader.
  3. Move the file into your mods folder. On Windows this is typically %AppData%\\.minecraft\\mods.
  4. Add dependencies if the mod requires them (common examples: Fabric API, Architectury, GeckoLib).
  5. Launch the game and confirm the mod shows up in the Mods menu.
Common mistake: Installing a Forge mod on Fabric (or vice versa). If the mod page doesn't mention your loader, assume it's not compatible.

2) Install resource packs (.zip)

Resource packs change visuals and sounds. They do not require a mod loader.

  1. Download the resource pack .zip.
  2. Open Minecraft → OptionsResource Packs.
  3. Click Open Pack Folder.
  4. Move the .zip into that folder.
  5. Back in Minecraft, enable it under Available.
Do not unzip most resource packs. Minecraft expects them as a .zip unless the pack author says otherwise.

3) Install shaders (OptiFine or Iris)

Shaders are a separate system from resource packs. They usually require a shader loader.

  • Fabric: use Iris (commonly paired with Sodium).
  • Forge/NeoForge: many players use OptiFine or modern shader alternatives depending on version.
Shader install checklist
  1. Install your chosen loader (Fabric or Forge/NeoForge) and launch once.
  2. Install your shader loader (Iris/OptiFine) that matches your Minecraft version.
  3. Download the shader pack (usually a .zip).
  4. In Minecraft: Video SettingsShadersOpen Shader Pack Folder.
  5. Move the shader .zip into that folder and select it in-game.

4) Install datapacks

Datapacks are world-specific and work in vanilla Minecraft. They change rules (loot, recipes, functions, worldgen), not graphics.

  1. Download the datapack (usually a .zip).
  2. Open your world folder.
  3. Place it into …/saves/<your-world>/datapacks.
  4. In-game, run /reload (or restart the world) to apply changes.

5) Install modpacks (recommended: use a launcher)

Modpacks are more than a collection of mods-they include configs and sometimes custom scripts. Installing them manually is error-prone, so a launcher is the safest option.

  1. Install a launcher (CurseForge App, Prism Launcher, or Modrinth App).
  2. Create or import an instance from the modpack page.
  3. Allocate enough RAM (many packs need 6–10 GB, depending on size).
  4. Launch once and wait for the first load (it can take several minutes).

6) Update safely

  1. Back up your world before updating anything.
  2. Read the changelog (look for removed mods or "new world recommended" notes).
  3. Update through your launcher when possible.
  4. Test in a copy of your world if the update is large.

Java: Troubleshooting

1) Crash checklist (most issues fall here)

  1. Loader mismatch: confirm you're launching the correct profile (Forge/NeoForge/Fabric).
  2. Version mismatch: confirm every mod matches your Minecraft version.
  3. Missing dependencies: install required libraries (the mod page usually lists them).
  4. Too many changes at once: add mods in small batches so you can identify the culprit.
  5. Mod conflicts: if two mods touch the same system, remove one and test.
What to do when it crashes immediately
  1. Remove the last mod you added (or the last batch).
  2. Launch again. If it works, add mods back one-by-one to find the exact file causing the crash.
  3. If it still crashes, temporarily move all mods out of the mods folder and test.
  4. Once vanilla + loader runs, add mods back carefully.

2) Find logs & crash reports

Logs are the fastest way to diagnose problems. When asking for help, share the log content (not screenshots) and include your Minecraft version + loader.

  • Logs: %AppData%\\.minecraft\\logs\\latest.log
  • Crash reports: %AppData%\\.minecraft\\crash-reports
Quick clue: the top of the crash report often mentions the mod ID or file that triggered the crash.

Java: Servers & Plugins

1) Plugins vs mods (quick clarity)

Plugins are for plugin servers (Paper/Spigot). Players can usually join with a vanilla client.Mods are for modded servers (Forge/Fabric) and typically require the same mods on both client and server.

2) Install a Paper server and add plugins

  1. Create a new folder for your server (keep it separate from your client files).
  2. Download the Paper server jar for your Minecraft version from the official Paper site.
  3. Run the server once to generate files and folders.
  4. Accept the EULA in eula.txt (Paper won't start until you do).
  5. Drop plugin .jar files into the plugins folder.
  6. Restart the server and check the console for plugin load messages.
Version matching matters: Your server version, plugin version, and client version should match. If something breaks, update one thing at a time.

3) Modded servers (Forge/Fabric) - basic approach

A modded server is different from a plugin server. It runs a mod loader, and most gameplay mods require the same mods on both client and server.

  1. Create a fresh server folder on your machine.
  2. Install the server loader that matches your client (Forge/NeoForge or Fabric) for the same Minecraft version.
  3. Run once to generate files, then accept the EULA in eula.txt.
  4. Copy the same mod files into the server's mods folder (server-side compatible mods only).
  5. Start the server and join with the matching modded client instance.
Client-only mods vs server mods

Some mods are client-only (UI, minimaps, performance) and should not be installed on the server. Many mod pages explicitly say "client", "server", or "both". If the server refuses to start after adding a mod, remove it first and check its compatibility.


Bedrock Edition

Bedrock tutorials focus on importing .mcpack, .mcaddon, and .mcworld files and enabling them correctly in world settings or global settings.


1) Adding / Importing Content into Minecraft

Supported file types:

  • .mcpack → Resource Pack or Behavior Pack
  • .mcaddon → Bundle (Resource + Behavior)
  • .mcworld → Complete World (may already include packs)

Android - Using MCPEDL App

  1. Install and open MCPEDL for Minecraft.
  2. Select the content you want to add.
  3. Tap Download, then tap the downloaded file (ads may appear).
  4. When Android asks "Open with", select Minecraft.
  5. Minecraft will launch and begin importing automatically.
  6. Once the import is successful, the content becomes available in World Settings or Global Resources.

Android - Manual File Installation (Recommended)

  1. Download the .mcpack, .mcaddon, or .mcworld file.
  2. Install Cx File Explorer from the Play Store.
  3. Open Cx File Explorer and navigate to your download location (usually Downloads).
  4. Tap the file and select Minecraft when prompted.
  5. Minecraft will open and start importing.
  6. After a successful import, the content can be enabled from settings.
Note: Some default file managers do not show Minecraft as an option when opening .mcpack files. Trying a different file manager usually fixes it.

Windows (Minecraft Bedrock for Windows)

  1. Download the .mcpack, .mcaddon, or .mcworld file.
  2. Open File Explorer and go to your download folder.
  3. Double‑click or Right‑click → Open with → Minecraft.
  4. Minecraft will launch and import the content.
  5. Once imported, the content is available in settings.

iOS / iPadOS (Files app)

  1. Download the .mcpack, .mcaddon, or .mcworld file to the Files app.
  2. Tap the file.
  3. Choose Open in Minecraft (or share → Minecraft).
  4. Minecraft will open and import the content.
If Bedrock import fails
  • Confirm the file extension is correct (.mcpack/.mcaddon/.mcworld).
  • Make sure the download finished completely (partial downloads often fail).
  • Check you have enough storage space.
  • Restart Minecraft and try importing again.

2) Enabling Content in Minecraft

Importing alone is not enough. Packs must be enabled.

Enabling Packs in a New World

  1. Open Minecraft.
  2. Click Play → Create New → Create New World.
  3. Open Resource Packs and activate the pack under Available Packs.
  4. Open Behavior Packs (if applicable) and activate the pack under Available Packs.Behavior packs disable achievements for that world.
  5. If required, enable the needed Experimental toggles.
  6. Create the world.

Enabling Packs in an Existing World

  1. Go to Play.
  2. Click the Edit icon next to your world.
  3. Open Resource Packs and find and activate the required packs.
  4. Open Behavior Packs and find and activate the required packs (if applicable).
  5. Scroll to Experiments and enable required toggles.
  6. Save and enter the world.

Using Global Resources

Global Resources apply to all worlds automatically (unless a world overrides them).

  1. Open Settings → Global Resources.
  2. Find and activate the resource pack.
  3. The pack will now load in every world unless overridden.
Important: Behavior packs cannot be global. They must be enabled per-world.

3) Configuration: Subpack Settings

Some Resource Packs include Subpacks. Subpacks allow users to switch between multiple visual or functional variants inside the same pack (for example: different UI styles, resolutions, colors, or effects).

Where to Find Subpack Settings

Subpacks can be configured per world or via Global Resources, depending on how the resource pack is applied.

Option A: Per‑World Subpack Configuration

  1. Go to Play.
  2. Click the Edit icon next to your world.
  3. Open Resource Packs.
  4. Locate the active resource pack.
  5. Click the Settings (gear) button next to it.
  6. Exit settings - changes apply instantly or on world reload.

Option B: Global Resource Subpack Configuration

  1. Open Settings → Global Resources.
  2. Locate the active resource pack.
  3. Click the Settings (gear) button next to it.
  4. Select the desired subpack.
  5. Exit settings - changes apply instantly or on world reload.
Tip: When configured as a Global Resource, the selected subpack applies to all worlds unless a world explicitly overrides it.

4) Consoles & Realms (important limitation)

On consoles (PlayStation, Xbox, Switch), importing downloaded .mcpack files is often restricted. The most reliable options are:

  • Marketplace content (official, console-friendly).
  • Realms workflow: import packs on Windows/Android/iOS, apply them to a world, then upload that world to a Realm and download it on console.
If you tell us your device (Xbox/PlayStation/Switch) and whether you have Realms, we can add a dedicated console step-by-step guide.

Want a tutorial added next? Let us know your edition and your goal!