mReports

插件

· 作者 miklires

适用于 Paper、Purpur 和 Folia 的可审计玩家举报、证据快照以及专注的审核队列。

0 本站下载 0 关注 更新于 1 个月前

最新 1.1.1 · 26.3 · Folia / Paper

一键开服(送7天)

mReports

可审计的玩家举报、证据快照以及面向 Paper、Purpur 和 Folia 的专注审核队列。

GitHub Modrinth

功能特性

  • 引导式分类 GUI 与直接命令举报。
  • 稳定的数字 ID、可搜索的历史记录、优先级设置、处理者认领、发布、备注、解决与拒绝操作。
  • 持久化的 H2 存储,支持架构迁移、异步数据库操作、重启恢复及保留清理。
  • 重复举报合并、防止自我举报、豁免目标、冷却时间以及滑动窗口速率限制。
  • 当举报被接受时,捕获有界的近期聊天证据;不记录命令和不相关的玩家数据。
  • 可选的 Discord Webhook 事件,包含严格的 HTTPS 主机验证、超时控制、有界的待处理请求以及禁用的提及功能。
  • 默认英文界面;可通过 language: ru_RU 切换至俄语。
  • 支持 Paper、Purpur 和 Folia 的任务调度,提供公开的 Bukkit Services API 以及非侵入式的 Modrinth 更新检查。

运行要求

  • Java 25
  • Paper、Purpur 或 Folia 26.3

无需经济插件、代理服务器或数据库服务器。mChat、mBans 和 PlaceholderAPI 可独立安装;mReports 可在无它们的情况下正常工作。

快速开始

  1. 将 mReports-1.1.1.jar 放入 plugins/ 目录并启动服务器。
  2. 查看 plugins/mReports/config.yml。生成的默认配置即可直接使用。
  3. 授予管理员 mreports.staff 权限,授予需要接收新举报警报的工作人员 mreports.notify 权限。
  4. 玩家可以执行 /report <player>;管理员打开 /reports。

插件在启动和重载时会验证配置的数值范围。无效值将被替换为安全默认值。现有的举报数据保留在 plugins/mReports/data/ 中。

命令

命令 用途 权限
/report <player> 打开分类 GUI mreports.use
/report <player> <category> [details] 直接提交举报 mreports.use
/myreports 查看你最近的十条提交记录 mreports.history.own
/reports 打开工作人员队列;控制台显示文本列表 mreports.staff
/reports view <id> 检查某条举报详情 mreports.staff
/reports evidence <id> 读取其存储的聊天快照 mreports.staff
/reports claim <id> / release <id> 分配或释放处理者 mreports.staff
/reports priority <id> <low|normal|high|urgent> 更改优先级 mreports.staff
/reports note <id> <text> 添加审计备注 mreports.staff
/reports resolve <id> [note] / reject <id> [note] 关闭举报 mreports.staff
/reports search <text> 搜索 ID、玩家、分类和详情 mreports.staff
/reports history <player> 查看涉及缓存玩家的举报 mreports.staff
/reports reload 验证并重载配置 mreports.reload

其他权限包括 mreports.notify、mreports.exempt 和 mreports.bypass.cooldown。

配置

默认分类为 CHEATING(作弊)、CHAT(聊天)、TEAMING(组队)、GRIEFING(破坏)和 OTHER(其他)。最多支持 32 个唯一分类。提交长度、冷却时间、重复举报窗口、滑动举报限制、已关闭举报的保留时间以及所有证据内存界限均可配置。

Discord 推送默认处于关闭状态。设置 discord.enabled: true 并提供 Discord HTTPS /api/webhooks/... URL。该 URL 绝不会打印到日志中。更新检查仅报告存在更新的 Modrinth 版本;它不会下载或安装任何文件。

指标统计默认保持禁用,直到 mReports 获得自己的公开 bStats 项目 ID。

存储与隐私

本地 H2 数据库存储玩家 UUID 和名称、举报文本、工作人员备注、状态变更及审计事件。启用后,被举报玩家的近期公共聊天将保存在有界内存中,并复制到已接受的举报中。它不捕获命令、物品栏数据、IP 地址、图片或视频。请根据服务器的隐私政策设置保留时间和证据限制。

API 与构建

其他插件可以通过 Bukkit 的 Services Manager 获取 MReportsApi,以提交、查找、搜索和列出举报。API 方法返回 CompletableFuture 值,禁止在服务端线程上同步阻塞等待结果。

./gradlew clean build

可分发的 JAR 包位于 build/libs/mReports-1.1.1.jar;独立的 API 构件位于 api/build/libs。

报告问题 · 查看源码 · 加入 Discord

本软件依据 MIT License 授权。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源