MiniMessage Format Guide for Paper & Velocity

MiniMessage is the modern text formatting system built into the Adventure library and used across Paper, Velocity, and many Minecraft server plugins. This guide shows you how to write clean, readable tags for colors, gradients, and interactive chat elements.

Color Code Text EditorGradient Text Generator

What is MiniMessage and How Does It Work?

MiniMessage is the text format of the Adventure library, which powers text display in Paper, Velocity, and many modern server plugins. Instead of relying on older symbol-based codes, it uses clear, readable tags enclosed in angle brackets to style server MOTDs, chat messages, tab lists, and plugin announcements.

Follow these basic rules when writing MiniMessage text:

  1. Open a tag: Place the formatting word inside angle brackets, such as <red> or <bold>, right before the text you want to style.
  2. Close a tag: Stop the formatting by typing a forward slash before the tag name, such as </red> or </bold>.
  3. Combine tags: Nest multiple tags together to apply both color and decoration to the same word.

Here is a basic example you can copy and paste into a plugin configuration:

<red>Warning:</red> <bold>The server is restarting soon!</bold>

Notice how closing the </red> tag stops the red color so the remaining text only receives the bold effect.

Applying Standard Colors and Custom Hex Codes

You can color your Minecraft text using either standard color names or exact six-character hexadecimal codes. Using full words makes your plugin configuration files much easier to read and edit later.

Use these copyable examples in your server files:

<green>Welcome to the survival world!</green>
<#FF8800>This text uses a custom orange hex code.</#FF8800>
<aqua>Player:</aqua> <#00FF88>Steve</#00FF88>

Text Decorations, Newlines, and Resets

Beyond colors, MiniMessage provides tags to change the style and layout of your text. You can apply these decorations individually or layer them inside color tags.

Here is how to combine decorations, line breaks, and resets:

<bold><underlined>Server Rules</underlined></bold><newline><italic>1. Be respectful to all players.</italic>
<red><bold><obfuscated>SECRET</obfuscated> <reset>Back to plain default text!

Creating Gradients and Rainbow Text

MiniMessage makes it simple to create smooth color transitions across words or entire sentences without manually coloring every single letter.

  1. Gradients: Use the <gradient:#a:#b> tag, replacing #a and #b with your starting and ending colors (such as hex codes or color names) separated by a colon. Close the effect with </gradient>.
  2. Rainbows: Wrap your text in <rainbow> and </rainbow> to automatically cycle through the color spectrum across the phrase.

To make a bold gradient or rainbow, place the <bold> tag inside or outside the color tags. Copy these examples to test them out:

<gradient:#FF8800:#FFFF00>Autumn Event Starts Today!</gradient>
<bold><gradient:#00AAFF:#00FF88>VIP Rank Unlocked</gradient></bold>
<rainbow>Congratulations on winning the parkour race!</rainbow>

Adding Interactive Click and Hover Actions

You can make chat announcements and server messages interactive by adding hover tooltips and clickable links. Arguments inside these tags are separated by colons.

You can even combine click and hover tags together so players see a helpful prompt before clicking a link:

<click:open_url:https://text.9minecraft.net><aqua><underlined>Click here to open our website!</underlined></aqua></click>
<hover:show_text:<green>Click to visit the store!</green>><click:open_url:https://text.9minecraft.net><bold>[Server Store]</bold></click></hover>

Escaping Brackets and Avoiding Legacy Codes

When setting up your server configurations, keep two important technical rules in mind regarding special characters and older formatting systems.

Escaping Literal Brackets: Because MiniMessage reads any < symbol as the start of a tag, typing something like <red> or <PlayerName> can accidentally trigger or break formatting. If you want a literal < character to show up in chat, escape it by placing a backslash directly in front of it: \<.

Use \<red> to make your text red!
\<Admin> Welcome to the server!

Legacy & Codes vs. MiniMessage: Older Minecraft setups often use legacy ampersand codes (like &c or &l). Legacy & codes are a completely different format from MiniMessage. Do not mix them together in the same line. Plugins usually support either MiniMessage or legacy codes, or offer a specific setting to convert between them. Check your plugin documentation to confirm MiniMessage is enabled before pasting your tags.

Questions

Can I mix legacy & color codes with MiniMessage tags?

No. Legacy & codes and MiniMessage are two different formatting systems. Most plugins support one format or the other, or use a converter, so mixing them in the same message usually causes raw codes to display in chat.

How do I display a normal < symbol in chat without starting a tag?

Place a backslash directly before the opening angle bracket, like this: \<. This escapes the character so MiniMessage displays it as normal text.

How do I stop a color or bold effect from applying to the rest of my sentence?

Close the specific tag using a forward slash, such as or , right after the word you want styled. Alternatively, insert to clear all active formatting at once.

How do I add a line break in MiniMessage?

Insert the tag wherever you want the text to drop down to the next line. It does not require a closing tag.

Related guides

See all →