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: ""
| Operator | Meaning |
|---|---|
= == | Equal (numeric if both sides are numbers, else case-insensitive text) |
!= | Not equal |
>= <= > < | Numeric comparison |
contains / !contains | Substring 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'syes/nooutput (an emptynomakes 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.