CaveBlock#
No sky. No surface. Just stone in every direction and a pickaxe in your hand.
CaveBlock flips the island game on its head: instead of building up into the open air, players carve out their world from solid underground. Dig for ores, hollow out a home, expand through the dark. It's the same satisfying island progression — challenges, levels, teammates — but the whole thing plays out underground. Dwarves Players everywhere love it.
Created and maintained by BONNe.
Useful links
Installation#
- Install BentoBox and run it on the server at least once to create its data folders.
- Place this jar in the addons folder of the BentoBox plugin.
- Restart the server.
- The addon will create worlds and a data folder and inside the folder will be a config.yml.
- Stop the server .
- Edit the config.yml how you want.
- Delete any worlds that were created by default if you made changes that would affect them.
- Restart the server.
Configuration#
The main config.yml file contains basic information about game-mode addon setup.
config.yml#
After addon is successfully installed, it will create config.yml file. Every option in this file comes with comments about them. Please check file for more information.
You can find the latest config file: config.yml
World generation reworked in 1.21.0
Since 1.21.0 the overworld is carved by Minecraft's own vanilla 1.18+ noise generator, so islands run through genuine cheese, spaghetti, lush, dripstone and deep-dark caves — complete with vanilla ores, decorations, structures and underground biomes. Every column is then capped so the world stays solid rock with no open sky. Because the server now handles carving, ores and biomes, the old block-replacement generation options (generation-tries, use-new-material-generator, the per-dimension blocks lists, and the natural-* toggles) were removed. The Nether and End keep a fill-and-decorate approach with a new ore-vein populator. See the changelog at the bottom of this page before upgrading.
Description
The depth of world indicates till which height blocks will be generated in world. Setting it to -64 will create just a basic void world.
Allows to create some fresh air above your cave.
Description
Allows toggling if overworld top block should be bedrock block. Otherwise, it will be made of stone.
Description
Allows toggling if overworld bottom block should be bedrock block. Otherwise, it will be made of stone.
Description
Main block used to cap the sky gaps above the vanilla-generated terrain. Vanilla cave carving, ores, structures and underground biomes (lush caves, dripstone caves, deep dark) are produced by the server; this setting only affects the material used to fill the surface layer. Setting it to AIR will leave open sky above the caves.
Description
Allows toggling if the nether top block should be bedrock block. Otherwise, it will be made of netherrack.
Description
Allows toggling if nether bottom block should be bedrock block. Otherwise, it will be made of netherrack.
Description
Allows setting main block that will be used for the nether world generation. Setting it to AIR will create void world. Ore veins (ancient debris, nether quartz, obsidian, glowstone and more) are placed on top of this by the vein populator.
Description
Allows toggling if the end top block should be bedrock block. Otherwise, it will be made of endstone.
Description
Allows toggling if the end bottom block should be bedrock block. Otherwise, it will be made of endstone.
Description
Allows setting main block that will be used for the end world generation. Setting it to AIR will create void world. Ore veins are placed on top of this by the vein populator.
Commands#
Tip
[player_command] and [admin_command] are commands that differ depending on the gamemode you are running.
The Gamemodes' config.yml file contains options that allows you to modify these values.
As an example, on CaveBlock, the default [player_command] is cave, and the default [admin_command] is cba.
Be aware, that this addon allows changing player commands aliases in addon config.yml file.
By default, BentoBox GameMode addons comes with the default sub-command set, however, each addon may introduce even more sub commands.
Complete CaveBlock Command List
Permissions#
Tip
[gamemode] prefix in every place for CaveBlock addon must be replaced with caveblock.
By default, BentoBox GameMode addons comes with the default sub-permission set, however, each addon may introduce even more sub-permissions.
Complete CaveBlock Permission List
Placeholders#
By default, BentoBox GameMode addons comes with default placeholders set, however, each addon may introduce even more placeholders.
Complete CaveBlock Placeholder List
Flags#
Addon introduces 1 BentoBox Settings flag:
SKY_WALKER_FLAG: flag in world settings that allows enabling/disabling player walking on cave roof.
FAQ#
Can you add a feature X?
Please add it to the list here.
I have a bug, where should I report it?
Please add it to the list here.
Changelog#
What's new in v1.21.0 — Breaking: world generation reworked
Released: 2026-06-27
A major generation overhaul. CaveBlock now targets Paper 1.21.11 on Java 21 and the BentoBox 3.14 API.
- 🔺 Vanilla cave world generation. The overworld delegates to Minecraft's own 1.18+ noise generator, so islands are carved through genuine cheese, spaghetti, lush, dripstone and deep-dark caves, complete with vanilla ores, decorations, structures (mineshafts, dungeons, trial chambers, amethyst geodes, ancient cities) and underground biomes. The sky is capped with stone so the world stays solid rock from bedrock to the roof.
- 💎 Reworked Nether & End ore veins. The Nether and End keep the fill-and-decorate approach with a new vein populator that places properly sized ore blobs (ancient debris, quartz, obsidian, glowstone and more) instead of single blocks.
- ⚙️ Config cleanup. World-generation settings were reworked and dead options removed —
generation-tries,use-new-material-generator, the per-dimensionblockslists, thenatural-surface/natural-caves/natural-bedrocktoggles and the oldnetherBlocks/endBlocks/debugsettings are gone. Back up your existingconfig.ymlbefore letting the addon write the new defaults. - 🔡 MiniMessage locales. All locale files were migrated from legacy colour codes to MiniMessage, and the height-limit message key was renamed to
caveblock.general.errors.cave-limit-reached. Regenerate your locale files if you have customised them. - 🧪 A full JUnit 5 + MockBukkit test suite was added to guard generation, height limits and addon lifecycle.
🔺 World generation changed: Newly generated overworld chunks now use vanilla noise caves instead of solid-fill carving. Already-generated chunks are untouched, but new terrain at the edges of your world will look different from older areas. Test on a copy first if this matters to you.
Translations#
Help us keep translations accurate
Most BentoBox and addon translations are now generated with the help of AI, so the bulk of the work is already done — but AI is not perfect. What we really need from the community is error reports and corrections.
- Spotted a mistake or awkward phrasing? Open an issue or a PR on the relevant repository at bentobox.world (a short link to our GitHub org), or tell us on Discord.
- Want to add a brand-new language? Open a PR adding a new locale file to
src/main/resources/locales/in the relevant repo, or ask on Discord and we'll get you started.
| Language | Language code | Progress |
|---|---|---|
| English (United States) | en-US | 100% (Default) |
| Chinese, China | zh-CN | 99% |
| Czech | cs | 99% |
| German | de | 100% |
| Indonesian | id | 0% |
| Japanese | ja | 99% |
| Latvian | lv | 99% |
| Polish | pl | 99% |
| Romanian | ro | 0% |
| Russian | ru | 100% |
| Spanish | es | 99% |
| Turkish | tr | 100% |
| Vietnamese | vi | 99% |