HomeDownloadFeaturesInstallationGuideFAQBlog
NewVersion 0.29.0 builds available for Fabric

MaLiLib Mod for Minecraft

MaLiLib Mod is the shared library behind Litematica, MiniHUD, Tweakeroo and Item Scroller. It gives these Fabric mods one config menu, powerful multi-key hotkeys and reliable GUI tools. Get the MaLiLib Mod download for your exact Minecraft version and set it up in minutes.

4.7 / 5 10M+ downloads v0.29.0
Virus-freeOpen sourceLGPL-3.0Official links only
MaLiLib Mod configuration menu with toggles, values and hotkey settings
By masa & maintainers
Default hotkeyA+C
10M+Downloads
4.7Average rating
6Top mods powered
5Platforms supported
100+Version updates
About the library

What Is MaLiLib Mod?

A short, honest overview of what the library is, where it came from and whether you need it.

What it is

MaLiLib Mod is a client-side library for Minecraft Java Edition. The name stands for masa's Library. It supplies the configuration screens, hotkey handling, GUI widgets and rendering helpers that other mods use, so those mods can focus on their own features. On its own it adds nothing to gameplay; it becomes useful the moment you install a mod that depends on it.

History and purpose

masa created MaLiLib around 2018 to share code between his LiteLoader mods for Minecraft 1.12.2, including Litematica, MiniHUD, Tweakeroo and Item Scroller. As the modding scene moved to Fabric, the library moved with it. Newer Minecraft versions are kept up to date with help from community maintainers, and development happens openly on GitHub.

Who should use it

You need MaLiLib if you play with any masa mod or community mod that lists it as a dependency. Builders, technical players, speedrunners, server admins and mod developers all end up installing it. If none of your mods ask for it, you can skip it.

Why it was created

Before MaLiLib, each mod carried its own copy of config and input code, which meant duplicated bugs and menus that behaved differently. One shared library fixed both problems and made updates faster across the whole family of mods.

Expert opinion

"MaLiLib is one of the quiet workhorses of Java modding. Players rarely think about it, yet it sets the standard for how client mods handle settings and keybinds. The only real friction is version matching, and that takes a minute once you know how to read the file name."

Daniel Reyes, Technical Editor

  • Developer: masa (maruohon) and community maintainers
  • Loader: Fabric (official), community ports for Forge and NeoForge
  • License: LGPL-3.0, free and open source
  • Side: Client only, no server install needed
Features

Key Features of MaLiLib

Nine reasons the biggest client mods in Minecraft are built on this library, and what each one means for your game.

MaLiLib unified config screen preview

Unified config screens

Every mod built on MaLiLib gets the same clean, searchable settings screen, so once you learn one menu you know them all. No more hunting through text files to change a value.

Multi-key hotkeys

Bind actions to combos like A + C instead of single keys and keep your keyboard free.

Automatic saving

Changes save to tidy JSON files you can back up or share.

Shared GUI widgets

Buttons, lists and text fields that look consistent across mods.

Lightweight footprint

A small jar that loads fast and stays out of your frame rate.

Powers top client mods

Litematica, MiniHUD, Tweakeroo and Item Scroller all run on it, which means one install unlocks a whole family of tools.

Color and overlay tools

Pick colors with alpha and render clean in-world overlays.

Fast version updates

Builds follow new Minecraft releases closely.

Open source under LGPL-3.0

The full source is public on GitHub. Anyone can audit it, report issues or build their own mod on top of it, which is a big reason players and developers trust it.

Workflow

How MaLiLib Mod Works

From game launch to a hotkey press, this is what the library does behind the scenes in five steps.

  1. Fabric loads MaLiLib

    At startup Fabric Loader reads the jar and registers MaLiLib before dependent mods.

  2. Mods register configs

    Litematica, MiniHUD and others hand their options and hotkeys to MaLiLib.

  3. Configs are read

    MaLiLib loads saved values from JSON files in the config folder.

  4. Input is watched

    Each key press is checked against every registered combination.

  5. Actions and screens run

    Matching hotkeys fire, and menus render using shared widgets.

