Skip to main content

Minecraft Formatting

This page explains how colors are used in translations and what features they support.

Introduction to Adventure​

Adventure is the library we use to format our translations to messages that can be viewed ingame. In detail, we use the MiniMessage format the library provides.

Full documentation on the MiniMessage format can be found in the official docs.​

Tags​

The MiniMessage format uses tags consisting of less than and greater than brackets.

Tags have a start tag and an end tag (the <reset> tag is an exception here). Start tags are mandatory, but end tags aren’t.

<yellow>Hello <blue>World<yellow>!

and

<yellow>Hello <blue>World</blue><yellow>!

and even

<yellow>Hello </yellow><blue>World</blue><yellow>!</yellow>

are all visually identical.

For tags with no content, tags can be auto-closed by using the format <tag/>. With this format, even in strict mode no separate closing tag should be provided.

Legacy Colors​

Previously Minecraft only provided a set of limited colors to use. Even tho we are now able to use hex colors, the legacy colors are still supported and widely used.

Existing legacy colors are: black, dark_blue, dark_green, dark_aqua, dark_red, dark_purple, gold, gray, dark_gray, blue, green, aqua, red, light_purple, yellow, white.

Each can be defined in a tag like this: <colorname> for example for red it would be <red>.

Hex Colors​

Hex colors are supported as well, with the format #RRGGBB. For example

<#00ff00>This message is green!

Gradients and Rainbow​

The MiniMessage format also supports gradients and rainbow colors. For example

<gradient:#5e4fa2:#f79459>||||||||||||||||||||||||</gradient>
<gradient:green:blue:red>||||||||||||||||||||||||</gradient>
<rainbow>||||||||||||||||||||||||</rainbow>