Biomes is an addon for the BentoBox plugin ecosystem that introduces advanced biome management functionality. It enables server administrators to configure and manage biomes across islands, with features such as biome customization, purchasing, and unlocking mechanisms. ## 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 *biomesTemplate.yml* 4. Edit the config.yml and *biomesTemplate.yml* files how you want. The *biomesTemplate.yml* is for importing only. 5. Restart the server 6. Use the admin command for the game mode to set up biomes, e.g. `/bsb biomes` ## Config.yml 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. ## Biomes.yml 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 buy `: This command allows to buy given biome. * `/is biomes set [] []`: 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 `: import biomes from biomes.yml * `/bsbadmin biomes set [] []`: 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 unlock [true]`: This command unlocks passed biome to a player island.. ## Permissions `{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}.biomes.buy`: player can use biomes buy command. - `{GameModePrefix}.biomes.set`: player can use biomes set command. ###### Admin permissions: - `{GameModePrefix}.admin.biomes`: player can use admin biomes command that opens GUI.

Biomes for BentoBox

User GUI

Admin GUI example