Skip to content
This repository has been archived by the owner on Jun 27, 2024. It is now read-only.

Formatting Codes

SlimeDog edited this page Apr 17, 2023 · 13 revisions

Java Minecraft formatting code equivalencies for legacy and MiniMessage formats. Both legacy codes and MiniMessage tags are supported by plugins that incorporate SlimeDogCore. Other plugins may recognize only one of them.

⚠️ Use one formatting scheme only; do not mix-and-match.

🚩 § is the defined legacy marker, but & may be substituted in most contexts, and is the more common usage. It is shown in the following table. Some plugins recognize both markers; some recognize only one of them.

Color codes

legacy
code
MiniMessage
tag
MiniMessage
hex
observed*
color
&0 <black> <#000000> #000000
&1 <dark_blue> <#0000AA> #0000A7
&2 <dark_green> <#00AA00> #00A700
&3 <dark_aqua> <#00AAAA> #00A7A7
&4 <dark_red> <#AA0000> #A70000
&5 <dark_purple> <#AA00AA> #A700A7
&6 <gold> <#FFAA00> #FBA700
&7 <gray> <#AAAAAA> #A7A7A7
&8 <dark_gray> <#555555> #545454
&9 <blue> <#5555FF> #5454FB
&a <green> <#55FF55> #54FB54
&b <aqua> <#55FFFF> #54FBFB
&c <red> <#FF5555> #FB5454
&d <light_purple> <#FF55FF> #FB54FB
&e <yellow> <#FFFF55> #FBFB54
&f <white> <#FFFFFF> #FBFBFB

Format codes

legacy
code
MiniMessage
tag
MiniMessage
alias
&l <bold> <b>
&m <strikethrough> <st>
&n <underlined> <u>
&o <italic> <i>
&r <reset>


By default, MiniMessage is parsed leniently, and invalid tags are simply ignored. Any tags left unclosed at the end of an input string will be automatically closed.

In strict mode, MiniMessage tags must be closed, in reverse order of opening. For example

<bold><red>some text</red></bold>

SlimeDogCore uses the default (lenient) mode.


* Depending on terminal settings, color correction may alter the actual colors presented. The observed colors shown above were measured as follows:

  • Display settings
    • Dell 3007WFP
    • Color temperature centered
    • Night shift off
  • Minecraft settings
    • Mac client
    • noon
    • light level 15
    • Options: Video Settings: Brightness: Bright
  • DigitalColorMeter settings
    • Display native values
Clone this wiki locally