Skip to content

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.

Installation#

  1. Install BentoBox and run it on the server at least once to create its data folders.
  2. Place this jar in the addons folder of the BentoBox plugin.
  3. Restart the server.
  4. The addon will create worlds and a data folder and inside the folder will be a config.yml.
  5. Stop the server .
  6. Edit the config.yml how you want.
  7. Delete any worlds that were created by default if you made changes that would affect them.
  8. 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

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

This allows to specify how many tries will it take to change a main dimension block with an ore block.

Description

Improve material generator generates vanillish ore bolbs, granite, diorite and tuff patches, as well as uses some deepslate.

However, it will disable any customization you are adding via dimension block configs.

Description

Allows toggling if overworld top block should be bedrock block. Otherwise, it will be made of stone.

Description

Option allows toggling if world generator should generate natural(-ish) looking surface with dirt and grass blocks. Currently, natural(-ish) is just dirt and grass block layers.

This option disables world.normal.roof option.

Description

Option allows toggling if world generator should generate natural caves like in vanilla world. Caves will be generated with all blocks and biomes.

Description

Allows toggling if overworld bottom block should be bedrock block. Otherwise, it will be made of stone.

Description

Allows toggling if overworld bedrock should be generated like in vanilla world with 4 block height.

Description

Allows setting main block that will be used for overworld generation. Setting it to AIR will create void world.

Description

Blocks that will occasionally replace main block by random chance. Blocks will replace only main-block and will try to create packs that are set in their strings. Chance of spawning also is required.

For materials first string must be MATERIAL, for entity: ENTITY.

Entities spawned via generator are not protected from despawing. Working only with 2 high mobs currently.

Example

    blocks:
        - MATERIAL:DIAMOND_ORE:100:5 
Means there is 100% chace of spawing diamonds where max amount in pack are 5 per each subchunk!

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.

Description

Blocks that will occasionally replace main block by random chance. Blocks will replace only main-block and will try to create packs that are set in their strings. Chance of spawning also is required.

For materials first string must be MATERIAL, for entity: ENTITY.

Entities spawned via generator are not protected from despawing. Working only with 2 high mobs currently.

Example

    blocks:
        - MATERIAL:DIAMOND_ORE:100:5 
Means there is 100% chace of spawing diamonds where max amount in pack are 5 per each subchunk!

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.

Description

Blocks that will occasionally replace main block by random chance. Blocks will replace only main-block and will try to create packs that are set in their strings. Chance of spawning also is required.

For materials first string must be MATERIAL, for entity: ENTITY.

Entities spawned via generator are not protected from despawing. Working only with 2 high mobs currently.

Example

    blocks:
        - MATERIAL:DIAMOND_ORE:100:5 
Means there is 100% chace of spawing diamonds where max amount in pack are 5 per each subchunk!

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:

  • feather 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.

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%

Last update: April 13, 2026 23:55:22