Fabric and Quilt are lightweight, modular mod-loader frameworks for Minecraft: Java Edition. Fabric is the most widely adopted community loader, while Quilt is a community fork that adds additional tooling and a broader API surface. PojavLauncher handles both through a shared internal code path —Documentation Index
Fetch the complete documentation index at: https://mintlify.com/pojavlauncherteam/pojavlauncher/llms.txt
Use this file to discover all available pages before exploring further.
FabriclikeUtils and FabriclikeDownloadTask — so the installation experience is nearly identical for both loaders. Once installed, each loader receives its own launch profile that PojavLauncher creates and manages automatically.
Fabric and Quilt mods are not compatible with Forge. Do not mix mod JARs from different loader ecosystems in the same profile.
Installing the Mod Loader
- Fabric
- Quilt
Open the mod-loader installer
From the PojavLauncher main menu, tap the Install mod loader button (the puzzle-piece icon beneath the version selector).
Choose a Minecraft version
PojavLauncher fetches the supported game-version list from
https://meta.fabricmc.net/v2/versions/game and presents it in a drop-down. Select the Minecraft version you want to mod.Choose a Fabric Loader version
After selecting the game version, the launcher queries
https://meta.fabricmc.net/v2/versions/loader/<gameVersion> and displays available loader builds. Stable releases are shown first; beta builds are labelled accordingly. Select the loader version you want — the latest stable build is recommended.Confirm and wait
Tap Install. PojavLauncher downloads the Fabric profile JSON from
https://meta.fabricmc.net/v2/versions/loader/<gameVersion>/<loaderVersion>/profile/json, writes it to your versions directory, and creates a new launch profile named Fabric automatically. You will see a progress indicator while the download runs.Understanding Version Objects
Internally, PojavLauncher represents each loader entry as aFabricVersion object. Understanding these fields can help you read log output or manually inspect cached version data.
| Field | Type | Description |
|---|---|---|
version | String | The human-readable version string (e.g. 0.15.11) |
stable | boolean | true for release builds; false for beta/snapshot builds |
LoaderDescriptor subclass additionally wraps a nested FabricVersion loader object that carries the metadata for a specific loader build paired with a given game version.
Installing Mods
After the loader profile is created you can start adding mods.Locate the mods folder
Mods live inside your game home directory:The default
<game_home> on Android is /storage/emulated/0/games/PojavLauncher. You can confirm or change it in Settings → Game directory.Copy mod JARs
Copy each mod’s
.jar file into the mods/ directory using your preferred file manager (e.g. Files by Google, MiXplorer, or a USB connection to a PC).Fabric API is not bundled with the loader. Most Fabric mods depend on it. Download
fabric-api-<version>.jar from Modrinth or CurseForge and place it in your mods/ folder alongside your other mods.Java Version Requirements
The Java runtime required depends on the version of Minecraft you are running:| Minecraft version | Required JRE |
|---|---|
| 1.16.5 and earlier | Java 8 |
| 1.17 – 1.20.4 | Java 17 |
| 1.20.5 and later | Java 21 |
Troubleshooting
The installer says 'Data not available' or fails silently
The installer says 'Data not available' or fails silently
PojavLauncher caches version metadata locally. If the cache is stale or the meta server is unreachable, the version list may fail to load. Check your internet connection, then clear the launcher cache in Settings → Clear cache and try again.
Game crashes immediately on launch with Fabric
Game crashes immediately on launch with Fabric
The most common causes are:
- A mod is incompatible with the selected Minecraft version.
- Fabric API is missing from the
mods/folder. - The wrong Java version is active for the selected Minecraft version.
<game_home>/.minecraft/crash-reports/ for details.Quilt mods crash or are not detected
Quilt mods crash or are not detected
Quilt is backwards-compatible with most Fabric mods, but some mods that use advanced Fabric internals may require the Quilt Standard Libraries (QSL) instead of Fabric API. Download QSL and add it to your
mods/ folder.Can I use Fabric and Forge mods together?
Can I use Fabric and Forge mods together?
No. Fabric/Quilt and Forge are entirely separate mod ecosystems with incompatible class-loading mechanisms. You must maintain separate profiles for each loader.