Player Report - 玩家举报系统

PlayerReport 是一款现代化的游戏内玩家举报系统，专为服务器管理团队设计。它允许玩家轻松举报违规行为，同时为管理员提供直观的 GUI 界面，直接在游戏内审查、筛选和处理举报，极大地提升了管理效率。

💡核心特性

• 现代化游戏内举报系统：提供完整的举报工作流。
• 便捷的玩家举报：通过 /report 命令快速举报。
• 可选的举报理由 GUI 与确认系统：引导玩家完成举报。
• 高级管理 GUI：管理员可在游戏内处理所有举报。
• 举报处理人分配：可将举报分配给特定管理员处理。
• 游戏内筛选与排序：高效处理大量举报。
• 传送功能：可传送至被举报玩家或举报发生时的位置。
• 举报奖励系统：对有效的举报给予玩家奖励。
• 在线与离线奖励领取：支持玩家离线时存储奖励，通过 /reports claim 领取。
• Discord 集成：通过 Webhook 将举报动态同步至 Discord。
• PlaceholderAPI 支持：提供丰富的统计数据占位符。
• 多种存储支持：支持 YAML 文件或 MySQL 数据库存储。
• 搜索功能：可按玩家、举报 ID、理由或处理人进行搜索。
• 管理员通知系统：新举报时实时通知在线管理员。
• 自动清理：可自动清理旧的举报记录。
• 高度可配置：几乎所有消息、GUI 和行为均可通过配置文件调整。
• 轻量且高性能：代码经过优化，对服务器性能影响极小。
• Folia 支持：兼容 Folia 核心服务器。

工作流程简介

举报信息会显示在一个完全可配置的 GUI 界面中。管理员可以：

• 审查举报详情
• 更改举报状态
• 分配处理人
• 传送至相关玩家（举报者与被举报者）
• 删除举报

玩家在其举报被确认后，可以选择性地获得奖励。奖励系统支持：

• 指令奖励（可与其他插件联动，如发放投票钥匙）
• 物品奖励
• 离线奖励存储
• 通过 /reports claim 领取奖励

🎮指令列表

玩家指令

• /report <player> <reason> - 举报一名玩家。

- 权限：`playerreport.report`

管理指令

• /reports - 打开举报管理 GUI。

- 权限：`playerreport.admin`

• /reports help - 显示所有可用指令。

- 权限：`playerreport.admin`

• /reports search user <player> - 搜索由特定玩家创建或针对该玩家的举报。

- 权限：`playerreport.admin`

• /reports search id <reportId> - 通过唯一 ID 查找举报。

- 权限：`playerreport.admin`

• /reports search reason <text> - 搜索包含特定理由的举报。

- 权限：`playerreport.admin`

• /reports search handler <player> - 显示分配给特定管理员的举报。

- 权限：`playerreport.admin`

• /reports sethandler <reportId> <player|none> - 为举报分配或移除处理人。

- 权限：`playerreport.admin.handler.set`

• /reports clear - 清理过期或已删除的举报。

- 权限：`playerreport.admin.clear`

• /reports claim - 领取已确认举报的奖励。

- 权限：`playerreport.claim`

• /reports on - 启用举报通知。

- 权限：`playerreport.admin.notify.toggle`

• /reports off - 禁用举报通知。

- 权限：`playerreport.admin.notify.toggle`

• /reports reload - 重载插件配置文件。

- 权限：`playerreport.reload`

✨权限节点

• playerreport.* - 授予所有 PlayerReport 权限。
• playerreport.report - 允许玩家使用 /report 创建举报。
• playerreport.bypass.cooldown - 绕过举报冷却时间。
• playerreport.immune - 使玩家免疫被举报。
• playerreport.admin - 允许访问管理 GUI (/reports)。
• playerreport.admin.handler.set - 允许分配或移除举报处理人。
• playerreport.admin.clear - 允许使用 /reports clear 清理举报。
• playerreport.admin.notify.toggle - 允许使用 /reports on/off 切换通知。
• playerreport.reload - 允许使用 /reports reload 重载配置。
• playerreport.update.notify - 当插件有更新时接收通知。
• playerreport.claim - 允许玩家领取举报奖励。

🔧配置摘要 (config.yml)

以下为 config.yml 主要配置项的概述：

举报设置 (`reporting`)

• requireOnlineTarget：是否要求被举报玩家必须在线。
• maxOpenReportsPerReporter：单个举报者同时可拥有的最大未处理举报数。
• cooldownSeconds：创建举报的冷却时间（秒）。
• reasonMode：举报理由模式 (FREETEXT, PREDEFINED, BOTH)。
• predefinedReasons：预定义的举报理由列表。
• reasonGui：可配置的理由选择 GUI 和确认 GUI。

存储设置 (`storage`)

• reports.type：举报存储类型 (YAML 或 MYSQL)。
• pendingRewards.type：待领取奖励存储类型 (YAML 或 MYSQL)。
• mysql：MySQL 数据库连接配置。

奖励系统 (`rewards`)

• enabled：是否启用奖励系统。
• simpleReportHandling：简化处理模式，举报关闭时自动发放奖励。

Discord 集成 (`discord`)

• webhook.enabled：是否启用 Discord Webhook。
• webhook.url：Webhook URL。
• events：控制哪些事件触发 Webhook 通知。

管理 GUI (`GUI`)

• 可配置 GUI 标题、大小、筛选项、排序项、导航按钮和举报条目显示样式。
• gui.defaultFilter：默认筛选器 (OPEN, CLOSED, DELETED)。
• gui.defaultSort：默认排序方式 (NEWEST, OLDEST 等)。

🔧语言文件摘要 (lang.yml)

lang.yml 文件包含了插件所有面向玩家的消息、GUI 标题、物品名称和描述（Lore），支持颜色代码和 HEX 颜色。你可以完全自定义这些文本以适应服务器风格。

⭐PlaceholderAPI 占位符

安装 PlaceholderAPI 后，可使用以下占位符：

• %playerreport_reports_total% - 服务器上存储的举报总数。
• %playerreport_reports_open% - 当前未处理举报数。
• %playerreport_reports_in_progress% - 正在处理中的举报数。
• %playerreport_reports_closed% - 已关闭的举报数。
• %playerreport_reports_deleted% - 已删除的举报数。
• %playerreport_reports_created% - 指定玩家创建的举报数。
• %playerreport_reports_against% - 针对指定玩家的举报数。
• %playerreport_reports_handled% - 指定玩家（作为管理员）处理的举报数。
• %playerreport_reports_open_for_player% - 指定玩家创建的未处理举报数。
• %playerreport_reports_handled_open% - 分配给指定玩家处理的未处理举报数。

❓支持与反馈

请勿因遇到的问题直接给予差评。

如果你遇到任何问题，请通过插件页面的私信 (PM)、讨论区 (Discussion) 或 Discord 服务器与我联系。感谢你的理解与支持！