# 🌈 MatrixColorAPI
**MatrixColorAPI** 是一个强大的、灵活的库，用于处理和应用 Minecraft 服务器中的自定义颜色、渐变和文本装饰。它支持十六进制颜色、旧的 Minecraft 颜色代码，以及诸如渐变和纯色等更高级的格式化。
这个库简化了颜色管理，同时让开发者能够轻松地构建具有漂亮格式的文本！
## ✨ 特性
- 🎨 **十六进制和旧颜色代码支持**
- 🌈 **渐变**: 在文本上应用平滑的颜色过渡。
- 🟡 **纯色**: 轻松将静态颜色应用于任何文本。
- 🖋️ **文本装饰**: 支持粗体、斜体、下划线、划线和伪装文本样式。
- 🚀 **轻量级**: 对性能的影响最小。
- 🔄 **易于使用**: 干净简洁的 API，方便集成到您的项目中。
- 🌍 **支持所有服务器软件**: 兼容 Spigot、Paper、Bukkit、Minestom、Fabric 等。
- 🕹️ **适用于所有 Minecraft 版本，从 1.16.5 开始**。
- 🛠️ **开放贡献**: 采用 Apache 2.0 许可协议，供开放贡献、修改和商业使用！
## 🚀 快速开始
> 虽然 **MatrixColorAPI** 被设计成适用于所有 Minecraft 服务器软件，但目前它仅在 Bukkit 平台上进行了广泛测试。我们鼓励其他平台的用户尝试使用它并报告遇到的任何问题。您的反馈对于使 MatrixColorAPI 具有普遍兼容性至关重要！
### 安装
MatrixColorAPI 托管在 [Jitpack](https://jitpack.io)，使其易于集成到您的 Maven 或 Gradle 项目中。请按照以下步骤将其添加到您的项目中：
### 使用 Gradle
1. **将 Jitpack 仓库添加到**您的 `build.gradle` 文件中（在 `repositories` 块中）：
```gradle
repositories {
maven { url 'https://jitpack.io' }
}
```
2. **在 `dependencies` 块中**添加依赖项：
```gradle
dependencies {
implementation 'com.github.MatrixCreations:MatrixColorAPI:v1.0.7'
}
```
### 使用 Maven
1. **将 Jitpack 仓库添加到**您的 `pom.xml` 中：
```xml
jitpack.io
https://jitpack.io
```
2. **在 `dependencies` 块中**添加依赖项：
```xml
com.github.MatrixCreations
MatrixColorAPI
v1.0.7
```
### 附加信息
- 了解最新的版本，请向上滚动。
- 确保您使用 Java 16 或更高版本以避免兼容性问题。
### 示例用法
- **纯色示例：**
```java
String text = "This is yellow text";
String processed = MatrixColorAPI.process(text);
```
- **渐变示例：**
```java
String gradientText = "This is a red to yellow gradient";
String processedGradient = MatrixColorAPI.process(gradientText);
```
- **旧代码支持：**
```java
String legacyText = "&aThis is a green text with &lBOLD";
String processedLegacy = MatrixColorAPI.process(legacyText);
```
- **十六进制代码支持：**
```java
String hexText = "&#FFD700This is a yellow text with &lBOLD";
String processedLegacy = MatrixColorAPI.process(hexText);
```
## 🛠️ 可用的方法
- `process(String text)`: 处理单个字符串的颜色代码、渐变和格式。
- `process(List texts)`: 处理字符串列表的颜色代码和格式。
## 📦 贡献
我们欢迎贡献！ 开始方法如下：
1. 分叉该存储库。
2. 为您的功能或错误修复创建一个新分支。
3. 提交一个带有清晰说明的拉取请求，说明您的更改。
请务必遵循编码标准并在适当的情况下包含测试。
## 📝 许可证
本项目采用 **Apache 2.0 许可证**。 详情请参阅 [LICENSE](https://github.com/MatrixCreations/MatrixColorAPI/blob/master/LICENSE.txt) 文件。
## 📢 鸣谢
感谢所有为这个项目做出贡献的人！ 您的支持和反馈有助于使 **MatrixColorAPI** 变得更好。
## 👥 联系方式
如果您有任何问题或反馈，请随时打开一个 issue 或在我们的 [discord 服务器](https://discord.gg/B4QsfUrdUR) 上联系我们。