Skip to content

Bossbar & Actionbar

Tebrox edited this page Sep 20, 2026 · 1 revision

Bossbar & Actionbar

AFK Area can display live AFK area session information with a bossbar and actionbar.

These are global server features, not per-player preferences.

When displays are shown

Displays are shown while AFK Area has an active AFK area session for the player.

They are removed when the player leaves the AFK area or the display is disabled.

Both update once per second.

Bossbar

Default configuration:

display:
  bossbar:
    enabled: true
    color: yellow
    style: progress

Default text in messages.yml:

<gold>AFK Area</gold> <gray>•</gray> <yellow><session></yellow>

Supported colors

pink
blue
red
green
yellow
purple
white

Supported styles

progress
notched-6
notched-10
notched-12
notched-20

When reward progress is available, the bossbar progress tracks the current interval or milestone cycle.

Actionbar

Default configuration:

display:
  actionbar:
    enabled: true

Default text when a next reward exists:

<gray>Next reward in <aqua><next_reward></aqua></gray>

Default fallback when no next reward is available:

<gray>AFK Area <yellow><session></yellow></gray>

Display placeholders

Placeholder Description
<session> Current AFK area session duration
<next_reward> Time until the next reward
<progress_percent> Reward-cycle progress percentage

Durations use:

HH:MM:SS

Enabling and disabling

Bossbar:

/afkarea display bossbar on
/afkarea display bossbar off

Actionbar:

/afkarea display actionbar on
/afkarea display actionbar off

Permission:

afkarea.admin.display

These commands persist the setting in config.yml.

Editing display text

Edit:

plugins/AFKArea/messages.yml

Relevant keys:

display.bossbar.text
display.actionbar.text
display.actionbar.no-reward-text

MiniMessage and legacy & formatting are supported.

Apply text changes with:

/afkarea reload

Schedule changes

Changing an area's reward schedule resets reward-cycle progress for current sessions in that area.

The overall AFK area session duration shown by <session> is preserved.

Related pages

Clone this wiki locally