Skip to content

Color Codes & Formatting

MasuHolograms supports multiple color systems. Colors are processed in a specific order, and all systems can be combined in a single line.

Legacy Color Codes

Use & followed by a code character. These work exactly like Bukkit/Spigot color codes.

Colors

Code Color Code Color
&0 Black &8 Dark Gray
&1 Dark Blue &9 Blue
&2 Dark Green &a Green
&3 Dark Aqua &b Aqua
&4 Dark Red &c Red
&5 Dark Purple &d Light Purple
&6 Gold &e Yellow
&7 Gray &f White

Formatting

Code Effect
&k Obfuscated (random characters)
&l Bold
&m ~~Strikethrough~~
&n Underline
&o Italic
&r Reset all formatting

Examples

/mh line set myHolo 1 1 &cRed text
/mh line set myHolo 1 1 &6&lBold Gold
/mh line set myHolo 1 1 &aGreen &7- &cRed &7- &9Blue
/mh line set myHolo 1 1 &k&4!!!&r &6&lWARNING &k&4!!!

Hex Colors

Use &# followed by a 6-digit hex color code for any RGB color.

&#RRGGBB

Examples

/mh line set myHolo 1 1 &#FF5533Orange Text
/mh line set myHolo 1 1 &#00CCFFCyan Text
/mh line set myHolo 1 1 &#FFD700Gold Text

Common Hex Colors

Hex Code Color
&#FF0000 Pure Red
&#00FF00 Pure Green
&#0000FF Pure Blue
&#FFFF00 Yellow
&#FF00FF Magenta
&#00FFFF Cyan
&#FFFFFF White
&#000000 Black
&#FFD700 Gold
&#FF6B6B Soft Red
&#4ECDC4 Teal
&#A855F7 Purple

Gradients

Create smooth color transitions across text using the gradient syntax.

<GRADIENT:startHex>text</GRADIENT:endHex>

Each character in the text gets a color interpolated between the start and end colors.

Examples

/mh line set myHolo 1 1 <GRADIENT:FF0000>Hello World</GRADIENT:0000FF>
This creates text that fades from red to blue.

/mh line set myHolo 1 1 <GRADIENT:FFD700>Server Name</GRADIENT:FF6B00>
Gold to orange gradient.

/mh line set myHolo 1 1 <GRADIENT:00FF00>Online Players: 5</GRADIENT:00AA00>
Light green to dark green.

Info

Gradients are calculated per-character, so longer text produces smoother gradients. Very short text (2-3 characters) will have abrupt color changes.

Rainbow

Apply a full HSB rainbow across the text.

<RAINBOW>text</RAINBOW>

Example

/mh line set myHolo 1 1 <RAINBOW>Welcome to the Server!</RAINBOW>

Each character cycles through the rainbow spectrum based on its position.

Custom Text Replacements

MasuHolograms includes special character shortcuts for decorative text. These are defined in config.json under customReplacements and can be customized.

Default Replacements

Shortcut Character Description
[x] or [X] █ Full block
[/] ▀ Upper half block
[,] ░ Light shade
[,,] ▒ Medium shade
[,,,] ▓ Dark shade
[p] or [P] • Bullet point
[|] ⎮ Vertical bar

Examples

/mh line set myHolo 1 1 &8[,,,][,,][,] &fServer Info &8[,][,,][,,,]
/mh line set myHolo 1 1 &6[p] &fFirst item
/mh line set myHolo 1 1 &6[p] &fSecond item
/mh line set myHolo 1 1 &c[x][x][x][x][x] &fHealth Bar

Adding Custom Replacements

Edit config.json to add your own:

{
  "customReplacements": {
    "[x]": "\u2588",
    "[star]": "\u2605",
    "[heart]": "\u2764",
    "[arrow]": "\u279C"
  }
}

Then /mh reload to apply.

Processing Order

Colors are processed in this order:

  1. Custom replacements — [x], [p], etc.
  2. Gradients — <GRADIENT:hex>...</GRADIENT:hex>
  3. Rainbow — <RAINBOW>...</RAINBOW>
  4. Hex colors — &#RRGGBB
  5. Legacy codes — &0-9a-fk-or

This means gradients and rainbow override legacy codes within their range, and hex colors take precedence over legacy codes.

Combining Color Systems

You can mix different color systems in a single line:

/mh line set myHolo 1 1 &6[p] <GRADIENT:FF0000>Important text</GRADIENT:FFFF00> &7- &#00CCFFMore info

This creates: - Gold bullet point - Red-to-yellow gradient text - Gray dash - Cyan hex-colored text