Bossbars

Bossbars

Bossbars appear at the top of the player's screen.

Basic example:

bossbar:
  enabled: true
  text: "&b{event_display} &8| &f{time_left}"
  color: BLUE
  style: SOLID

---

Bossbar settings

Setting	Description
enabled	Enables or disables the bossbar
text	Bossbar text
color	Bossbar colour
style	Bossbar style

---

Bossbar colours

Common bossbar colours:

BLUE
GREEN
PINK
PURPLE
RED
WHITE
YELLOW

Example:

bossbar:
  enabled: true
  text: "&e{event_display} &8| &f{time_left}"
  color: YELLOW
  style: SOLID

---

Bossbar styles

Common bossbar styles:

SOLID
SEGMENTED_6
SEGMENTED_10
SEGMENTED_12
SEGMENTED_20

Example:

bossbar:
  enabled: true
  text: "&c{event_display} &8| &f{time_left}"
  color: RED
  style: SEGMENTED_10

---

Bossbar placeholders

Bossbars support EventForge placeholders.

Common placeholders:

{event}
{event_display}
{time_left}
{elapsed}
{score}
{rank}
{participants}
{player}
{var:key}

Example:

bossbar:
  enabled: true
  text: "&b{event_display} &8| &f{time_left} &8| &eScore: &f{score}"
  color: BLUE
  style: SOLID

---

Bossbar with score and rank

bossbar:
  enabled: true
  text: "&b{event_display} &8| &f{time_left} &8| &eScore: &f{score} &8| &7Rank: &e#{rank}"
  color: BLUE
  style: SOLID

This is a good default for most competitive events.

---

Animated bossbar text

EventForge can rotate bossbar text through multiple frames.

bossbar:
  enabled: true
  text: "&e{event_display} &8| &f{time_left}"
  color: YELLOW
  style: SOLID

  animated-text:
    enabled: true
    interval: 20
    frames:
      - "<stack:rainbow,wobble>{event_display}</stack> &8| &f{time_left}"
      - "&eScore: &f{score} &8| &7Rank: &e#{rank}"
      - "<pulse:#22d3ed:#ffffff>Keep going!</pulse>"

---

Animated bossbar settings

Setting	Description
animated-text.enabled	Enables rotating bossbar text
animated-text.interval	How often the bossbar changes frame, in ticks
animated-text.frames	List of bossbar text frames

info

20 ticks is about 1 second.

---

Animated bossbar with variables

You can use event variables inside bossbar frames.

variables:
  event_color: "&b"
  accent_color: "#22d3ed"

bossbar:
  enabled: true
  text: "{var:event_color}{event_display} &8| &f{time_left}"
  color: BLUE
  style: SOLID

  animated-text:
    enabled: true
    interval: 20
    frames:
      - "<gradient:#22d3ed:#ffffff>{event_display}</gradient> &8| &f{time_left}"
      - "&7Score: &f{score} &8| &7Rank: &e#{rank}"
      - "<pulse:#22d3ed:#ffffff>Keep pushing!</pulse>"

---

Animated bossbar with text effects

Bossbar frames support text effects.

bossbar:
  enabled: true
  text: "&b{event_display}"
  color: BLUE
  style: SOLID

  animated-text:
    enabled: true
    interval: 20
    frames:
      - "<rainbow>{event_display}</rainbow>"
      - "<shimmer:#22d3ed:#ffffff>Score: {score}</shimmer>"
      - "<pulse:#22d3ed:#ffffff>Rank: #{rank}</pulse>"

Good effects for bossbars:

gradient
pulse
shimmer
ocean
fire
sunset
stack

Avoid making every frame too busy. Bossbars are easier to read when the text is short.

---

Simple bossbar example

bossbar:
  enabled: true
  text: "&b{event_display} &8| &f{time_left}"
  color: BLUE
  style: SOLID

---

Competitive bossbar example

bossbar:
  enabled: true
  text: "&e{event_display} &8| &f{time_left} &8| &a{score} pts &8| &7#{rank}"
  color: YELLOW
  style: SEGMENTED_10

---