BCLib Mod (1.21.1, 1.20.4) – Library for BetterX Team's Mods

BCLib is a library mod that provides shared code, APIs, and cross-mod compatibility for BetterEnd, BetterNether, and other BetterX team mods on Minecraft Fabric. It serves as the foundational framework that powers biome generation, block templates, and world-type management across multiple popular dimension-overhaul mods.

Minecraft's Nether and End dimensions have always felt underdeveloped compared to the Overworld, and mods like BetterNether and BetterEnd exist to fix that. The problem? Running multiple dimension mods together often causes biome conflicts, crashes, and incompatibilities. BCLib solves this by acting as a shared backbone that coordinates biome registration, surface rules, and world generation across all BetterX mods — and any other mod that hooks into its API. With over 9 million downloads on Modrinth, BCLib has become one of the most widely depended-upon library mods in the Fabric ecosystem, quietly running behind the scenes of countless modded worlds.

Key Features of BCLib

• Cross-Mod Biome Compatibility — BCLib creates a unified system that allows biomes from different mods and datapacks to coexist in the same Nether or End dimension. Without this, installing two End-overhaul mods would likely result in one overwriting the other's biomes. BCLib's own "BetterX" world type handles this coordination seamlessly.
• Block Templates for Common Types — Instead of every mod reinventing the wheel for plants, wood types, signs, and seedlings, BCLib provides reusable block templates. This means mod developers can add new wood types or plant variants with minimal code, and players benefit from consistent behavior across all BetterX mods.
• Biome, Feature, and Structure API — BCLib offers a straightforward API for creating custom biomes, world features, and structures. For developers, this dramatically reduces the boilerplate code needed to add new content to dimension mods, which translates to faster updates and fewer bugs for players.
• SurfaceRule and MaterialRule Registry — Vanilla Minecraft makes it difficult for multiple mods to define surface rules for the same dimension without overwriting each other. BCLib's registry system lets mods and datapacks add their own surface and material rules without editing or copying vanilla definitions, preventing the conflicts that plague other mod setups.
• Config Synchronization System — BCLib includes a built-in config system that automatically synchronizes settings between client and server. This is particularly valuable for multiplayer servers, where mismatched configs between the server and connecting players can cause visual glitches or crashes.
• Custom World Type Support — The API allows creation of entirely new world types beyond vanilla's options. The BetterX world type itself is built on this system, giving players access to enhanced world generation that integrates all installed BetterX content automatically.
• Recipe and Tag Management — BCLib provides centralized recipe and tag management utilities, ensuring that items and blocks from different BetterX mods interact correctly with crafting systems, furnaces, and item categorization without manual conflict resolution.

How to Install BCLib

1. Download and install Fabric Loader for your Minecraft version (1.21.1, 1.20.4, or whichever version you need).
2. Make sure you also have Fabric API installed, as most Fabric mods depend on it.
3. Download BCLib for your specific Minecraft version from the download section below.
4. Place the BCLib .jar file into your .minecraft/mods folder.
5. Install the BetterX mods you want to use — such as BetterEnd or BetterNether — into the same mods folder, then launch the game.

Requirements & Compatibility

What's New

• Added datagen support for furnace models, streamlining asset generation for developers.
• Fixed an issue where EMI (a recipe viewer mod) was not being initialized properly.
• Continued maintenance updates to support Minecraft 1.21.1 and the latest Fabric Loader versions.

Pros and Cons

Alternatives to BCLib

• Fabric API — The core library mod for most Fabric mods, providing essential hooks and APIs. While not a direct replacement, it serves a similar foundational role in the Fabric ecosystem.
• Architectury API — A cross-platform library that lets developers write mods compatible with both Fabric and Forge, useful for projects that need broader loader support than BCLib provides.
• Cloth Config API — A popular configuration screen library for Fabric mods. If you primarily need config management rather than BCLib's full biome and world-gen toolkit, Cloth Config is a lighter alternative.

Download BCLib

Always download mods from official sources to stay safe.

Frequently Asked Questions

Do I need BCLib to play Minecraft?

No — BCLib is not needed for vanilla Minecraft. It is only required if you install mods that depend on it, such as BetterEnd, BetterNether, or Eden Ring. Without those mods, BCLib serves no purpose in your game.

Does BCLib work with Forge or NeoForge?

No — BCLib is exclusively a Fabric mod and has no Forge or NeoForge version. The BetterX team develops specifically for the Fabric ecosystem, so you will need Fabric Loader installed to use BCLib and its dependent mods.

Will BCLib affect my game performance?

BCLib appears to be lightweight as a library mod that primarily provides shared code rather than adding new content or rendering. It loads APIs and utilities that other mods call upon, so its performance footprint is generally minimal compared to the content mods that depend on it.

Can I use BCLib with other dimension mods like Aether?

Yes — BCLib is designed to improve compatibility between dimension mods, not restrict it. Its biome registry system specifically allows biomes from different mods and datapacks to coexist. However, compatibility with non-BetterX mods depends on whether those mods also use BCLib's APIs.

Is BCLib safe to add to an existing world?

Yes — BCLib includes world patchers that help manage data when updating or adding the mod to existing saves. However, new biomes from dependent mods like BetterEnd will only generate in unexplored chunks, so you may need to travel to new areas to see the full effect of the BetterX world type.

You May Also Like

Veinminer Enchantment Mod (1.21.11) – Efficient Resource Gathering

2 weeks ago

Calc Mod (1.21.11, 1.20.1) – A Calculator in Your Minecraft Chat

1 week ago

YUNG's Nether Fortresses (1.21.4, 1.20.4) – Fortress Generation

4 weeks ago

Rhino Mod (1.21.4, 1.20.5) – Library for LatvianModder's Mods

1 week ago

Load My Resources Mod (1.21.11, 1.20.1) – Automatic Resource Loading

1 week ago

Better PvP Mod (1.21.11, 1.20.1) – How to Be Good at PVP

1 week ago