Skip to content

Built-in Animations

MasuHolograms generates 6 default animation files on first startup. Each can be customized by editing its JSON file in config/masuholograms/animations/.

typewriter

Characters appear one by one, like typing on a typewriter. After all characters are revealed, it pauses then resets.

File: animations/typewriter.json

{
  "type": "typewriter",
  "speed": 3,
  "pause": 20
}

Parameter Value Effect
speed 3 New character every 3 ticks (0.15s)
pause 20 Holds the full text for 20 extra steps (60 ticks, 3 seconds)

Usage:

{#ANIM:typewriter}Welcome to the Server!{/#ANIM}

Visual:

W
We
Wel
Welc
Welco
Welcom
Welcome
Welcome
Welcome t
Welcome to
...
Welcome to the Server!
(holds 3 seconds)
(restart)

Customization Tips

  • Lower speed (e.g., 1) = faster typing
  • Higher speed (e.g., 6) = slower, more dramatic reveal
  • Increase pause for longer display of complete text

wave

A color wave sweeps across the text from left to right. Characters light up in sequence using the color array, then return to the default color.

File: animations/wave.json

{
  "type": "wave",
  "speed": 2,
  "pause": 40,
  "colors": ["&e", "&6", "&c", "&4", "&c", "&6"],
  "defaultColor": "&f"
}

Parameter Value Effect
speed 2 Wave moves every 2 ticks
pause 40 Holds the text in the default color for 40 extra steps (80 ticks, 4 seconds) before the next wave
colors yellow to dark red and back Color gradient of the wave
defaultColor &f (white) Color for unlit characters

Usage:

{#ANIM:wave}Important Message{/#ANIM}

Customization Tips

  • The colors array defines the wave shape - more entries = wider wave
  • Use similar colors for smooth gradients: ["&b", "&3", "&9", "&3"]
  • Change defaultColor to match your hologram's theme

burn

A gradient sweep moves across text with a trailing color effect, like fire spreading across text.

File: animations/burn.json

{
  "type": "burn",
  "speed": 2,
  "pause": 40,
  "gradientColors": ["&e", "&6", "&c", "&4"],
  "trailColor": "&4",
  "defaultColor": "&f"
}

Parameter Value Effect
speed 2 Burn moves every 2 ticks
pause 40 Holds the burnt text for 40 extra steps (80 ticks, 4 seconds)
gradientColors yellow → dark red Colors of the burning front
trailColor &4 (dark red) Color left behind after the burn passes
defaultColor &f (white) Color of unburned characters

Usage:

{#ANIM:burn}Fire Effect Text{/#ANIM}

Visual behavior:

  1. Text starts in defaultColor (white)
  2. A gradient front sweeps left to right
  3. Characters behind the front remain in trailColor (dark red)
  4. After the burn completes, pauses, then resets

Customization Tips

  • For a blue ice effect: gradientColors: ["&b", "&3", "&9", "&1"], trailColor: "&1", defaultColor: "&f"
  • For a green poison effect: gradientColors: ["&a", "&2", "&6", "&4"], trailColor: "&2"

scroll

Rotates text horizontally in a circular loop, like a marquee/ticker.

File: animations/scroll.json

{
  "type": "scroll",
  "speed": 3,
  "pause": 0
}

Parameter Value Effect
speed 3 Shifts every 3 ticks
pause 0 Continuous scrolling; a pause holds the unshifted text after each full turn

Usage:

{#ANIM:scroll}Breaking News: Server event this weekend!    {/#ANIM}

Visual:

Breaking News: Server event this weekend!
reaking News: Server event this weekend!    B
eaking News: Server event this weekend!    Br
aking News: Server event this weekend!    Bre
...

Info

Add trailing spaces at the end of your text to create a visual gap between the end and beginning of the scrolling text. Commands typed in game lose repeated and trailing spaces (Minecraft collapses them in chat), so add the gap from the server console or in the hologram file.

Customization Tips

  • Lower speed for faster scrolling (news ticker)

colors

Cycles the entire text through a rainbow of colors. Each step applies the next color in the array to the whole text.

File: animations/colors.json

{
  "type": "colors",
  "speed": 4,
  "pause": 0,
  "colors": ["&c", "&6", "&e", "&a", "&b", "&9", "&d"]
}

Parameter Value Effect
speed 4 Color changes every 4 ticks
pause 0 Continuous cycling; a pause holds the last color before the cycle restarts
colors Rainbow array Colors to cycle through

Usage:

{#ANIM:colors}Rainbow Text{/#ANIM}

Or use the shortcut:

&uRainbow Text

Customization Tips

  • For a two-color pulse: "colors": ["&c", "&4"] (red/dark red)
  • For team colors: "colors": ["&9", "&6"] (blue/gold)
  • Increase speed for slower, more readable color changes

example_frames

A demonstration of the frames animation type. Cycles through explicit text frames.

File: animations/example_frames.json

{
  "type": "frames",
  "speed": 5,
  "pause": 0,
  "frames": [
    "&aFirst frame",
    "&bSecond frame",
    "&cThird frame"
  ]
}

Parameter Value Effect
speed 5 New frame every 5 ticks (0.25 seconds)
pause 0 No pause between cycles
frames 3 text frames Explicit display text for each step

Usage:

{#ANIM:example_frames}ignored text{/#ANIM}

Warning

With frames type, the text between the animation tags is completely replaced by the frame content. The original text is ignored.

See Custom Animations for more on creating frame-based animations.