Changes
- Cooldown notification can now be shown as a boss bar, not just the action bar.
- Fixed ISSUES-1029 - Tic Tac Toe Gadget no longer crashes on Minecraft 1.21.6+ / 26.x when a message field is empty.
New feature: Boss bar cooldown notification
Cosmetics with a cooldown (gadgets, morphs, etc.) can now display their remaining cooldown as a
boss bar at the top of the screen that empties as the cooldown runs down. The original
action bar style is still the default, so nothing changes unless you opt in.
All settings live in messages.yml under Cooldown-Notification. After updating to this version, start the server once so the new keys are written, then edit:
Code (YAML):
Cooldown-Notification:
Enabled: true
# Where the cooldown is shown: ACTION_BAR or BOSS_BAR
Display-Type: ACTION_BAR
# Used only when Display-Type is ACTION_BAR
Action-Bar:
Cooldown-Block:
Remain: '&c|' # a block still on cooldown
Retain: '&a|' # a block already recovered
Amount-Of-Blocks: 100 # how many blocks make up the bar
Cooldown-Message: '{NAME} &f{COOLDOWN_BLOCK} &f{TIME_LEFT}s'
# Used only when Display-Type is BOSS_BAR
Boss-Bar:
Color: PURPLE # PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE
Style: SOLID # SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20
Cooldown-Message: '{NAME} &f{TIME_LEFT}s'
To switch to the boss bar: set Display-Type: BOSS_BAR, then tune Boss-Bar.Color, Boss-Bar.Style, and Boss-Bar.Cooldown-Message.
Placeholders
- {NAME} The cosmetic's display name Action bar & boss bar
- {TIME_LEFT} Seconds remaining on the cooldown Action bar & boss bar
- {COOLDOWN_BLOCK} The rendered Remain/Retain block bar Action bar only
What to take note of
- 1.8 servers: Boss bars don't exist on 1.8. If you set BOSS_BAR there, it falls back to the action bar automatically.
- Invalid values fall back safely. A typo in Display-Type, Color, or Style won't error—it uses the default (ACTION_BAR / PURPLE / SOLID).
- {COOLDOWN_BLOCK} only works in the action bar. The boss bar uses its own fill instead, so leave it out of Boss-Bar.Cooldown-Message.
- Set Enabled: false to turn the whole cooldown notification off regardless of display type.