BCLib Wiki

BCLib (mod id bclib) is the core library of the BetterX team's mods. It bundles the shared systems those mods rely on, so common functionality lives in one place instead of being duplicated across mods. BCLib itself builds on the WorldWeaver world-generation library from the same team, so both must be installed together.

BCLib has no player-facing content: no blocks, items, mobs or gameplay of its own. You install it only when a mod requires it - most notably BetterNether.

The original library is by paulevsGitch and quiqueck of the BetterX team, released under the MIT license; this build's source remains available under the same terms.

• Registration helpers for blocks and items, including whole material sets - complete wood and stone block families (planks, stairs, slabs, doors, signs, chests and more) registered from one definition.
• World-data management - per-world data storage with a save-data fixer and migration system that keeps older worlds loading safely after the mods update.
• Custom anvil recipes - a recipe type for items crafted on the anvil.
• Tag helpers - registering and populating common block/item tags shared by the team's mods.
• Config system - JSON-based configs for the team's mods (see Configuration).
• Custom portal-frame support - frame blocks tagged as portal frames are accepted by nether-portal logic, which is what lets dependent mods offer portals built in any shape.

None of this is visible in game unless a dependent mod uses it.

Install BCLib only when another mod lists it as a required dependency:

• BetterNether - the BetterX nether overhaul - requires BCLib (and WorldWeaver).

BCLib itself requires WorldWeaver, which is listed in this post's Requires box.

BCLib and the mods built on it keep their settings as JSON files in the config/bclib/ folder. Dependent mods (such as BetterNether) read their own options from this folder as well. Edit the files while the game is closed, then restart for changes to apply.

Does BCLib add anything to the game by itself? No - it is a pure library with no standalone content.

Does it need other libraries? Yes - BCLib runs on top of WorldWeaver, so both must be installed.

Does it add any chat commands? No.

Where are the config files? In the config/bclib/ folder of your game directory.