Skip to content
Switch branches/tags
Go to file


Failed to load latest commit information.
Latest commit message
Commit time

Biomes Addon

Discord Build Status Bugs Maintainability Rating Reliability Rating Security Rating

Biomes addon for SkyBlock, SkyGrid, CaveBlock and AcidIsland. It allows island biome changing.

Where to find

Download the latest release from the BentoBox Downloads site ( or you can try snapshot builds where you can check and test new features that will be implemented in next release from Jenkins Server.

If you like this addon but something is missing or is not working as you want, you can always submit an Issue request or get a support in Discord BentoBox icon


As most of BentoBox projects, Biomes Addon is translatable in any language. Everyone can contribute, and translate some parts of the addon in their language via GitLocalize. If your language is not in the list, please contact to developers via Discord and it will be added there.

How to use

  1. Place the addon jar in the addons folder of the BentoBox plugin
  2. Restart the server
  3. The addon will create a data folder and inside the folder will be a config.yml and an example biomes.yml
  4. Edit the config.yml and biomes.yml files how you want. The biomes.yml is for importing only.
  5. Restart the server


After the addon is successful installed, it will create a config.yml file. Every option in this file comes with comments. Please check the file for more information. Most options are also editable admin via commands.


This file contains all necessary information about default biomes. If you change values in biomes.yml, then to apply them, you must run /bsb biomes import or /acid biomes import.

If you want to force an overwrite of the biomes via an import, add the overwrite option to the end of the import command. Note that you must import biomes into both BSkyBlock and AcidIsland separately.

User commands

Users can access to biomes addon commands with /[gamemode] biomes command. By default for BSkyBlock it is /island biomes, for AcidIsland - /ai biomes, for CaveBlock - /cave biomes, for SkyGrid - /sg biomes.

  • /is biomes: This method opens GUI that allows to change biome on User island.
  • /is biomes help: Show help for all the commands
  • /is biomes info <biome>: This command returns information about given biome, like cost and necessary level.
  • /is biomes set <biome> [<type>] [<size>]: This command allows to change biome on island without opening GUI. If prarameters < type> and < size> are not provided, command uses default values from addon config.

Admin commands

There are a few admin commands and more being written. The main biomes admin command is /bsb biomes, /cba biomes, /sgadmin biomes & /acid biomes. Use

  • /bsbadmin biomes: To open Admin GUI.
  • /bsbadmin biomes help : Show help for all the commands
  • /bsbadmin biomes import [overwrite]: import biomes from biomes.yml
  • /bsbadmin biomes add <biome>: add a new biome what can be edited via GUI or biomes edit command. Biome will not be deployed. To do it, you should enable it in GUI or via biomes edit <biome> deployed true command.
  • /bsbadmin biomes set <player> <biome> [<type>] [<size>]: This command works the same as user biome set command, but it is necessary to provide also player, which island biome will be updated.
  • /bsbadmin biomes edit <biome> <property> <new_value>: This command allows to edit provided biome property to new value.
  • /bsbadmin biomes settings <property> <new_value>: This command allows to edit current addon settings via command.


{GameModePrefix} is permission prefix for each Game Mode addon. F.e. BSkyBlock addon permission prefix is 'bskyblock' but AcidIsland permission prefix is 'acidisland'.

User permissions:
  • {GameModePrefix}.biomes: player can use biomes command that opens GUI.
  • {GameModePrefix} player can use biomes info command.
  • {GameModePrefix}.biomes.set: player can use biomes set command.
Admin permissions:
  • {GameModePrefix}.admin.biomes: player can use admin biomes command that opens GUI.
  • {GameModePrefix}.admin.biomes.add: player can use admin biomes add command that adds new biome.
  • {GameModePrefix}.admin.biomes.edit: player can use admin biomes edit command that edits existing biomes parameters.
  • {GameModePrefix}.admin.biomes.set: player can use admin biomes set command that allows to change other player biomes.
  • {GameModePrefix}.admin.biomes.import: player can use admin biomes import command allows to import biomes in world.
  • {GameModePrefix}.admin.biomes.settings: player can use admin biomes settings command that allows to change addon settings.