Animations
An animation is text that changes over time. Define it once under animations: and use it in the
scoreboard title or lines as %animation:<name>%. Every player sees the same frame
at the same moment.
There are two kinds: a list of frames, and a gradient wave that BusyTab builds for you.
Frames
The frames are shown one after another, then start again.
animations:
tips:
interval: 5s
frames:
- '&7Type &e/sb &7to hide this'
- '&7Vote daily for rewards'
| Option | Description |
|---|---|
interval |
How long each frame shows. Ticks (2t), seconds (5s) or milliseconds (250ms) |
frames |
The frames, in order. Each one takes the same formatting and placeholders as a line |
Gradient waves
A gradient that slides along the text. You give the text and the colors; BusyTab works out every frame, so the wave is smooth and loops without a jump.
animations:
title:
type: gradient
text: 'BusyBee Network'
colors: ['#f6c453', '#ff8a00', '#fff1c4']
steps: 30
interval: 2t
| Option | Default | Description |
|---|---|---|
type |
gradient |
|
text |
The text to color. Plain text only, no placeholders or color codes | |
colors |
Two or more #RRGGBB colors. The last one blends back into the first |
|
steps |
20 |
Frames in one full loop. More steps make a smoother, slower wave |
interval |
1s |
How long each frame shows |
direction |
right |
Which way the wave moves: right or left |
One loop takes steps × interval. The example above is 30 × 2 ticks = 3 seconds.
Bold, italics and the like go around the placeholder in the line, not in text:
title: '%animation:title%'
Gradients work for dividers too:
animations:
divider:
type: gradient
text: '━━━━━━━━━━━━━━━━━━'
colors: ['#3a3a3a', '#f6c453']
steps: 20
interval: 2t
direction: left
Moving from TAB
TAB's animation format works as it is. change-interval (milliseconds) is read as the interval and
texts as the frames, so you can paste the contents of TAB's animations.yml under animations::
animations:
tab1:
change-interval: 4800
texts:
- '&fChat With Our Community & Stay Updated!'
- '&fPurchase Ranks & Cosmetics To Support Us!'
Spigot-style hex codes (&x&1&4&C&F&F&F) work as well. A hand-made gradient wave of 50 frames,
each with a hex code per character, can usually be replaced by a type: gradient animation of a
few lines.
Good to know
- Names are case-insensitive.
%animation:Title%and%animation:title%are the same. - An unknown name is left as written, so a typo shows up as
%animation:...%on the board. - Only the lines that use an animation are redrawn when it moves to its next frame. A fast animation in one line doesn't make the other lines refresh.
- Animations are for the scoreboard. In the tab list header, footer and player names, they
would only move on the tab list's own
refresh-interval, so they aren't read there.