> For the complete documentation index, see [llms.txt](https://edseries-plugins.gitbook.io/p/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://edseries-plugins.gitbook.io/p/edevents/features/displays.md).

# Boss Bar & Action Bar

Both are configured per event (`bossbar` / `actionbar` sections, defaults in `event-defaults`) and both are **personal**: every player sees their own score and position. Text is built off the main thread once per second.

## Boss bar

```yaml
bossbar:
  enabled: true
  text: "&e&l{event} &7- &f{time_left} &8| &a{progress_formatted} &8(&f#{position}&8)"
  color: YELLOW           # PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE
  style: SEGMENTED_10     # SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20
  progress: TIME          # what the bar fill shows
  flash-last-seconds: true
  flash-seconds: 10
  flash-color: RED
```

`progress`: `TIME` drains as time passes, `TIME_ELAPSED` fills, `GOAL` shows the community total (or the leader) against `objective.goal`, `PLAYER` shows the viewer's own progress against the goal. With `flash-last-seconds` the bar blinks in `flash-color` during the last `flash-seconds`.

## Action bar

```yaml
actionbar:
  enabled: true
  text: "&e⛏ &f{time_left_short} &8| &a{progress_formatted} &7{objective} &8(&f#{position}&8)"
```

EdPrison, PinnaPrison, EdTools and EdDungeons all show their own action bar while you mine or fight (level progress, income...). EdEvents never fights it:

1. On startup EdEvents registers itself as an **action bar addon** of the host plugin. The host appends the event text to its own bar, separated by the host's `addon-separator` (`config.yml` on EdPrison, `display.yml` on PinnaPrison, `actionbar.yml` on EdTools/EdDungeons).
2. When the host is not showing a bar to a player (not mining, outside a zone, host bar disabled), EdEvents sends the event bar itself after `actionbar.standalone-after-ms`.

```yaml
# config.yml
actionbar:
  standalone: true            # send our own bar when the host shows none
  standalone-after-ms: 1500
  separator: " &8| "          # between several concurrent events
```

`%edevents_actionbar%` returns the rendered event bar, so you can also place it inside the host plugin's own action bar format by hand.

## Player toggles

`/events toggle bossbar|actionbar|messages|all` lets players hide the displays and the event chat messages (`edevents.toggle`). The choice is saved.