Release 1.23.0

CaveBlock 1.23.0

This release builds on the reworked overworld cave generation from 1.22.0 by handing server admins direct control over what fills their cave worlds. You can now switch off individual vanilla structures, thin out the dense 1.18+ cave network, and turn off the big carver ravines and tunnels — all from config.yml.

Highlights

• ⚙️ Configurable overworld structures — Toggle individual vanilla structures (Ancient Cities, Trial Chambers, Mansions, Mineshafts, Strongholds and more) on or off in the overworld cave world. The largest, world-filling structures are disabled by default. Fixes #112.
• ⚙️ Overworld cave density control — A new overworld-cave-fill setting re-solidifies a fraction of the vanilla cave network so worlds feel less like "nothing but passageways", while keeping biomes, ores, decorations and structures intact. Fixes #111.
• ⚙️ Carver cave toggle — A new overworld-carvers setting lets you remove vanilla ravines and wide tunnels while keeping the noise caves.

What's New

⚙️ Configurable Overworld Structures

A new structures: section in config.yml lets you control which vanilla structures generate in the overworld cave world. Set any structure to false to stop it generating; structures not listed generate as normal. Use the vanilla structure key, for example ancient_city, trial_chambers, mineshaft, stronghold, mansion, monument, village_plains, and so on.

Large structures such as Ancient Cities and Trial Chambers can fill or unbalance a solid cave world, so they are disabled by default. This only affects the overworld.

structures:
  ancient_city: false
  trial_chambers: false
  mansion: false
  mineshaft: true
  stronghold: true

⚙️ Overworld Cave Density & Carvers

Vanilla generates a dense 1.18+ cave network (cheese and spaghetti caves) which, on a solid cave world, can feel like endless passageways. Two new settings let you tune this:

• overworld-cave-fill (0.0–1.0, default 0.0) — re-solidifies a fraction of the cave air after generation using a low-frequency noise field, so whole regions close up into separate chambers rather than punching random single holes. 0.0 keeps every vanilla cave (the original behaviour); 1.0 fills nearly all caves. Try 0.4–0.6 to thin them out. Underground biomes, ores, decorations and structures are preserved either way.
• overworld-carvers (default true) — generate vanilla carver caves (big ravines and long round tunnels) on top of the noise caves. Set to false to remove the ravines and wide tunnels while keeping the noise caves.

Both settings only affect newly generated chunks.

⚙️ Config note: These settings are added automatically to config.yml on first run after upgrading. Defaults preserve the existing 1.22.0 cave-generation behaviour, except that the largest structures are now off by default.

🔺 Note: overworld-carvers cannot be changed mid-game — BentoBox does not support altering it on an existing world. If you need to change it, do a full reset of your worlds and databases.

Compatibility

✔️ BentoBox API 3.14.1
✔️ Minecraft 1.21.x (Paper 1.21.11)
✔️ Java 21

Upgrading

1. Stop your server.
2. Replace the old CaveBlock.jar in your plugins/BentoBox/addons folder with this release.
3. Start the server — the new structures, overworld-cave-fill, and overworld-carvers options are written to config.yml automatically.
4. Adjust the new options to taste and reload. Note these settings only affect newly generated chunks, so already-explored areas are unchanged.

Legend

• ⚙️ Config options have been added — review the new settings in config.yml.
• 🔺 Special attention needed.

What's Changed

• ⚙️ Add configurable structure toggles for the overworld by @tastybento in #113
• ⚙️ Add overworld cave-density controls by @tastybento in #115

Full Changelog: 1.22.0...1.23.0