Fabric API Guide for Minecraft (2026)
Fabric API is a required library for almost every Fabric mod. It provides common hooks and utilities that mod developers use. Without it, most Fabric mods will not load.
What Fabric API Does
Fabric Loader is the mod loader. It loads mods into Minecraft. But it does not provide APIs for mods to interact with the game.
Fabric API fills that gap with:
- Block and item registration
- Networking between client and server
- Event callbacks (block break, entity spawn, etc.)
- Resource loading
- Rendering hooks
- Biome modifications
- Command registration
Installation
Client
- Install Fabric Loader via the Fabric installer
- Download Fabric API from Modrinth or CurseForge
- Place the jar in
.minecraft/mods/ - Launch Minecraft with the Fabric profile
Server
- Install Fabric Loader on the server
- Download the same Fabric API version
- Place in the server
mods/folder - Start the server
Version Matching
Fabric API versions match Minecraft versions. Always download the correct version:
- Fabric API for 1.21.x with Minecraft 1.21.x
- Fabric API for 1.20.x with Minecraft 1.20.x
Mismatched versions cause crashes.
Fabric API vs Quilted Fabric API
If you use Quilt instead of Fabric, download Quilted Fabric API (QFAPI) instead. It includes Fabric API compatibility plus Quilt Standard Libraries.
Common Issues
Mod Requires Fabric API
Mod 'example-mod' requires fabric-api which is missing!
Install Fabric API. This is the most common Fabric error.
Wrong Fabric API Version
Incompatible mod set: fabric-api requires minecraft >=1.21
Download the Fabric API version that matches your Minecraft version.
Fabric API vs Fabric Loader
- Fabric Loader = the mod loading system (install once)
- Fabric API = the API library mod (goes in mods folder)
Both are needed. They are separate downloads.
Run Fabric mods on your server. View Minecraft Hosting Plans
