## hReport - 高级玩家举报系统，带 Discord 和数据库集成
**厌倦了通过笨拙的命令或外部表单来管理玩家举报吗？ 通过 hReport\! 简化您服务器的审核工作\!**
hReport 是一个高级、高度可配置的玩家举报系统，专为 **Spigot & Paper** 服务器（1.16+）设计。 允许玩家直接在游戏中轻松举报可疑行为、违反规则或其他问题。 审核人员可以使用强大的 **Discord 集成** 或游戏内命令高效地管理这些报告，并可以选择将所有内容记录到 **MySQL 数据库** 中。
hReport 考虑了性能和易用性，旨在成为服务器社区的综合、**免版税** 解决方案。
### 主要功能：
* **简单的游戏内举报：** 玩家可以使用直观的 `/report [reason] [proof_url]` 命令。 举报原因和证明 URL（例如，图片/视频链接）是可选的，但鼓励提供。
* **即时 Discord 通知：** 立即在指定的 Discord 频道收到详细报告。 不再错过任何报告了\!
* **丰富的嵌入信息：** Discord 嵌入包含：
* 举报玩家和目标玩家（带 UUID）
* 举报原因和可选的证明链接
* 时间戳
* 可配置的目标玩家最近的聊天消息数量，以提供上下文。
* 举报状态（待处理、已处理、无效）
* **交互式 Discord 管理：** 员工可以使用报告嵌入上的交互式按钮，直接在 Discord 中管理报告：
* 快速将报告标记为有效或无效。
* 启动处罚程序（可配置）。
* **通过 Discord 执行处罚：** 在 `config.yml` 中定义服务器的处罚命令（踢出、静音、临时封禁、警告、自定义命令等）。 员工可以使用占位符 (player name, UUID, reason, staff name, and report ID) 从 Discord 直接触发这些命令，以针对被举报的玩家。
* **可选的 MySQL 数据库日志记录：** 在 config 中启用数据库支持，以保留所有报告、其状态以及处理方式的持久历史记录。 非常适合跟踪和问责制。(表会自动创建)。
* **高度可配置：** 可以定制几乎每个方面：
* 独立启用/禁用 Discord 和数据库功能。
* 在 `messages.yml` 中配置所有消息（支持颜色代码 `&`）。
* 设置 Discord Bot Token、Guild ID、Channel ID。
* 定义从 Discord 执行的所有处罚命令。
* 设置 `/report` 命令的冷却时间。
* 自定义嵌入外观（标题、描述、不同状态的颜色 - 通过 `messages.yml`）。
* **PlaceholderAPI 支持：** 在可配置的消息中使用 PAPI 占位符，以增加上下文。
* **重新加载命令：** 使用 `/hreport reload` 立即应用配置更改（需要权限）。
* **(计划中/可选) 游戏内管理：** 用于员工在 Minecraft 中列出和查看报告的命令。
* **免费使用：** 核心功能不需要许可证密钥或付款。
### 命令和权限：
* `/report [reason] [proof_url]` - 举报一名玩家。
* 权限：`hreport.report` (默认：`true`)
* `/hreport reload` - 重新加载配置文件。
* 权限：`hreport.admin` (默认：`op`)
* *(计划/未来：`/hreport list`, `/hreport view `, 等用于游戏内管理)*
* 权限：`hreport.view` (默认：`op`)
* `hreport.notify` - 允许员工在创建新报告时收到游戏内通知。 (默认：`op`)
### 依赖项：
* **必需：** [PlaceholderAPI](https://www.google.com/search?q=https://www.spigotmc.org/resources/placeholderapi.624/)