Banner

The banner replaces the classic action bar with boxes drawn above the hotbar. It shows short-lived messages — the ones that do not need to stay in chat — without two texts ever overlapping.

Two areas

Fixed items — left

Continuously updated information: job XP gains, AFK zone counter. Each item has an ID and stays visible as long as it is refreshed, then disappears after the configured duration.

Notifications — right

One-off messages (effect enabled, mention, purchase…) go one at a time through a queue. Each stays visible for the configured duration; when 3 or more messages are waiting, the duration drops to 2 seconds to catch up.

Each box has a background, an accent stroke colored by the message type, and a pixel-accurate width (text that is too long is cut with “…”). When the line is full, the oldest fixed items make room for the newest ones.

Resource pack required

The background, corners and accent stroke are characters of the cobaltia:bandeau font, which your resource pack must provide. Without it, the drawing characters show up as boxes.

Configuration

config.yml

bandeau:
  duree: 5                  # display time of a notification / fixed item, in seconds
  couleurs:                 # accent stroke color per type
    succes: "#6CF08A"
    info: "#6FE2E8"
    avert: "#FFD84A"
    refus: "#FF5A5A"
    xp: "#6CF08A"
    afk: "#F7C43A"
    vote: "#F7C43A"
  xp: "<white><icone><metier></white> <#6CF08A>+<gain> XP <gray>(<white><xp></white><dark_gray>/</dark_gray><white><max></white><gray>)"
  messages:                 # message keys sent to the banner instead of chat
    - "active"
    - "retire"
    - "mention"
  textes:                   # optional short version of these messages for the banner
    active: "<white></white> <gray><white><nom></white> brille sur ton pseudo"
    mention: "<white></white> <gray><white><joueur></white> t'a mentionné"
  icones_metiers:           # glyph shown before the job name (Nexo font)
    Mineur: "ꑉ"
    Pêcheur: "ꑍ"

Redirecting a message to the banner

1. Add the message key (see Messages) to bandeau.messages.
2. Optional: give it a short version in bandeau.textes (same tags as the original message). Without a short version, the full message is used.
3. /effets reload.

The type (hence the accent color) is derived from the first character of the message: glyph  → refus,  → avert,  → succes, anything else → info.

Messages sent to the console, or to a player when the key is not listed, still go to chat.

Job XP gains

With Jobs Reborn, each XP gain shows one fixed item per job, built from the bandeau.xp template:

Tag	Value
<icone>	Glyph from icones_metiers for that job (followed by a space), or nothing
<metier>	Displayed job name
<gain>	XP gained, accumulated while the item stays visible
<xp> / <max>	Current XP / XP for the next level

icones_metiers keys are the displayed job names (for example Mineur), without color codes.

The /bandeau command

/bandeau <player|*> <id> <type|#color> <message>

Argument	Description
<player|*>	An online player, or * for every player
<id>	Free notification ID (to find it in the queue)
<type|#color>	A type from bandeau.couleurs (succes, info, avert, refus, vote, xp, afk) or a #RRGGBB color
<message>	MiniMessage text; <joueur> is replaced by the recipient’s name

Examples

/bandeau * event info <white>Treasure hunt <gold>event</gold> in 5 minutes!
/bandeau Steve vote vote <gray>Thanks for voting, <white><joueur></white>!

Permission: cobaltia.bandeau.admin. The command is meant to be called by other plugins (votes, quests, crates) so that every short-lived message of the server goes through the same queue.