Skip to content

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).

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.
Key Description
enabled Shows (true) or hides (false) the action bar.
text Text of the action bar.
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.

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.

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