Requirements

System Requirements

MaLiLib itself is tiny. These figures cover Minecraft with Fabric and a few MaLiLib-based mods running together.

Minimum setup

OS
Windows 10, macOS 11 or a 64-bit Linux distro
CPU
Dual-core 2.5 GHz
RAM
4 GB system memory, 2 GB allocated to Minecraft
GPU
OpenGL 4.4 compatible integrated graphics
Storage
About 2 MB for MaLiLib, 1 GB+ for the game
Internet
Only to download files and sign in

Recommended setup

OS
Windows 11, macOS 13+ or a current Linux distro
CPU
Quad-core 3.5 GHz or better
RAM
8 GB+, 4 GB allocated to Minecraft
GPU
Dedicated GPU such as GTX 1060 or RX 580
Storage
SSD with 4 GB free for mods and schematics
Java
Java 21, bundled with the official launcher
Download

MaLiLib Mod Download

Every button below opens an official source. We never re-host or repackage the file, so what you get is exactly what the developers published.

Latest version0.29.0
Release dateRolling, per MC update
File sizeAbout 1 to 2 MB
Developermasa and maintainers
LicenseLGPL-3.0 (free)
Operating systemsWindows, macOS, Linux
LoaderFabric (official)
Virus scanClean on official hosts
Updated for the newest Minecraft releases. Dependent mods often need the latest build, so grab it before you update Litematica or MiniHUD.

Verify your file (SHA-256)

Each release page lists a SHA-256 hash. Run the matching command and compare the output character by character.

# Windows (Command Prompt)
certutil -hashfile malilib-fabric-0.29.0.jar SHA256

# macOS / Linux
shasum -a 256 malilib-fabric-0.29.0.jar

Get MaLiLib Mod

Choose your Minecraft version and the Fabric loader on the file list, then download the jar.

Download from Modrinth Download from CurseForge

Mirror downloads

GitHub source & releases Fabric Loader installer
Scanned by hostHTTPSOfficial files
Installation

Installation Guide

Pick your platform for step-by-step instructions. Desktop takes about five minutes; mobile launchers take a little longer.

  1. Download and run the official Fabric installer, choose the Client tab and select your Minecraft version.
  2. Click Install, then open the Minecraft Launcher once with the new Fabric profile.
  3. Download the MaLiLib jar that matches your game version from Modrinth or CurseForge.
  4. Press Win + R, type %appdata%\.minecraft and open the mods folder (create it if needed).
  5. Move the MaLiLib jar and its dependent mods into the folder, then press Play on the Fabric profile.
Video thumbnail for installing MaLiLib Mod on Fabric
Bedrock Edition cannot load Java mods. Every method here uses Minecraft Java Edition, including the mobile launchers.
Usage guide

How to Use MaLiLib Mod

From your first launch to power-user settings, here is how to get real value from the library and the mods on top of it.

Beginner guide

  1. Install MaLiLib together with a mod that needs it, such as MiniHUD.
  2. Join a world and press A + C to open the config menu.
  3. Browse the Generic tab and hover names to read tooltips.
  4. Open your dependent mod's menu, for example H + C for MiniHUD.
  5. Close the screen; changes save automatically.

