Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!

Reward your players for discovering and spending time in every Biome!
Designed with Survival/Faction servers in mind.

- 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 |
Pages
Members
Owner




