# TierTagger 插件
一个用于在 Minecraft 中显示玩家等级的插件，它来自 MCTiers（非巴西等级榜）和 South Tiers API（巴西等级榜），具有高级缓存、多语言支持和 PlaceholderAPI 集成。
## 功能
- **双 API 支持**: 兼容 MCTiers 和 South Tiers API
- **缓存**: 高效的本地缓存系统，以减少 API 调用
- **多语言支持**: 英语 (en_us) 和葡萄牙语 (pt_br) 语言文件
- **PlaceholderAPI 集成**: 其他插件（例如 TAB）的广泛占位符支持
- **可配置的显示**: 可定制的等级颜色，支持渐变
- **权限系统**: 可定制的权限设置，适用于 LuckPerms
- **实时更新**: 自动获取等级并在玩家加入时显示
## 安装
1. 从发布页面下载最新版本
2. 将 JAR 文件放入服务器的 `plugins` 文件夹
3. 重启服务器
4. 在 `plugins/TierTagger/config.yml` 中配置插件
5. 使用 `/tt reload` 重新加载配置文件
## 配置
### API 配置
```yaml
api:
provider: MCTIERS # MCTIERS 或 SOUTH_TIERS
default_gamemode: vanilla
timeout: 10
cache_duration: 30
```
### 显示配置
```yaml
display:
enabled: true
format: "{tier} | {player}"
show_in_tablist: true
show_in_chat: true
```
### 语言配置
```yaml
language: en_us # en_us 或 pt_br
```
### 颜色配置
```yaml
tier_colors:
ht1:
start: "#FF0000" # Start = 渐变的开始颜色
end: "#A60000" # End = 渐变的结束颜色
lt1:
start: "#FF3200"
end: "#FF5E37"
ht2:
start: "#C4FF00"
end: "#8DB800"
lt2:
start: "#0DFF00"
end: "#08A800"
ht3:
start: "#FFE200"
end: "#CCB500"
lt3:
start: "#00FFAB"
end: "#00BAA9"
ht4:
start: "#00B2FF"
end: "#0074A6"
lt4:
start: "#5500FF"
end: "#3B00B0"
ht5:
start: "#D47410"
end: "#AD6214"
lt5:
start: "#916231"
end: "#704518"
```
## 指令
- `/tier ` - 检查玩家等级信息
- `/display` - 切换你的等级显示
- `/tieroff` - 全局禁用等级系统 (仅限管理员)
- `/tierhide` - 隐藏你的等级，所有人不可见
- `/tiertagger reload` - 重新加载插件配置
## 权限
- `tiertagger.reload` - 允许重新加载插件配置
- `tiertagger.tiersearch` - 允许搜索玩家等级
- `tiertagger.display` - 允许切换你的等级显示 (你无法看到其他玩家的等级)
- `tiertagger.tierhide` - 允许隐藏你的等级，所有人不可见
- `tiertagger.admin` - TierTagger 的管理权限
## PlaceholderAPI 占位符
### 一般占位符
- `%tiertagger_tier%` - 玩家最佳等级
- `%tiertagger_tier_formatted%` - 带有格式的玩家最佳等级
- `%tiertagger_points%` - 玩家总积分
- `%tiertagger_overall%` - 玩家总排名
- `%tiertagger_region%` - 玩家区域
### 游戏模式特定占位符
- `%tiertagger_vanilla%` - 香草等级
- `%tiertagger_sword%` - 剑等级
- `%tiertagger_pot%` - 药水等级
- `%tiertagger_uhc%` - UHC 等级
- `%tiertagger_axe%` - 斧等级
- `%tiertagger_nethop%` - 凋零领主等级
- `%tiertagger_mace%` - 钉等级
- `%tiertagger_smp%` - SMP 等级
- `%tiertagger_crystal%` - 晶等级
### 等级特定占位符
- `%tiertagger_ht1%` - 如果玩家拥有高等级 1，则返回 "HT1"
- `%tiertagger_lt1%` - 如果玩家拥有低等级 1，则返回 "LT1"
- 以及其他所有等级 (HT2, LT2, HT3, LT3, HT4, LT4, HT5, LT5) 的相应占位符
## API 支持
### MCTiers API
- 使用 UUID 查找
- 支持所有游戏模式（香草、剑、药水、UHC、斧、凋零领主、钉、SMP）
- 提供详细的统计信息，包括积分、总排名和区域
### South Tiers API
- 使用 Cracked 查找
- 主要支持晶等级模式
## 要求
- Java 17 或更高版本
- Minecraft 服务器 1.21.1+
- Paper/Spigot 服务器
- PlaceholderAPI (可选)