👾 Bossbars & Sidebars

EventForge can display event information through bossbars and sidebars.

These are useful for showing players:

event name
time left
player score
player rank
participant count
objective progress
short rotating messages

tip

Use bossbars for short event status text. Use sidebars when you want more detailed player information.

---

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

---

Sidebars

Sidebars appear on the side of the player's screen.

They are better for showing several lines of event information.

Basic example:

sidebar:
  enabled: true
  title: "&b&l{event_display}"
  lines:
    - "&7Time: &f{time_left}"
    - "&7Score: &a{score}"
    - "&7Rank: &e#{rank}"

---

Sidebar settings

Setting	Description
enabled	Enables or disables the sidebar
title	Sidebar title
lines	Sidebar lines

---

Sidebar placeholders

Sidebars support normal EventForge placeholders.

Common placeholders:

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

Example:

sidebar:
  enabled: true
  title: "&b&l{event_display}"
  lines:
    - "&8&m----------------"
    - "&7Time: &f{time_left}"
    - "&7Score: &a{score}"
    - "&7Rank: &e#{rank}"
    - "&7Players: &f{participants}"
    - "&8&m----------------"

---

Simple sidebar example

sidebar:
  enabled: true
  title: "&b&l{event_display}"
  lines:
    - "&7Time: &f{time_left}"
    - "&7Score: &a{score}"
    - "&7Rank: &e#{rank}"

---

Detailed sidebar example

sidebar:
  enabled: true
  title: "&b&l{event_display}"
  lines:
    - "&8&m----------------"
    - "&7Time Left:"
    - "&f{time_left}"
    - ""
    - "&7Your Score:"
    - "&a{score}"
    - ""
    - "&7Your Rank:"
    - "&e#{rank}"
    - ""
    - "&7Participants:"
    - "&f{participants}"
    - "&8&m----------------"

---

Sidebar with variables

variables:
  event_color: "&b"
  sidebar_footer: "&7Good luck!"

sidebar:
  enabled: true
  title: "{var:event_color}&l{event_display}"
  lines:
    - "&8&m----------------"
    - "&7Time: &f{time_left}"
    - "&7Score: &a{score}"
    - "&7Rank: &e#{rank}"
    - ""
    - "{var:sidebar_footer}"
    - "&8&m----------------"

---

Player sidebar toggle

Players can toggle event UI with:

/events toggle

Permission:

eventforge.player.toggle

This is useful for players who do not want sidebars or event displays on their screen.

---

Bossbar vs sidebar

Use a bossbar when you only need a short status line.

Good for:

event name
time left
small score display
rotating short messages

Use a sidebar when you need multiple lines.

Good for:

score
rank
time left
participants
objective hints
extra instructions

---

Common mistakes

Bossbar text is too long

Keep bossbar text short.

Bad:

text: "&bMining Rush is currently active and you need to mine blocks to gain points before the timer runs out!"

Better:

text: "&bMining Rush &8| &f{time_left} &8| &e{score} pts"

Too many animated bossbar frames

Use 2-4 frames for most events.

Too many frames can make the bossbar feel distracting.

Sidebar has too many lines

Keep sidebars readable.

A sidebar should show useful information quickly, not become a full help menu.

---

Summary

Bossbars and sidebars help players understand what is happening during an event.

Use:

bossbars for short status
animated bossbars for rotating event hints
sidebars for detailed player progress
actionbars for quick score feedback
titles for big event moments

For polished events, combine bossbars and sidebars with variables, placeholders, and text effects.