- The Fabric loader installs with one tool: the official Fabric installer.
- It adds a new launch profile and never touches your vanilla game.
- The
modsfolder appears after you launch the Fabric profile once. - Match the loader to the exact Minecraft version you plan to play.
Installing the Fabric loader takes one tool and a few clicks. Download the official Fabric installer, run it, pick the Minecraft version you want, and let it write a new launch profile. Open your launcher, select that Fabric profile, and start the game once. The loader is now active and ready for mods.
Where Opal fits
Opal is a Fabric mod, so it rides on the same loader you install here. Once the loader is in place, follow the setup guide for the exact version and recommended JVM arguments.
Steps
Download the installer
Get the official Fabric installer from the Fabric project site. It is a small Java program.
Run it
Double-click the jar, or run it from a terminal if double-click does nothing.
Pick your Minecraft version
Choose the exact version you plan to play, such as a recent release or an older one you still use.
Install
The installer writes a new profile into your launcher and downloads the matching loader files.
Select the Fabric profile
Open your Minecraft launcher and switch to the profile the installer created.
Launch once
Start the game on that profile so the loader sets up its files and a mods folder.
What the installer actually does
The installer does not patch the game jar. It adds a launch profile that boots the Fabric loader before Minecraft starts. That loader reads your mods folder at startup and loads each mod. Because the profile sits next to the vanilla one, your unmodded game stays intact and you can switch back any time.
Installer vs launcher support
You have two ways to get the loader in place. Pick whichever fits your setup.
| Method | When to use it | Notes |
|---|---|---|
| Official Fabric installer | Default for the standard launcher | Writes a profile, downloads the loader, done in minutes |
| Launcher with built-in Fabric support | You already use a third-party launcher | The launcher handles version matching for you |
Both end the same way: a Fabric profile you select before launching.
Where files land
| OS | Path |
|---|---|
| Windows | %appdata%\.minecraft |
| macOS | ~/Library/Application Support/minecraft |
| Linux | ~/.minecraft |
The mods folder appears inside that directory after the first Fabric launch. Drop mod jars there once it exists.
When the loader will not install
- Installer will not open: Java may be missing or the jar opens with the wrong program. Install a current Java runtime and try again.
- No Fabric profile in the launcher: refresh or restart the launcher, then look for the new profile in the version dropdown.
- Game crashes after adding mods: the loader is fine, but a mod targets a different Minecraft version. Match every mod to the version you installed.
- Wrong Minecraft version: re-run the installer and pick the correct version. It can write more than one profile.
FAQ
No. Fabric is a separate mod loader. You install one or the other per profile, not both at once.
No. The installer adds a new profile and leaves your vanilla game untouched. Switch profiles to go back.
In the mods folder inside your Minecraft directory. It is created the first time you launch the Fabric profile.
Yes. Some launchers add Fabric support for you and skip the standalone installer entirely.
