Package dev.oumaimaa.kawaiiapi.colors

Class ColorTranslator

java.lang.Object

dev.oumaimaa.kawaiiapi.colors.ColorTranslator

public final class ColorTranslator
extends Object

Modern utility class for translating color codes in strings to Minecraft-compatible formats. Supports legacy color codes (&), hex colors (invalid input: '&#'RRGGBB), and MiniMessage format.

Uses Adventure API exclusively for maximum compatibility with Paper 1.21+.

Version:

1.0

Author:

KawaiiDevelopment

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	ColorTranslator.ColorBuilder	Builder class for creating complex colored text using method chaining.

Method Summary

Modifier and Type	Method	Description
static @NotNull String	componentToLegacy(@NotNull net.kyori.adventure.text.Component component)	Converts a Component back to a legacy color code string.
static @NotNull String	componentToPlain(@NotNull net.kyori.adventure.text.Component component)	Converts a Component to plain text without any formatting.
static @NotNull String	miniMessageToLegacy(@NotNull String miniMessage)	Converts MiniMessage format to legacy color codes.
static @NotNull String	stripColors(@NotNull String text)	Strips all color codes and formatting from a string.
static @NotNull String	translateColorCodes(@NotNull String text)	Translates color codes and returns a legacy formatted string.
static @NotNull net.kyori.adventure.text.Component	translateMiniMessage(@NotNull String text)	Translates MiniMessage format to Adventure Component.
static @NotNull net.kyori.adventure.text.Component	translateToComponent(@NotNull String text)	Translates color codes in a string using legacy format (&) and hex colors (invalid input: '&#'RRGGBB).

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

translateToComponent

@NotNull
public static @NotNull net.kyori.adventure.text.Component translateToComponent(@NotNull
 @NotNull String text)

Translates color codes in a string using legacy format (&) and hex colors (invalid input: '&#'RRGGBB). Returns an Adventure Component for modern Paper usage.

Parameters:

text - The string containing color codes

Returns:

A Component with colors and formatting applied

translateColorCodes

@NotNull
public static @NotNull String translateColorCodes(@NotNull
 @NotNull String text)

Translates color codes and returns a legacy formatted string. Useful for compatibility with older APIs that require String format.

Parameters:

text - The string containing color codes

Returns:

A string with Minecraft color codes (§) applied

translateMiniMessage

@NotNull
public static @NotNull net.kyori.adventure.text.Component translateMiniMessage(@NotNull
 @NotNull String text)

Translates MiniMessage format to Adventure Component. Supports advanced formatting like gradients, hover events, click events, etc.

Parameters:

text - The MiniMessage formatted text

Returns:

A Component with formatting applied

stripColors

@NotNull
public static @NotNull String stripColors(@NotNull
 @NotNull String text)

Strips all color codes and formatting from a string.

Parameters:

text - The text to strip colors from

Returns:

Plain text without any formatting

componentToLegacy

@NotNull
public static @NotNull String componentToLegacy(@NotNull
 @NotNull net.kyori.adventure.text.Component component)

Converts a Component back to a legacy color code string.

Parameters:

component - The component to serialize

Returns:

Legacy formatted string

componentToPlain

@NotNull
public static @NotNull String componentToPlain(@NotNull
 @NotNull net.kyori.adventure.text.Component component)

Converts a Component to plain text without any formatting.

Parameters:

component - The component to serialize

Returns:

Plain text representation

miniMessageToLegacy

@NotNull
public static @NotNull String miniMessageToLegacy(@NotNull
 @NotNull String miniMessage)

Converts MiniMessage format to legacy color codes.

Parameters:

miniMessage - The MiniMessage text

Returns:

Legacy formatted string