Known issues
New Minecraft releases can take a few days to get a matching build. Some community Forge ports lag further behind. Mobile launchers may show render glitches in overlays.
Installation
Install MaLiLib Mod
Step-by-step MaLiLib Mod installation for Windows, macOS, Linux, Android and iOS, plus fixes for common errors.
Installation Guide
Pick your platform for step-by-step instructions. Desktop takes about five minutes; mobile launchers take a little longer.
- Download and run the official Fabric installer, choose the Client tab and select your Minecraft version.
- Click Install, then open the Minecraft Launcher once with the new Fabric profile.
- Download the MaLiLib jar that matches your game version from Modrinth or CurseForge.
- Press Win + R, type %appdata%\.minecraft and open the mods folder (create it if needed).
- Move the MaLiLib jar and its dependent mods into the folder, then press Play on the Fabric profile.
- Download the Fabric installer (.jar or universal) and open it; allow it in System Settings if Gatekeeper asks.
- Select the Client tab, choose your Minecraft version and click Install.
- Download the matching MaLiLib jar from an official source.
- In Finder press Cmd + Shift + G and go to ~/Library/Application Support/minecraft/mods.
- Drop the jar in, start the launcher and choose the Fabric profile.
- Install a Java runtime if your launcher does not bundle one, for example OpenJDK 21.
- Run the Fabric installer with java -jar fabric-installer.jar and choose your game version.
- Download the matching MaLiLib jar from Modrinth, CurseForge or GitHub.
- Copy it to ~/.minecraft/mods, or to the instance folder if you use Prism Launcher.
- Launch the Fabric profile and press A + C in a world to confirm it loaded.
- Install a Java Edition launcher for Android, such as a maintained PojavLauncher-based app, and sign in with your Microsoft account.
- Create a new Fabric profile from the launcher's version installer.
- Download the MaLiLib jar that matches that Minecraft version.
- Use the launcher's mod manager or file browser to place the jar in the profile's mods folder.
- Launch, and lower render distance if the device struggles.
- Install Amethyst (the iOS Java Edition launcher) through a supported sideloading method.
- Enable JIT for the app, since Java performance on iOS depends on it.
- Create a Fabric profile for your Minecraft version inside the launcher.
- Import the matching MaLiLib jar into that profile's mods folder.
- Launch with a small mod list first and add more once it runs well.
Bedrock Edition cannot load Java mods. Every method here uses Minecraft Java Edition, including the mobile launchers.
Troubleshooting Guide
Most problems come down to versions. Find your error below, apply the fix and you are usually back in game within two minutes.
| Error you see | Likely cause | Fix |
|---|---|---|
| Incompatible mods found | Dependent mod needs a newer MaLiLib build | Install the latest MaLiLib for your exact Minecraft version |
| Duplicate mod: malilib | Two MaLiLib jars in the mods folder | Delete the older jar and keep one |
| Game closes with no error | Fabric jar in a Forge or NeoForge instance | Use a Fabric profile or a proper community port |
| Config menu does not open | Hotkey cleared or in conflict | Open via Mod Menu and rebind A + C |
| Crash after changing a setting | Corrupted config file | Rename config/malilib.json and relaunch |
| Mod not listed in Mod Menu | Wrong Minecraft version file | Download the jar built for your version |
Performance tips
Limit active MiniHUD overlays, render fewer Litematica layers, allocate 4 GB of RAM and pair your setup with a compatible performance mod.
Read the log
Open logs/latest.log, search for "malilib" and read lines marked ERROR. Our crash guide explains each message.
Ready to install MaLiLib Mod?
Grab the official file for your Minecraft version and follow the five-minute guide.