
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
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:
<red> or <bold>, right before the text you want to style.</red> or </bold>.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.
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.
<red>, <gold>, <green>, <aqua>, or <yellow>.<#FF8800>. Close a hex tag using the exact same code with a slash: </#FF8800>.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>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.
<bold> and </bold>: Makes the enclosed text thick.<italic> and </italic>: Slants the text to the side.<underlined> and </underlined>: Draws a line beneath the text.<strikethrough> and </strikethrough>: Draws a line directly through the center of the text.<obfuscated> and </obfuscated>: Makes the characters scramble continuously like magic text.<newline>: Breaks the text onto a brand new line without needing a closing tag.<reset>: Immediately clears all active colors and decorations that came before it, returning the text to default without needing to close individual 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!MiniMessage makes it simple to create smooth color transitions across words or entire sentences without manually coloring every single letter.
<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>.<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>You can make chat announcements and server messages interactive by adding hover tooltips and clickable links. Arguments inside these tags are separated by colons.
<click:open_url:https://...> to open a web link when a player clicks the text. Close it with </click>.<hover:show_text:...> to display a pop-up box when a player moves their mouse cursor over the text. Close it with </hover>.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>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.
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.
Place a backslash directly before the opening angle bracket, like this: \<. This escapes the character so MiniMessage displays it as normal text.
Close the specific tag using a forward slash, such as or , right after the word you want styled. Alternatively, insert
Insert the