# LuckPrefix
LuckPrefix 是一个现代、简约的 Minecraft 插件，用于管理和显示玩家前缀和组。它设计清晰且灵活，允许您通过简单的 YAML 配置文件设置自定义前缀、后缀、名称颜色和显示格式。
---
## 特性
- **基于组的前缀** – 轻松分配和管理玩家的组别前缀。
- **可定制的格式** – 为每个组定义您自己的前缀、后缀、名称颜色和显示格式。
- **渐变 & 十六进制支持** – 使用 MiniMessage 渐变和自定义十六进制代码实现前缀样式。
- **排序系统** – 通过 `sortID` 控制组顺序（数字越小，优先级越高）。
- **MiniMessage 格式** – 使用 [MiniMessage](https://docs.adventure.kyori.net/minimessage/format.html) 进行高级颜色、渐变和样式定制。
- **轻量级** – 最小的性能影响和易于维护。
- **直观的配置** – 所有组设置在一个清晰的文件中。
- **PlaceholderAPI 集成**
- 在 groups.yml 中使用来自其他插件的占位符
- 我们的占位符
- %luckprefix_prefix%
- %luckprefix_suffix%
- %luckprefix_tabformat%
- %luckprefix_chatformat%
- %luckprefix_sortid%
- %luckprefix_namecolor%
---
## 安装
1. 下载 LuckPrefix。
2. 将 `LuckPrefix.jar` 文件放入服务器的 `plugins` 目录中。
3. **重启**你的服务器，**不要重新加载**。
---
## 配置
LuckPrefix 在其数据文件夹中使用 `groups.yml` 文件进行组定义。
### 示例 `groups.yml`
```yaml
groups:
admin:
prefix: '[Admin]'
suffix: ''
namecolor: 'RED'
sortID: 1
tabformat: ''
chatformat: ' » '
moderator:
prefix: '[Mod] '
suffix: ''
namecolor: 'AQUA'
sortID: 2
tabformat: ''
chatformat: ' » '
vip:
prefix: '[VIP]'
suffix: ''
namecolor: 'GRAY'
sortID: 3
tabformat: ''
chatformat: ' » '
customhex:
prefix: '<#33ccff>[HexTag]'
suffix: ''
namecolor: 'GRAY'
sortID: 10
tabformat: ''
chatformat: ' » '
default:
prefix: '[Player] '
suffix: ''
namecolor: 'WHITE'
sortID: 100
tabformat: ''
chatformat: ' » '
```
#### 占位符
- ``: 替换为组前缀。
- ``: 替换为组后缀。
- ``: 玩家的名称。
- ``: 玩家的聊天消息（仅用于 `chatformat`）。
#### 其他键
- **namecolor:** 玩家名称的颜色（RED, GRAY, BLUE）。
- **sortID:** 数字越小，优先级越高。如果玩家同时属于两个组，则 `sortID: 1` 的组将优先于 `sortID: 100` 的组。
---
## 贡献
欢迎贡献。请在 [GitHub](https://github.com/ezTxmMC/LuckPrefix) 上提交问题或拉取请求。
---
## 许可
LuckPrefix 采用 MIT 许可协议。