WorldWeaver Wiki

WorldWeaver (mod id wover) is a world-generation library. It contains no blocks, items, mobs or gameplay of its own - instead it provides the programming interfaces that other mods use to add their own biomes and terrain features to the world in a controlled, compatible way.

WorldWeaver is the foundation of the BetterX family of mods: the team's core library BCLib builds on it, and content mods such as BetterNether rely on both. It also bundles WunderLib, the team's UI and layout toolkit, so mods that need it do not have to install it separately.

The original library is by Frank Bauer (quiqueck / Ambertation), released under the MIT license; this build's source remains available under the same terms.

WorldWeaver is organized into small modules that together cover the whole world-generation workflow:

• Biome APIs - registering biomes, attaching climate parameters and injecting them into the nether, end or overworld biome sources.
• Feature APIs - registering configured and placed worldgen features (plants, ores, surface decorations) with helper builders.
• Structure APIs - registering structures, structure sets and processors.
• Surface-rule APIs - attaching custom surface rules to biomes so they can shape their own terrain surface.
• Tag APIs - creating and populating block, item and biome tags from code.
• World preset and level-stem helpers - managing dimension setup and world presets.
• Datagen utilities - generating models, tags and other assets at build time.
• WunderLib - the bundled UI/layout toolkit used by the team's screens.

If you are not a mod developer, none of this is visible in game - the library simply has to be present so dependent mods can run.

Install WorldWeaver only when another mod lists it as a required dependency. In this build's family:

• BCLib - the BetterX core library - runs on top of WorldWeaver.
• BetterNether - the nether-overhaul mod - requires both WorldWeaver and BCLib.

The download pages of dependent mods link back to this library from their Requires box.

WorldWeaver keeps small JSON config files in the config/wover/ folder. The client file (client.json) contains options such as:

• did_present_welcome_screen - whether the one-time welcome screen has been shown.
• check_for_new_versions - toggle for the version check.
• disable_experimental_warning - suppresses the experimental-settings warning when creating worlds.

Editing the files while the game is closed is the safest way to change them.

Does WorldWeaver add anything to the game by itself? No - it is a pure library. Without a dependent mod installed you will not notice it in game.

When do I need to install it? Only when a mod you want to use lists it as required - for example BCLib or BetterNether.

Does it add any chat commands? No.

Is WunderLib included? Yes - WorldWeaver bundles and provides WunderLib, so you do not need to install WunderLib separately.