Feature guide: Bossbar
bars:
MyBossbar:
style: "PROGRESS"
color: "%animation:barcolors%"
progress: "100" # in %
text: "&fWebsite: &bwww.domain.com"
Every bossbar line has 4 properties:
Type of bossbar division. Only visible on 1.9+ clients.
You can choose from 5 styles: PROGRESS, NOTCHED_6, NOTCHED_10, NOTCHED_12 and NOTCHED_20
These were defined by mojang, no other options are available. Other plugins using bukkit API to send bossbars may be using different names, but it's the same afterall.
Color of bossbar. Only visible on 1.9+ clients. Old clients will see it purple.
You can choose from 7 colors: BLUE, GREEN, PINK, PURPLE, RED, WHITE and YELLOW
These were defined by mojang, no other options are available.
A number from 0 to 100. Accepts decimals. Using values higher than 100 will result in visual glitch.
Text of the bossbar.
All 4 properties support placeholders. This includes animations, which can be used to create changing text using a slow animation for example.
There are 3 ways to display a bossbar
default-bars:
- MyBossbar
- MyBossbar2
These bars are visible all the time if they display condition is met.
per-world:
testworld:
- "testbar1"
- "testbar2"
Where testworld is a name of world where the bossbars should be visible and testbar1 with testbar2 are bossbars visible only in that world.
/tab announce bar <name> <time>
name is name of bossbar defined in bossbar.yml, time is length of display time in seconds.
bossbar-enabled: false
When enabled, enabled the entire bossbar feature.
bossbar-toggle-command: /bossbar
A command to toggle bossbar visibility for player running the command.
permission-required-to-toggle: false
If enabled, tab.togglebar permission is required to perform bossbar-toggle-command.
remember-toggle-choice: false
If enabled, disabling bossbar using bossbar-toggle-command is remembered between reloads and restarts.