Logo

Reward your players for discovering and spending time in every Biome!

Designed with Survival/Faction servers in mind.

This plugin gives the player the ability to level up Biomes. You can configure how long they must be inside a Biome before they level up. For each Biome and each level you can set a reward.

Levelling system
MySQL support
Multi version support
Fully customisable messages (with hex colour support)
Custom effects - (Eg, Speed swimming in lava, regen food over time)
Reward system - (Give permissions, money, items, experience, potion effects, custom effects or even run commands)
PlaceholderAPI placeholders

Find a copy of the default config here

database: []
settings: []
gui: []
default_biome_settings: []
biomes:
  FOREST:
    '1':
      type: multi-use # Valid types: singular or multi-use (Only needed for potion + effect reward types)
      target_duration: 60 # seconds
      reward_type: potion # Valid types: potion, effect, item, permission, command, experience, currency, null
      reward_item: jump:2 #potion effect:amplifier:duration
    '2':
      target_duration: 60
      reward_type: item
      reward_item: apple:5 # material:quantity
  PLAINS:
    '1':
      target_duration: 60 # seconds
      reward_type: item
      reward_item: apple:5
    '2':
      target_duration: 60
      reward_type: currency
      reward_item: 2000 # Amount
    '3':
      target_duration: 60
      reward_type: command
      reward_item: give %player% apple 2 # use placeholder %player%
      reward_description: '&dCustom &6command' # 'reward_description' only valid on command reward types
    '4':
      target_duration: 60
      reward_type: experience
      reward_item: 10 # How many experience levels to give
  FLOWER_FOREST:
    '1':
      type: singular
      target_duration: 60
      reward_type: potion
      reward_item: jump:2

Player commands

Command	Permission	Description	Default
/biome	`biomemastery.player`	Negate this to stop the command showing in tab complete	true
/biome	`biomemastery.player.command`	Negate this to remove access to all of the following commands	true
/biome info [page]		Shows your biome levels
/biome info [biome]		Shows more in-depth details about a particular biome
/biome info [player] [page]	`biomemastery.player.others`	Shows biome levels of the specified player	true
/biome info [biome] [player]	`biomemastery.player.others`	Shows in-depth details about a particular biome of the specified player	true
/biome reward [biome] [level]		Toggles a reward (Used for the multi-use rewards)

Admin commands

Command	Permission	Description	Default
/abiome	`biomemastery.admin`	Allows access to the command	op
/abiome list worlds		Lists all the enabled worlds
/abiome enable\|disable [world]		Adds/Removes the world from the config. The server must be restarted for it to take effect
/abiome list biomes		Lists all the enabled biomes
/abiome enable\|disable [biome]		Adds/Removes the biome from the config. The server must be restarted for it to take effect
/abiome setlevel [player] [biome] [amount]		Set a players biome level
/abiome addlevel[player] [biome] [amount]		Add a whole level to a players biome level
/abiome removelevel [player] [biome] [amount]		Remove a whole level a players biome level
/abiome setprogress [player] [biome] [amount]		Set the players progress for the specified biome
/abiome addprogress [player] [biome] [amount]		Add to the players progress for the specified biome
/abiome removeprogress [player] [biome] [amount]		Remove from the players progress for the specified biome
/abiome reload	`biomemastery.reload`	Reloads the plugin	op
/abiome reset [player]	`biomemastery.reset`	Resets all of the players data	op
/abiome reset [player] [biome]	`biomemastery.reset`	Clears all of the players data for a specified biome	op

Placeholder	Example	Description
`%biomemastery_{BIOME}_level%`	`%biomemastery_plains_level%` `%biomemastery_nether_wastes_level%`	Returns the players level for the specified biome
`%biomemastery_{BIOME}_progress%`	`%biomemastery_plains_progress%` `%biomemastery_deep_cold_ocean_progress%`	Returns the players progress for the specified biome

Effect Name	Description
FREEFOOD	Restores food to the player. You can set the amount of food to be given, and how often it should be applied
SPEEDSWIMMER	This allows the player to swim faster in water
LAVASWIMMER	This allows the player to swim faster in lava

Message me on Discord for support, feature requests or any other assistance you may need.