HyChatColor

Hytale Color API 🎨

一个轻量级、高效的库，专为 Hytale 模组开发者设计，可轻松为聊天消息着色。此 API 自动将标准的 Minecraft 风格颜色代码（例如 &a、&e、&c）解析为 Hytale 原生的 Message 对象。

✨ 功能

• 支持所有标准的 Minecraft 颜色代码（&0 - &f）。
• 支持消息重置代码（&r）。
• 完全兼容 Hytale 的 Message API。
• 实现极其简单，性能卓越。

🚀 安装

请根据您的构建系统按照以下步骤将库包含到您的项目中。

Maven

将仓库和依赖项添加到您的 pom.xml 中：

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

<dependencies>
    <dependency>
        <groupId>com.github.BartuAbiHD</groupId>
        <artifactId>hytale-color-api</artifactId>
        <version>v1.0.0</version>
    </dependency>
</dependencies>

Gradle (Groovy)

将其添加到您的 build.gradle 中：

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        mavenCentral()
        maven { url 'https://jitpack.io' }
    }
}

dependencies {
   implementation 'com.github.BartuAbiHD:hytale-color-api:v1.0.0'
}

Gradle (Kotlin DSL)

将其添加到您的 build.gradle.kts 中：

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        mavenCentral()
        maven { url = uri("https://jitpack.io") }
    }
}

dependencies {
   implementation("com.github.BartuAbiHD:hytale-color-api:v1.0.0")
}

📖 使用示例

只需调用 ChatColor.parse() 方法，即可将包含颜色代码的字符串转换为 Hytale Message 对象。

import me.bartuabihd.hytaleutils.ChatColor;
import com.hypixel.hytale.server.core.universe.PlayerRef;

public class MyMod {
    public void welcomePlayer(PlayerRef player) {
        // 使用 & 代码创建彩色字符串
        String text = "&d[服务器] &a欢迎来到服务器，&e" + player.getName() + "!";

        // 解析并作为 Hytale Message 对象发送
        player.sendMessage(ChatColor.parse(text));
   }
}

🤝 贡献

欢迎贡献！请随时提交拉取请求或通过问题选项卡报告错误。