Animations

#Animations

Put {anim:<name>} in a text line to show an animation there, such as {anim:rainbow}. The rest of the line stays as typed, so one line can mix animated and plain text. Every player sees the same frame at the same time.

Editor > Animations lists every animation with a preview and the token to copy. New animations, renames and deletions are saved to the file straight away. Lines that used the old name of a renamed animation need the new token.

#Animation Type

Type	Shows
Frames	Each of your frames in turn.
Typewriter	The text typed out one character at a time, then held for the Pause.
Scroll	The text sliding past, a Width of characters at a time.
Color Wave	The text with your colors running through it. Bold, italic and the other formats in the text are kept.

#Interval

How many ticks each frame shows, from 1 to 1200. 20 ticks are one second.

#Frames

Frames only. The lines shown one after another. A frame can hold color codes and placeholders.

#Text

Typewriter, Scroll and Color Wave. The text that is animated.

#Pause

Typewriter only. How many frames the full text stays before it is typed again.

#Width

Scroll only. How many characters are shown at once.

#Colors

Color Wave only. The colors that run through the text, as #RRGGBB. Without any, a rainbow is used.

#Text Tokens

Tokens are filled in before %player%, %page% and PlaceholderAPI, so an animation frame can hold a placeholder.

Token	Shows	Example
{anim:<name>}	The current frame of the animation.	{anim:rainbow}
{countdown:<date>}	The time left until the date, then the ended text. The date is yyyy-MM-dd HH:mm:ss, yyyy-MM-dd HH:mm or yyyy-MM-dd.	{countdown:2026-12-25 00:00}
{date:<pattern>}	The current date or time, in a Java date pattern.	{date:HH:mm}, {date:EEEE d MMMM}

Countdowns and dates update every second, in the time zone set in config.yml. The countdown wording, the ended text and the language of day and month names are in the translation file. A token that cannot be read is left as typed.

#In the File

animations:
  welcome:
    type: TYPEWRITER
    interval: 2
    text: "&eWelcome to the server!"
    pause: 30
  spinner:
    type: FRAMES
    interval: 4
    frames:
      - "&c|"
      - "&6/"
      - "&e-"

Run /pholo reload after editing the file by hand.