Boss bar, action bar and title
How players see the progress of a reward track. Boss bar, action bar and title are set up per track.
Every reward track in a zone file can show its progress in three ways. All of them are updated every second, and their
texts can use the track placeholders such as {time_left}, {progress} and {chance} (see
Placeholders).
Boss bar (boss-bar)
Section titled “Boss bar (boss-bar)”| Key | Default | Description |
|---|---|---|
enabled |
Shows (true) or hides (false) the bar. |
|
text |
Text of the bar. | |
color |
GREEN |
PINK, BLUE, RED, GREEN, YELLOW, PURPLE or WHITE. |
style |
PROGRESS |
PROGRESS (one solid bar) or NOTCHED_6, NOTCHED_10, NOTCHED_12, NOTCHED_20 (split into segments). |
progress-direction |
INCREASING |
INCREASING fills the bar until the reward, DECREASING empties it. |
Action bar (action-bar)
Section titled “Action bar (action-bar)”| Key | Description |
|---|---|
enabled |
Shows (true) or hides (false) the action bar. |
text |
Text of the action bar. |
Title (title)
Section titled “Title (title)”| Key | Default | Description |
|---|---|---|
enabled |
Shows (true) or hides (false) the title. |
|
text |
Big text. '' means none. |
|
subtitle |
Smaller text below it. '' means none. |
|
fade-in-ticks |
10 |
Fade-in time in ticks (20 ticks = 1 second), used only when the title appears. At least 0. |
stay-ticks |
30 |
The title stays on screen while the player earns, because it is refreshed every second. This is how long it stays without a refresh, e.g. during lag. At least 1; values below 30 work as 30. |
fade-out-ticks |
10 |
Fade-out time in ticks when the title is not refreshed any more (e.g. during lag). When the player stops earning, the title disappears at once. At least 0. |
Several tracks at once
Section titled “Several tracks at once”A player sees only one action bar and one title at a time. When several tracks show an action bar or a title, their
texts are joined with displays.join-separator from config.yml (default ' &8| '). The title uses the times of the
first track. Boss bars are shown separately for each track.
Example
Section titled “Example”rewards: guaranteed: boss-bar: enabled: true text: '&fGuaranteed reward in &a{time_left} &8(&a{progress}%&8)' color: GREEN style: PROGRESS progress-direction: INCREASING action-bar: enabled: false text: '&fGuaranteed reward in &a{time_left}' title: enabled: false text: '' subtitle: '&fGuaranteed reward in &a{time_left}' fade-in-ticks: 10 stay-ticks: 30 fade-out-ticks: 10