Getting Started with Minecraft Modding

Minecraft modding is intimidating mostly because there are too many right answers. This guide picks one path that works in 2026 — Java Edition, Fabric on the latest stable Minecraft, Prism Launcher — and walks through it end-to-end. Once you've done it once, the alternatives (Forge, NeoForge, Quilt) become small variations of the same flow.

If you're on Bedrock Edition, this guide doesn't apply. Bedrock "add-ons" are a separate system — packaged from the Marketplace or sideloaded as .mcaddon/.mcpack files, no third-party loader involved.

Step 0 — Install a real launcher

The official Minecraft Launcher works, but it tucks mod folders inside a hidden AppData path and discourages multiple Minecraft instances. Switch to a community launcher first:

Prism Launcher (prismlauncher.org) — current community standard, open-source, actively maintained.
ATLauncher — an alternative, useful if you want a built-in modpack browser.

Install Prism, point it at your Minecraft account (it uses the official Microsoft auth flow), and you're done with launcher setup.

Step 1 — Create a Fabric instance

In Prism Launcher: Add Instance → pick the Minecraft version you want (latest stable is fine if you're not joining a specific server) → on the right, set Mod Loader to Fabric and accept the suggested Fabric Loader version.

Click OK. Prism creates the instance and downloads everything: vanilla Minecraft jars, Fabric Loader, the appropriate Java runtime. The default Java version is auto-selected based on the Minecraft version.

Launch the instance once with no mods to confirm it works. You should reach the main menu with "Fabric Loader [version]" in the bottom-left corner.

Step 2 — Install your first mod

Two essential mods for any modern Fabric instance:

Fabric API — a compatibility shim that almost every Fabric mod depends on. Download from modrinth.com/mod/fabric-api. Match the version to your Minecraft version exactly.
Sodium — Performance overhaul, replaces Minecraft's rendering pipeline. Download from modrinth.com/mod/sodium.

In Prism: right-click your instance → Edit Instance → Mods tab → Add file → select both .jar files. They appear in the mods list, enabled by default.

Launch the instance. Sodium's effect is visible immediately — most laptops see a 2–4× FPS boost on default settings.

Step 3 — Browse and add more

Modrinth and CurseForge are the two main hubs:

Modrinth (modrinth.com) — open-source, faster, recommended.
CurseForge (curseforge.com) — larger catalogue including legacy mods, requires CurseForge's own app for some downloads.

Prism Launcher has a built-in Mods browser (right-click instance → Edit → Mods → Download mods) that searches Modrinth directly. Filter by your exact Minecraft version and Fabric loader, click the green plus button to add — Prism handles the download and version matching.

Step 4 — Resource packs and shaders (optional)

Mods are jar files; resource packs and shaders are separate. From Prism: the Resource Packs and Shader Packs tabs work the same way as Mods, with a built-in Modrinth browser.

The standard shader stack on Fabric: Iris Shaders (mod) + a shader pack of your choice (Complementary Shaders is a good starting point). Install Iris as a normal mod through Prism, then drop the shader pack into the Shader Packs tab.

Step 5 — Multiplayer with mods

Three rules:

Server-side mods must be on the server. If a friend hosts a modded server, they install the server-side mods; you install the same mods locally.
Client-side-only mods are optional per player. Sodium, MiniMap, Mouse Tweaks — these affect only the local client, no server install needed.
Version match is mandatory. Minecraft version, loader version, and individual mod versions must match between server and clients. Mismatches produce immediate disconnect on join.

The mod page usually states "client-side", "server-side", or "both" near the top. If it doesn't, assume "both" until proven otherwise.

Common gotchas

Wrong Java version. Minecraft 1.18+ needs Java 17. Minecraft 1.20.5+ wants Java 21. Prism Launcher manages this per-instance automatically; if you're not using Prism, watch out.
Loader-mismatched mod. A Forge mod won't load on Fabric and vice versa. The download page on Modrinth/CurseForge shows compatible loaders explicitly.
Fabric API missing. "ClassNotFoundException for net.fabricmc.api.*" almost always means Fabric API isn't installed. Add it.
Mod targets a different Minecraft version. Even small patch differences (1.20.1 → 1.20.4) can break mods. The error usually says "incompatible Minecraft version".
Mod relies on a separate dependency mod. Many mods depend on libraries like Cloth Config, Architectury, or Forge Config API Port. Read the dependency list on the mod's download page.

That's the core loop. From here, the next steps are picking a content overhaul (Create, Industrial Craft, or Botania depending on your taste) or joining a modpack on Modrinth — Fabulously Optimized is a low-effort starter pack focused on performance and QoL.

If you're a Java modder thinking about publishing, the OpenMods publishing guide explains how to connect a GitHub repo as a download mirror alongside your CurseForge/Modrinth releases.