Biomes for BentoBox

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 <biome>: This command allows to buy given biome.
• /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 <file>: import biomes from biomes.yml
• /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 unlock <player> <biome> [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.