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	1 second pause after fully typed

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!
(pause 1 second)
(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	2 seconds between waves
`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	2 seconds between burns
`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	No pause (continuous scrolling)

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.

Customization Tips

Lower speed for faster scrolling (news ticker)
Add pause to briefly stop at a "home" position

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
`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": 20,
  "pause": 0,
  "frames": [
    "&aFrame 1: Hello!",
    "&bFrame 2: World!",
    "&cFrame 3: Goodbye!"
  ]
}

Parameter	Value	Effect
`speed`	20	New frame every 1 second
`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.