ColorizeAPI
A lightweight and universal text formatter for Minecraft.
Seamlessly mix MiniMessage, Legacy (&), and HEX (&#RRGGBB) colors in a single string.
Requirements
[HR][/HR]
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
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>
<repository>
<id>jitpack.io </id>
<url>https://jitpack.io </url>
</repository>
</repositories>
Code (Groovy):
repositories
{
mavenCentral ( )
maven { url 'https://jitpack.io' }
}
mavenCentral ( )
maven { url 'https://jitpack.io' }
}
Code (Kotlin):
repositories
{
mavenCentral ( )
maven { url = uri ( "https://jitpack.io" ) }
}
mavenCentral ( )
maven { url = uri ( "https://jitpack.io" ) }
}
Maven (pom.xml):
Code (XML):
<dependency>
<groupId>com.github.Klaidi4YT </groupId>
<artifactId>ColorizeAPI </artifactId>
<version>1.0 </version>
</dependency>
<groupId>com.github.Klaidi4YT </groupId>
<artifactId>ColorizeAPI </artifactId>
<version>1.0 </version>
</dependency>
Code (Groovy):
dependencies
{
implementation 'com.github.Klaidi4YT:ColorizeAPI:1.0'
}
implementation 'com.github.Klaidi4YT:ColorizeAPI:1.0'
}
Code (Kotlin):
dependencies
{
implementation ( "com.github.Klaidi4YT:ColorizeAPI:1.0" )
}
implementation ( "com.github.Klaidi4YT:ColorizeAPI:1.0" )
}
⚠️ 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>
<relocation>
<pattern>net.kyori </pattern>
<shadedPattern>your.package.libs.kyori </shadedPattern>
</relocation>
</relocations>
Code (Groovy):
// CHANGE 'your.package' TO YOUR ACTUAL PLUGIN PACKAGE
relocate 'net.kyori', 'your.package.libs.kyori'
relocate 'net.kyori', 'your.package.libs.kyori'
Code (Kotlin):
// CHANGE 'your.package' TO YOUR ACTUAL PLUGIN PACKAGE
relocate ( "net.kyori", "your.package.libs.kyori" )
relocate ( "net.kyori", "your.package.libs.kyori" )
⚡ 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: �ff00Online" ) ;
// Output: §aServer§r status: §x§0§0...Online
// 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: �ff00Online" ) ;
// Output: §aServer§r status: §x§0§0...Online
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.16, 1.17, 1.18
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
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.