Behind many of the best Minecraft mods from First Dark Development and HypherionSA sits a single shared backbone: CraterLib. This library mod handles the repetitive plumbing — shared code, platform abstraction, multi-loader support — so that dependent mods can focus on actual gameplay features instead of reinventing the wheel for every mod loader. With over 2.3 million downloads on Modrinth and active updates through March 2026, CraterLib has quietly become one of the more relied-upon library mods in the modding ecosystem.
Key Features
- Shared code foundation — CraterLib centralizes common code used across multiple mods from the same development team, reducing redundancy and keeping dependent mods lighter and easier to maintain.
- Platform helpers for multi-loader support — Built-in abstraction layer makes it simpler for mod developers to port their work across Forge, Fabric, NeoForge, and Quilt without rewriting loader-specific code from scratch.
- CraterLoader engine — A mod loader inside a mod. This newer addition allows mods depending on CraterLib to run independently of the host game, opening the door for future platform ports beyond Minecraft.
- Open source under MIT license — Fully transparent codebase hosted on GitHub, allowing any developer to inspect, contribute to, or learn from the library.
Screenshots
How to Install
- Download and install your preferred mod loader (Forge, Fabric, NeoForge, or Quilt) for your Minecraft version.
- If using Fabric, make sure you also have the Fabric API installed.
- Download the correct CraterLib version for your Minecraft version and loader from the link below.
- Place the downloaded
.jarfile into your.minecraft/modsfolder. - Launch Minecraft — CraterLib will load automatically when a dependent mod needs it.
Requirements
| Mod Loader | Dependencies | Minecraft Versions |
|---|---|---|
| NeoForge, Forge, Fabric, Quilt | Minecraft Forge, Fabric API, NeoForge Installer | 1.21.11, 1.21.10, 1.21.9, 1.21.8, 1.21.7, 1.21.6, 1.21.5, 1.21.4, 1.21.3, 1.21.2, 1.21.1, 1.21, 1.20.4, 1.20.2, 1.19.4, 1.18.2 |
Pros & Cons
Pros
- Supports all major mod loaders — Forge, Fabric, NeoForge, and Quilt
- Wide Minecraft version coverage from 1.18.2 through 1.21.11
- Actively maintained with frequent updates
- Open source (MIT license) — fully transparent and community-friendly
- Appears to be lightweight since it only runs shared utility code
Cons
- Does nothing on its own — requires a dependent mod to provide any functionality
- Primarily serves First Dark Development mods, so its usefulness depends on which mods you use
- Adding another library mod increases the total mod count players need to manage
Download
Always download mods from official sources to stay safe.
What's New
- CraterLoader introduced — A built-in mod loader that lets dependent mods run independently of the host game, laying groundwork for future platform ports including Hytale.
- API restructured — The internal "nojang" API has been split into its own package and renamed to "api" to prepare for cross-game compatibility.
- Log spam fixed — Removed a warning message that fired when LuckPerms permissions failed to load, which was flooding server logs.
- Adventure library updated — Upgraded to Adventure 4.26 with general API code cleanup.
- Maven publishing fixed — Resolved issues with snapshot and release publishing for developers depending on CraterLib.
FAQ
Do I need CraterLib if I don't use any First Dark Development mods?
No. CraterLib does nothing on its own and only activates when a dependent mod (a "Module") requires it. If none of your installed mods list CraterLib as a dependency, you don't need to install it.
Can I use CraterLib on both Forge and Fabric at the same time?
Not in the same instance — you need to download the version that matches your specific mod loader. However, CraterLib is available for Forge, Fabric, NeoForge, and Quilt, so you can use whichever loader you prefer.
Is CraterLib safe to add to a modpack?
Yes. It is open source under the MIT license with over 2.3 million downloads, and its source code is publicly available on GitHub for anyone to review.


