A lightweight utility for converting Minecraft's legacy formatting codes to MiniMessage tags.
Important
It's usually better to use LegacyComponentSerializer to deserialize String into Component, and then use MiniMessage to serialize the Component back to String. But if you got some unusual niche case - you're welcome here.
Here’s how legacy codes map to MiniMessage tags:
| Legacy Code | Converted |
|---|---|
&0 |
<black> |
&1 |
<dark_blue> |
&2 |
<dark_green> |
&3 |
<dark_aqua> |
&4 |
<dark_red> |
&5 |
<dark_purple> |
&6 |
<gold> |
&7 |
<gray> |
&8 |
<dark_gray> |
&9 |
<blue> |
&a |
<green> |
&b |
<aqua> |
&c |
<red> |
&d |
<light_purple> |
&e |
<yellow> |
&f |
<white> |
&x&1&2&3&4&5&6 |
<#123456> |
𞉀 |
<#123456> |
&@#abcdef-red-a@ |
<gradient:#abcdef:red:green> |
&r |
<reset> |
&l |
<b> |
&n |
<u> |
&m |
<st> |
&o |
<i> |
&k |
<obf> |
&&e |
&e (escaped) |
Current version:
- Add the JitPack repository to your
pom.xml:
<repositories>
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
</repositories>- Add the MiniTranslator dependency:
<dependency>
<groupId>com.github.imDaniX</groupId>
<artifactId>MiniTranslator</artifactId>
<version>v2.6.1</version>
</dependency>- Add the JitPack repository to your
build.gradle:
repositories {
maven { url 'https://jitpack.io' }
}- Add the MiniTranslator dependency:
dependencies {
implementation 'com.github.imDaniX:MiniTranslator:v2.6.1'
}