Advanced guide

  1. Open a hotkey's settings button to change activation and ordering.
  2. Use exclusive combos for actions you trigger mid-build.
  3. Copy config/*.json files to clone a setup across instances.
  4. Keep a separate launcher instance per Minecraft version.
  5. Pin versions in modpacks to avoid surprise updates.

Best practices

  • Update MaLiLib together with its dependent mods.
  • Keep exactly one MaLiLib jar per mods folder.
  • Back up the config folder before big updates.
  • Download only from official pages.

Tips and tricks

  • Install Mod Menu for one-click access to every config screen.
  • Use the search box at the top of long config lists.
  • Right-click reset buttons are safer than editing JSON by hand.
  • Bind rarely used toggles to three-key combos.

Keyboard shortcuts

ActionDefault keysMod
Open MaLiLib config menuA + CMaLiLib
Open Litematica main menuMLitematica
Open Litematica configM + CLitematica
Toggle MiniHUD info linesHMiniHUD
Open MiniHUD configH + CMiniHUD
Open Tweakeroo configX + CTweakeroo
Clear a keybind while editingEscAll MaLiLib menus

Defaults can change between releases. Confirm them in each mod's Hotkeys tab.

Compatibility

Compatibility Overview

Where MaLiLib Mod runs, which launchers and loaders it supports, and the tools it plugs into.

CategorySupportedStatus
Operating systemsWindows 10/11, macOS 11+, Linux (x64 and ARM64)Full
BrowsersChrome, Edge, Firefox, Safari (for downloading only)Full
DevicesDesktops and laptops; Android and iOS via Java launchersPartial
Mod loadersFabric official; Forge and NeoForge through community portsPartial
FrameworkJava 21 for modern versions, Fabric Loader latest stableFull
IntegrationsMod Menu, Litematica, MiniHUD, Tweakeroo, Item Scroller, SyncmaticaFull
LaunchersOfficial launcher, Prism, MultiMC, Modrinth App, CurseForge AppFull
Minecraft editionsJava Edition only; Bedrock is not supportedNone
Verdict

Pros and Cons

An honest look at where MaLiLib shines and where it can trip you up.

What we like
  • Free and open source under LGPL-3.0
  • Consistent menus across every dependent mod
  • Multi-key hotkeys with fine-grained control
  • Tiny file size with no gameplay overhead
  • Quick updates for new Minecraft versions
  • Settings stored in easy-to-back-up JSON
What to watch
  • Does nothing visible on its own
  • Version numbers confuse new players
  • Official builds are Fabric only
  • Documentation is thin for developers
  • Not usable with Bedrock Edition
  • Mobile setups are experimental
Use cases

Who Uses MaLiLib Mod

Different players, different goals, one shared library underneath all of them.

Students

Read a well-structured Fabric codebase and learn how real mod libraries manage configs and input.

Gamers

Unlock Litematica, MiniHUD and Tweakeroo for faster building and clearer information on screen.

Developers

Skip writing config and hotkey code; build your mod on a tested, familiar framework.

Business users

Education servers and build studios standardise client setups for staff and clients.

Researchers

Technical players measure mob spawning, chunk loading and redstone timing with MiniHUD overlays.

Content creators

Toggle clean overlays and schematic guides mid-recording with a single key combination.

Gallery

Screenshots Gallery

A visual tour of the menus, settings and setup steps you will see while using MaLiLib Mod.

Troubleshooting

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 seeLikely causeFix
Incompatible mods foundDependent mod needs a newer MaLiLib buildInstall the latest MaLiLib for your exact Minecraft version
Duplicate mod: malilibTwo MaLiLib jars in the mods folderDelete the older jar and keep one
Game closes with no errorFabric jar in a Forge or NeoForge instanceUse a Fabric profile or a proper community port
Config menu does not openHotkey cleared or in conflictOpen via Mod Menu and rebind A + C
Crash after changing a settingCorrupted config fileRename config/malilib.json and relaunch
Mod not listed in Mod MenuWrong Minecraft version fileDownload the jar built for your version

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.

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.

Security

Security and Privacy

What MaLiLib can and cannot do on your computer, and how this site handles your data.

MaLiLib unified config screen preview

Is it safe?

Yes. The official jar is open source, widely used for years and distributed through platforms that scan every upload.

Permissions required

None beyond Minecraft itself. It reads and writes only its own config files in your game folder.

Data collection

No telemetry or analytics. Settings stay on your computer in plain JSON you can inspect.

Security features

Signed releases on trusted hosts, public source code and SHA-256 hashes you can check yourself.

Privacy summary: this website does not host mod files, uses only essential cookies by default and never sells personal data. Read the full privacy policy and cookie policy.
Comparison

Alternatives Compared

For players, MaLiLib cannot be swapped out because mods require it by name. For developers choosing a config library, here is how the main options compare.

SoftwarePriceLicenseOS supportFeaturesRatingProsCons
MaLiLibFreeLGPL-3.0Win, macOS, LinuxConfigs, multi-key hotkeys, GUI widgets, overlays★ 4.7Required by masa mods; powerful hotkeysFabric only officially
Cloth Config APIFreeLGPL-3.0Win, macOS, LinuxConfig screens, Fabric and Forge builds★ 4.5Multi-loader, widely usedNo advanced hotkey system
YetAnotherConfigLibFreeLGPL-3.0Win, macOS, LinuxModern config UI, image previews★ 4.5Polished look, active updatesConfig focused only
owo-libFreeMITWin, macOS, LinuxUI framework, configs, networking helpers★ 4.4Very flexible UI toolkitSteeper learning curve
Fabric APIFreeApache-2.0Win, macOS, LinuxCore hooks, events and key binding API★ 4.8Foundation for most Fabric modsNo ready-made config screens

Ratings are our editorial scores based on features, documentation and update speed.

Reviews

What Players Say

Feedback from builders, technical players, developers and creators who use MaLiLib-based mods every day.

MT

Maya Thompson

Survival builder
Verified
★★★★★

Litematica finally works

I only installed MaLiLib because Litematica asked for it, but the setup took two minutes. Matching the version to 1.21.11 was the only thing I had to pay attention to.

LF

Lucas Ferreira

Technical player
Verified
★★★★★

Hotkeys are brilliant

Being able to bind MiniHUD overlays to two-key combos changed how I play. I have over thirty shortcuts and not a single conflict with vanilla controls.

PN

Priya Nair

Mod developer
Verified
★★★★★

Great base for a mod

The config framework saved me weeks. Options, lists and hotkeys all save cleanly, and players already understand the menu layout.

OC

Owen Clarke

Server admin
Verified
★★★★☆

Solid, just match versions

Rock stable on our creative server clients. One star off only because new players keep grabbing the wrong build. The version guide here helped a lot.

SM

Sofia Marino

Content creator
Verified
★★★★★

Clean for recording

I record build tutorials and MiniHUD info lines powered by MaLiLib look tidy on screen. Toggling them with one combo mid-recording is perfect.

EB

Ethan Brooks

Computer science student
Verified
★★★★☆

Nice code to learn from

I read the source to learn how a Fabric library is structured. Clear packages and a sensible API. Documentation could be longer, but the code is readable.

FAQ

Frequently Asked Questions

Straight answers to the questions players ask most about downloading, installing and troubleshooting MaLiLib Mod.

Download & setup

Getting the right file installed

Download MaLiLib Mod only from its official pages on Modrinth, CurseForge or the GitHub repository maintained by the developer. Our download section links directly to those sources, so you always get the untouched original file. Avoid re-upload sites that wrap the jar in installers or ask you to disable antivirus software, because those are the usual source of fake or unsafe copies.

Match the Minecraft version in the file name to your game first, then pick the newest MaLiLib build for that version. If you use Litematica, MiniHUD or Tweakeroo, check their changelogs for a minimum MaLiLib build. Using an older build than required triggers a dependency error when the game starts, which is easy to fix by swapping the jar.

Yes. Current official MaLiLib releases are built for Fabric Loader. Install Fabric with the official installer, launch the game once to create the folders, then place the MaLiLib jar in your mods folder. Mod Menu is optional but useful because it adds a button that opens MaLiLib and dependent mod settings directly from the title screen.

Official releases target Fabric. Forge and NeoForge players rely on community ports published under different project names, or on compatibility layers such as Sinytra Connector for NeoForge. These work for many setups but can lag behind updates. If you choose a port, download it from its own official page and follow its dependency list.

Place the jar in the mods folder inside your game directory. On Windows that is usually %appdata%\.minecraft\mods, on macOS ~/Library/Application Support/minecraft/mods, and on Linux ~/.minecraft/mods. Custom launchers such as Prism or MultiMC keep a separate mods folder for each instance, reachable from the instance settings menu.

Close Minecraft, delete the old MaLiLib jar from your mods folder and add the new one for the same game version. Your settings stay in the config folder and carry over automatically. Always update MaLiLib at the same time as its dependent mods, since new builds of Litematica or MiniHUD often require a newer library build.

Only through launchers that run Java Edition on mobile, such as PojavLauncher-based apps on Android or Amethyst on iOS. Bedrock Edition cannot load Java mods at all. Performance depends heavily on the device, and iOS typically needs JIT enabled. Treat mobile setups as experimental and test with a small mod list first.

Yes, MaLiLib Mod is completely free. It is released under the LGPL-3.0 open-source license, so there is no paid tier, trial or license key. If a website asks you to pay for MaLiLib or complete surveys before downloading, leave it, because the genuine files are always available at no cost from the official platforms.

Safety, licensing & fixes

Security, updates and troubleshooting

The genuine MaLiLib Mod is safe. Its source code is public, it has been used by millions of players and it is distributed through platforms that scan uploads. It only reads and writes its own config files. To stay safe, download from official sources and compare the SHA-256 hash of your file with the one listed on the release page.

MaLiLib is licensed under the GNU Lesser General Public License version 3. You can use it freely, and developers can build mods that depend on it, including closed-source mods. If you modify the library itself and distribute those changes, the modified library must remain under the same license with its source available.

No. MaLiLib has no telemetry and no analytics. It stores your settings locally in JSON files inside the config folder and has no reason to contact outside servers during normal play. Any mod that uses MaLiLib has its own behaviour, so check each mod page if privacy is a concern for your setup.

Most crashes come from version mismatches: a MaLiLib jar built for a different Minecraft release, a build older than a dependent mod needs, or two MaLiLib jars in the same folder. Open logs/latest.log, search for malilib and read the lines marked ERROR. They usually name the exact version you need to install.

Press A and C together while in a world, because that is the default MaLiLib hotkey. If nothing happens, another mod may use the same combo, or the hotkey was cleared. Install Mod Menu to open the screen from the title menu instead, then rebind the hotkey in the Hotkeys tab to a free combination.

MaLiLib itself is lightweight and has no noticeable effect on frame rate. Performance changes usually come from what dependent mods render, such as large Litematica schematics or many MiniHUD overlays at once. Reduce overlay count, render fewer schematic layers and pair your setup with a performance mod like Sodium if your mod list supports it.

Alternatives depend on your goal. Developers building config screens often compare Cloth Config API, YetAnotherConfigLib and owo-lib. Players cannot swap MaLiLib out, because mods like Litematica and MiniHUD require it specifically. Our alternatives page compares these libraries by license, features and ideal use case.

Close the game and delete the MaLiLib jar from your mods folder. Remember to remove the mods that depend on it too, or the game will refuse to start and show a missing dependency message. You can also delete config/malilib.json if you want to remove saved settings, but keeping it is harmless.

Blog

Latest Guides and News

Hands-on tutorials, version explainers and fixes written after testing every step in a real game instance.

Browse all articles
Contact

Contact Our Team

Questions about a guide, a broken link or a partnership? Send a message and we usually reply within two business days.

Your email app has opened with the message ready to send.

  • Office2150 Innovation Way, Suite 410, Austin, TX 78701, United States
  • Support email[email protected]
  • Response timeWithin 2 business days

Ready to install MaLiLib Mod?

Grab the official file for your Minecraft version and follow the five-minute guide.