HomeJavaModsColorizeAPI
ColorizeAPI
A lightweight and universal text formatter for Minecraft.
Seamlessly mix MiniMessage, Legacy (&), and HEX (&#RRGGBB) colors in a single string.

Requirements
  • Java 17 or newer
[HR][/HR]
Installation
This library is hosted on JitPack.
Step 1. Add the JitPack repository
Maven (pom.xml):
Code (XML):
<repositories>
    <repository>
        <id>jitpack.io </id>
        <url>https://jitpack.io </url>
      </repository>
</repositories>
Gradle Groovy (build.gradle):
Code (Groovy):
repositories {
    mavenCentral ( )
    maven { url 'https://jitpack.io' }
}
Gradle Kotlin (build.gradle.kts):
Code (Kotlin):
repositories {
    mavenCentral ( )
    maven { url = uri ( "https://jitpack.io" ) }
}
Step 2. Add the dependency
Maven (pom.xml):
Code (XML):
<dependency>
    <groupId>com.github.Klaidi4YT </groupId>
    <artifactId>ColorizeAPI </artifactId>
    <version>1.0 </version>
</dependency>
Gradle Groovy (build.gradle):
Code (Groovy):
dependencies {
    implementation 'com.github.Klaidi4YT:ColorizeAPI:1.0'
}
Gradle Kotlin (build.gradle.kts):
Code (Kotlin):
dependencies {
    implementation ( "com.github.Klaidi4YT:ColorizeAPI:1.0" )
}
[HR][/HR]
⚠️ Relocation (Important)
To avoid ClassNotFoundException or conflicts with other plugins, you must relocate the net.kyori library to your own package.
Maven (inside maven-shade-plugin):
Code (XML):
<relocations>
    <relocation>
        <pattern>net.kyori </pattern>
        <shadedPattern>your.package.libs.kyori </shadedPattern>
    </relocation>
</relocations>
Gradle Groovy (inside shadowJar):
Code (Groovy):
// CHANGE 'your.package' TO YOUR ACTUAL PLUGIN PACKAGE
relocate 'net.kyori', 'your.package.libs.kyori'
Gradle Kotlin (inside shadowJar):
Code (Kotlin):
// CHANGE 'your.package' TO YOUR ACTUAL PLUGIN PACKAGE
relocate ( "net.kyori", "your.package.libs.kyori" )
[HR][/HR]
⚡ Usage
Code (Java):
// 1. Parse Mixed Formats to Adventure Component (Paper)
// Input: MiniMessage + Legacy + Hex
Component component = ColorizeAPI. parseLegacy ( "<gradient:gold:yellow>Hello</gradient> &7World! &#ff0000(Red)" ) ;
player. sendMessage (component ) ;
// 2. Parse Mixed Formats to Legacy String (Spigot)
String legacyText = ColorizeAPI. parseHEX ( "<green>Server</green> status: &#00ff00Online" ) ;
// Output: §aServer§r status: §x§0§0...Online
Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

ColorizeAPI is a free Minecraft Java mod. Compatible with Minecraft 1.16, 1.17, 1.18, 1.19 and newer. Downloaded 19 times (via Spigot). Download it and open it directly in the game.

Explore more