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.

yaml
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.

yaml
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:

yaml
title: '%animation:title%'

Gradients work for dividers too:

yaml
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::

yaml
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.