MiniMessage Formatting for Minecraft Plugin Messages
Understand MiniMessage tags, colors, gradients and common formatting mistakes when customizing Minecraft plugin messages.
MiniMessage Formatting for Minecraft Plugin Messages
MiniMessage is a tag-based text format used by Adventure-compatible Minecraft plugins. It can add colors, gradients and text decoration to chat messages and other supported interfaces. Not every plugin supports MiniMessage, so check the target plugin's documentation before using these examples.
Quick answer: MiniMessage uses tags such as <green>text</green> and <gradient:#FFB52E:#FF7A18>text</gradient>. Close every tag you open, preserve plugin placeholders, and confirm that the target plugin supports MiniMessage before adding it to a config.
Basic color tags
A simple message can use an opening tag and a closing tag:
<green>Welcome to the server!</green>
<yellow>Warning:</yellow> <gray>Read the rules before playing.</gray>
Hex colors
Where supported, use a hex color tag for a specific color:
<#FFB52E>Gold text</#FFB52E>
<#35C9FF>Aqua text</#35C9FF>
Gradients
Gradients transition between two or more colors:
<gradient:#FFB52E:#FF7A18>Welcome to ZCraft</gradient>
Bold and italic text
Formatting tags can be combined with color tags:
<bold><yellow>Important</yellow></bold>
<italic><gray>Additional information</gray></italic>
Common mistakes
- Using MiniMessage tags in a plugin that only supports legacy color codes
- Forgetting to close a tag
- Misspelling a tag or hex color
- Copying formatting into a file or field that expects a different syntax
- Assuming every plugin supports gradients, click events or hover events
Keep placeholders intact
Message templates often contain placeholders that the plugin replaces with player names, reasons, durations or other values. Preserve the exact placeholder spelling and braces when editing the surrounding text. Changing a placeholder can cause it to display literally or stop working.
Test before using it live
Back up the original message file, change one message, reload or restart as documented by the plugin, and test the result in-game. Check console errors if the message fails to load.
For the official syntax reference, see the Adventure MiniMessage documentation. For product-specific support, visit the ZCraft Studios Discord.