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
| 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:
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
pausefor 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:
Customization Tips
- The
colorsarray defines the wave shape - more entries = wider wave - Use similar colors for smooth gradients:
["&b", "&3", "&9", "&3"] - Change
defaultColorto 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:
Visual behavior:
- Text starts in
defaultColor(white) - A gradient front sweeps left to right
- Characters behind the front remain in
trailColor(dark red) - 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
| Parameter | Value | Effect |
|---|---|---|
speed |
3 | Shifts every 3 ticks |
pause |
0 | Continuous scrolling; a pause holds the unshifted text after each full turn |
Usage:
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
speedfor 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
| 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:
Or use the shortcut:
Customization Tips
- For a two-color pulse:
"colors": ["&c", "&4"](red/dark red) - For team colors:
"colors": ["&9", "&6"](blue/gold) - Increase
speedfor 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:
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.