MiniTranslator

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.

Legacy Codes to MiniMessage Tags

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	<#123456>
&@#abcdef-red-a@	<gradient:#abcdef:red:green>
&r	<reset>
&l	<b>
&n	<u>
&m	<st>
&o	<i>
&k	<obf>
&&e	&e (escaped)

Get It

Current version:

Maven

1. Add the JitPack repository to your pom.xml:

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

2. Add the MiniTranslator dependency:

<dependency>
    <groupId>com.github.imDaniX</groupId>
    <artifactId>MiniTranslator</artifactId>
    <version>v2.6.1</version>
</dependency>

Gradle

1. Add the JitPack repository to your build.gradle:

repositories {
    maven { url 'https://jitpack.io' }
}

2. Add the MiniTranslator dependency:

dependencies {
    implementation 'com.github.imDaniX:MiniTranslator:v2.6.1'
}