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'
}