# **[DISCORD](https://discord.gg/9CDfXKveFf)** | **[WIKI](https://coronas-studios.gitbook.io/coronas-studios/crownpunishments/overview)**
# **概述**
CrownPunishments 是一个全面且现代化的惩罚系统，旨在为服务器管理员和版主提供对玩家纪律的完全控制。 借助直观的 GUI、广泛的配置选项和强大的功能，例如软禁、玩家冻结和详细的惩罚历史记录，CrownPunishments 是维护服务器秩序的一体化解决方案。 它充满热情和精确地开发，旨在对工作人员来说既用户友好，又对服务器所有者来说强大。
# **核心功能**
- **直观的 GUI 系统：** 通过干净、易于导航的菜单管理所有惩罚。
- 主惩罚菜单
- 禁令、静音、软禁、踢出、警告和冻结的详细菜单
- 带预设和自定义输入的计时选择器菜单
- 带分页的综合惩罚历史记录菜单
- ️**多种惩罚类型：**
- **禁令：** 标准玩家禁令。
- **静音：** 限制玩家聊天。
- **踢出：** 将玩家从服务器中移除。
- **警告：** 向玩家发出正式警告。
- **软禁：** 限制玩家的特定命令（可配置）。玩家在线。
- **冻结：** 完全使玩家静止，阻止命令/聊天（对于非版主），并防止互动。 冻结期间断开连接可能会触发可配置的操作（例如，自动禁令）。
- ⌨️ **直接命令替代方案：** 所有惩罚类型的快速命令 (`/punish`, `/softban`, `/freeze`, `/unpunish`) 镜像 GUI 功能。
- ⚙️ **高度可配置：**
- 自定义几乎所有消息 (`messages.yml`)。
- 定义禁令、静音等的外部命令 (`config.yml`)。
- 按照您的意愿修改所有菜单（项目、插槽、名称、lore、操作 - `menus/*.yml`）。
- 配置各种操作的声音。
- 设置特定的时间单位 (s, m, h, d, y)。
- 详细的数据库配置（支持 SQLite 和 MySQL）。
- 高级冻结机制（断开连接命令、定期操作）。
- **操作后钩子：** 在应用惩罚或解除惩罚后执行一系列自定义操作（命令、消息、声音等）！
- **详细的惩罚历史记录：** 跟踪每次惩罚和解除惩罚，包括原因、惩罚者、时间戳和持续时间。 可以通过 GUI 在游戏中查看。
- **PlaceholderAPI 支持：** 通过 PAPI 占位符显示惩罚信息（例如，软禁状态、剩余时间、惩罚计数）。
- **数据库支持：** 在数据存储中选择 SQLite（基于文件，默认）或 MySQL。
# **为什么选择 CrownPunishments？**
- **一站式解决方案：** 将多个惩罚插件的功能合并到一个无缝的软件包中。
- **工作人员友好：** GUI 使即使是不太有经验的工作人员也能轻松地进行管理，而高级用户可以利用直接命令。
- **极高的可定制性：** 从简单的消息更改到复杂的菜单项目操作和操作后钩子，使其真正成为您的作品。
- **专注于现代管理：** 诸如冻结和详细软禁之类的功能提供了处理困难情况的先进工具。
- **有支持：** **[通过 Discord!](https://discord.gg/9CDfXKveFf)**
# **命令**
- **/crown** - 基础命令。
- `/crown punish [type] [time] [reason]` - 打开惩罚菜单或直接惩罚。
- `/crown unpunish ` - 删除特定的惩罚。
- `/crown reload` - 重新加载插件配置。
- `/crown help` - 显示帮助消息。
- **/punish [type] [time] [reason]** - `/crown punish` 的别名。
- **/unpunish ** - 删除惩罚的别名命令。
- **/softban [time] [reason]** - 应用软禁的别名命令。
- **/freeze [reason]** - 冻结玩家的别名命令。
## **依赖项**
- **PlaceholderAPI** (可选) - 用于使用 [此处](https://coronas-studios.gitbook.io/coronas-studios/placeholders) 列出的占位符。
# **配置**
CrownPunishments 通过多个 YAML 文件提供了广泛的配置选项：
- **config.yml:** 主设置、前缀、数据库、外部惩罚命令、声音、时间单位、软禁/冻结机制和操作后钩子。
- **messages.yml:** 所有用户可见的消息、提示和菜单文本组件。
- **menus/punish_menu.yml:** 主惩罚选择菜单的配置。
- **menus/punish_details_menu.yml:** 每个特定惩罚详细信息菜单（禁令、静音等）的配置。
- **menus/time_selector_menu.yml:** 计时选择 GUI 的配置。
- **menus/history_menu.yml:** 惩罚历史 GUI 的配置。
您可以自定义每张菜单中每个项目的材料、名称、lore、插槽、玩家头像、自定义模型数据，甚至是在单击时执行的操作（命令、声音、打开其他菜单等）！ `config.yml` 中的操作后钩子对于与其他插件集成或发送自定义通知特别强大。
**更详细的文档可以在这里找到：**
**➡️ [点击转到 GitBook](https://coronas-studios.gitbook.io/coronas-studios/crownpunishments/overview) ⬅️**
### **安装**
1. 下载 `CrownPunishments.jar` 文件。
2. 将 JAR 文件放入服务器的 `plugins` 文件夹中。
3. 重新启动或重新加载您的服务器。 (对于初始设置，建议重新启动)。
4. 通过编辑 `plugins/CrownPunishments` 文件夹中生成的 YAML 文件来配置插件以满足您的需求。
5. 使用 `/crown reload` 应用配置更改（某些更改可能仍然需要重新启动）。
