# TurboBansLite
一个专为您的服务器开发的现代化、高效且易于使用的惩罚管理系统。
---
## ✨ 特性
- **全面的惩罚类型:** 永久和临时 `ban` (封禁), `mute` (静音), `ip-ban` (IP封禁) 和 `warn` (警告) 惩罚。
- **交互式 GUI:** 使用 `/turbobans <玩家>` 命令，通过交互式菜单轻松管理惩罚。
- **基于聊天的设置:** 在 GUI 中选择惩罚后，可以通过聊天对话轻松输入时长和原因。
- **数据库支持:** 所有惩罚都存储在 SQLite 数据库中，以确保服务器重启后数据不会丢失。
- **自动惩罚:** 当玩家达到一定数量的警告时，自动踢出、静音或封禁玩家。
- **详细的惩罚历史:** 使用 `/turbohistory <玩家>` 命令查看玩家的完整惩罚历史。
- **高级语言支持:** 插件中的所有消息都可通过 `messages_tr.yml` 和 `messages_en.yml` 文件进行完全自定义。
- **权限系统:** 对所有命令和功能进行详细的权限管理。
---
## 📦 安装
1. 将 `TurboBansLite-1.0-SNAPSHOT.jar` 文件拖放到服务器的 `plugins` 文件夹中。
2. 启动或重启您的服务器。
3. 您可以在 `plugins/TurboBansLite/` 目录中编辑必要的设置和语言文件。
---
## ⚙️ 配置 (`config.yml`)
`config.yml` 文件包含插件的主要设置：
- **`settings.language`:** 设置插件的默认语言 (`tr` 或 `en`)。
- **`auto-punishment`:** 根据警告数量配置自动惩罚。 例如，当玩家收到 5 个警告后静音他们 1 小时。
- **`appeals`:** 设置将在封禁/踢出屏幕上显示的申诉网站和 Discord 邀请链接。
---
## ⌨️ 命令和权限
默认情况下，所有命令仅限具有 `OP` 状态的玩家使用。
| 命令 | 描述 | 用法 | 权限 |
| ---------------------- | -------------------------------------- | ------------------------------------------- | ------------------- |
| `/turbobans <玩家>` | 为玩家打开惩罚 GUI。 | `/turbobans <玩家>` | `turbo.gui` |
| `/turboban <玩家>` | 封禁一个玩家。 | `/<命令> <玩家> [时长] [原因]` | `turbo.ban` |
| `/turbounban <玩家>` | 解封一个玩家。 | `/<命令> <玩家>` | `turbo.unban` |
| `/turbomute <玩家>` | 在聊天中静音一个玩家。 | `/<命令> <玩家> [时长] [原因]` | `turbo.mute` |
| `/turbounmute <玩家>`| 解静音一个玩家。 | `/<命令> <玩家>` | `turbo.unmute` |
| `/turbokick <玩家>` | 将玩家从服务器踢出。 | `/<命令> <玩家> [原因]` | `turbo.kick` |
| `/turbowarn <玩家>` | 警告一个玩家。 | `/<命令> <玩家> [原因]` | `turbo.warn` |
| `/turbohistory <玩家>`| 显示一个玩家的惩罚历史。 | `/<命令> <玩家>` | `turbo.history` |
| `/turbobanip `| 封禁一个 IP 地址。 | `/<命令> [时长] [原因]`| `turbo.banip` |
| `/turbounbanip ` | 解封一个 IP 地址。 | `/<命令> ` | `turbo.unbanip` |
| `/turbobans reload` | 重新加载插件的配置。 | `/turbobans reload` | `turbo.reload` |
---
## 🛡️ 其他权限
| 权限 | 描述 |
| --------------------- | ---------------------------------------------- |
| `turbo.*` | 授予插件的所有权限。 |
| `turbo.notify` | 接收有关惩罚的通知。 |
| `turbo.bypass.ban` | 绕过封禁惩罚。 |
| `turbo.bypass.mute` | 绕过静音惩罚。 |
| `turbo.bypass.kick` | 绕过踢出惩罚。 |