- Fabric is a lightweight mod loader; install Fabric Loader first, then drop mod JARs into the mods folder.
- You need Java 21 or newer for Minecraft 1.21, and Minecraft launched at least once before installing.
- Mod JARs go in %appdata%.minecraft\mods on Windows (with macOS and Linux equivalents).
- Opal uses a loader system: the Opal Launcher handles Fabric, authentication, install, and updates for you.
Fabric is a lightweight mod loader for Minecraft. It is fast, actively maintained, and supports modern Minecraft versions. Many utility clients, including Opal, run on Fabric. This guide walks through installing Fabric Loader, adding mods, and setting up Opal.
Prerequisites
Before you start, make sure you have:
- Minecraft Java Edition installed and launched at least once
- Java 21 or newer installed (required for MC 1.21+)
- A working internet connection
Install Fabric Loader
Download the Fabric installer
Go to the official Fabric website at fabricmc.net, click Download, select the Installer option, and download the Universal JAR installer.
Run the installer and confirm settings
Run the Fabric installer JAR you downloaded, then make sure these settings are correct:
- Client tab is selected
- Minecraft Version: 1.21.10 (or your target version)
- Loader Version: Latest stable (0.17.x recommended)
- Install Location: Your default
.minecraftdirectory
Click Install. You should see a success message.
Verify the installation
Open the Minecraft Launcher, click the Installations tab, and look for a new profile called fabric-loader-1.21.10 (or similar). Select it and click Play. If Minecraft launches with the Fabric logo on the title screen, you are good.
Install Mods
Fabric mods go in your mods folder:
- Windows:
%appdata%\.minecraft\mods - macOS:
~/Library/Application Support/minecraft/mods - Linux:
~/.minecraft/mods
If the mods folder does not exist, create it. To install a mod:
Download the mod JAR
Download the mod's .jar file from its source.
Place it in the mods folder
Move the .jar into the mods folder for your platform.
Launch with the Fabric profile
Start Minecraft using the Fabric profile, not vanilla.
Installing Opal Client
Opal uses a loader system: you do not drop the full client into the mods folder. Instead:
Purchase Opal
Buy Opal from the dashboard ($8.99 lifetime).
Download the Opal Launcher
Grab the Opal Launcher from the downloads page. It handles authentication, installation, and updates automatically.
Or use the loader JAR
Alternatively, download the Opal Loader JAR and place it in your mods folder. It will authenticate and download the client at runtime.
The launcher is the recommended approach: it manages everything for you.
Troubleshooting
"Fabric doesn't show up in the launcher"
Make sure you installed Fabric for the correct Minecraft version. Re-run the installer if needed.
"Game crashes on launch"
- Check that you have Java 21 installed (not Java 8 or 17)
- Remove any incompatible mods from the
modsfolder - Make sure Fabric Loader is up to date
"Mods aren't loading"
- Verify the
.jarfiles are in the correctmodsfolder - Make sure you are launching with the Fabric profile, not vanilla
- Check that the mod version matches your Minecraft version
"Opal won't authenticate"
- Make sure you have an active internet connection
- Verify your license key is activated on the dashboard
- Check that your HWID has not changed (reset available every 30 days on the dashboard)
- Users in regions with internet restrictions may need a proxy: check the purchase page for details
Next Steps
Once you have Fabric and Opal installed:
- Browse configs: discover community-shared module presets on the dashboard
- Explore modules: check the documentation for a full list of features
- Join Discord: get support, share configs, and connect with the community
- Try scripting: use the GraalVM engine to create custom automation
FAQ
Yes, Opal is a Fabric mod. The Opal Launcher handles Fabric installation automatically, but if you are installing manually, you need Fabric Loader installed first.
No. Fabric and Forge are separate mod loaders with incompatible mod formats. Opal requires Fabric specifically.
Java 21 or newer. Older Java versions (8, 17) will not work with modern Minecraft. Download Java 21 from Adoptium or Oracle.
No. Fabric mods are isolated to the mods folder. If something goes wrong, just remove the mod's JAR file and launch vanilla. Your worlds and saves are unaffected.
Generally yes, as long as the other mods do not conflict. Opal is designed to work as a standalone client mod on Fabric 1.21.10.
