Conditions & Animations

Features

Conditions & Animations

Display Conditions

Define reusable, named conditions under conditions, then reference them anywhere with condition: <name>. Each condition combines its sub-conditions with AND or OR.

conditions:
  is-vip:
    type: AND
    conditions:
    - "%luckperms_primary_group% = vip"
    yes: "<gold>✦ VIP"
    no: ""
  low-health:
    type: OR
    conditions:
    - "%player_health% < 6"
    yes: "<red><bold>⚠ LOW HEALTH"
    no: ""
OperatorMeaning
= ==Equal (numeric if both sides are numbers, else case-insensitive text)
!=Not equal
>= <= > <Numeric comparison
contains / !containsSubstring check

A condition can be used two ways:

  • To gate a message, scoreboard, tab-list, line or join/quit variant: condition: is-vip
  • As a value: %xannounce_condition_<name>% prints the condition's yes / no output (an empty no makes a self-hiding line)

Animations

Define animated text under animations — a list of frames cycled at a fixed interval. Insert %animation:<name>% in any text (tab-list, scoreboard, bossbar, title, chat, join/quit…).

animations:
  brand:
    interval: 400    # milliseconds per frame
    frames:
    - "<#FF5555><bold>Celestis"
    - "<#FFAA55><bold>Celestis"
    - "<#FFFF55><bold>Celestis"

Frames may contain placeholders, and the current frame is derived from the wall clock — every player sees the same frame at the same moment.

Still need help?

Ask our team on Discord or browse the source.