mReports
可审计的玩家举报、证据快照以及面向 Paper、Purpur 和 Folia 的专注审核队列。
功能特性
- 引导式分类 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 可在无它们的情况下正常工作。
快速开始
- 将
mReports-1.1.1.jar 放入 plugins/ 目录并启动服务器。
- 查看
plugins/mReports/config.yml。生成的默认配置即可直接使用。
- 授予管理员
mreports.staff 权限,授予需要接收新举报警报的工作人员 mreports.notify 权限。
- 玩家可以执行
/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 授权。
mReports
Auditable player reports, evidence snapshots, and a focused moderation queue for Paper, Purpur, and Folia.
Features
- Guided category GUI and direct command reports.
- Stable numeric IDs, searchable history, priorities, handler claiming, release, notes, resolve and reject actions.
- Persistent H2 storage with schema migration, asynchronous database work, restart recovery and retention cleanup.
- Duplicate merging, self-report prevention, exempt targets, cooldowns and rolling-window rate limits.
- Bounded recent-chat evidence captured when a report is accepted; commands and unrelated player data are not recorded.
- Optional Discord webhook events with strict HTTPS host validation, timeouts, bounded pending requests and disabled mentions.
- English interface by default; switch to Russian with
language: ru_RU.
- Paper, Purpur and Folia scheduling support, public Bukkit Services API and a non-invasive Modrinth update check.
Requirements
- Java 25
- Paper, Purpur or Folia 26.3
No economy, proxy or database server is required. mChat, mBans and PlaceholderAPI may be installed independently; mReports works without them.
Quick start
- Put
mReports-1.1.1.jar in plugins/ and start the server.
- Review
plugins/mReports/config.yml. The generated defaults are ready to use.
- Grant
mreports.staff to moderators and mreports.notify to staff who should receive new-report alerts.
- Players can run
/report <player>; moderators open /reports.
The plugin validates configured ranges on startup and reload. Invalid values are replaced with safe defaults. Existing report data remains in plugins/mReports/data/.
Commands
| Command |
Purpose |
Permission |
/report <player> |
Open the category GUI |
mreports.use |
/report <player> <category> [details] |
Submit directly |
mreports.use |
/myreports |
View your ten latest submissions |
mreports.history.own |
/reports |
Open the staff queue; text list in console |
mreports.staff |
/reports view <id> |
Inspect a report |
mreports.staff |
/reports evidence <id> |
Read its stored chat snapshot |
mreports.staff |
/reports claim <id> / release <id> |
Assign or release a handler |
mreports.staff |
/reports priority <id> <low|normal|high|urgent> |
Change priority |
mreports.staff |
/reports note <id> <text> |
Add an audit note |
mreports.staff |
/reports resolve <id> [note] / reject <id> [note] |
Close a report |
mreports.staff |
/reports search <text> |
Search IDs, players, categories and details |
mreports.staff |
/reports history <player> |
View reports involving a cached player |
mreports.staff |
/reports reload |
Validate and reload configuration |
mreports.reload |
Additional permissions are mreports.notify, mreports.exempt, and mreports.bypass.cooldown.
Configuration
The default categories are CHEATING, CHAT, TEAMING, GRIEFING, and OTHER. Up to 32 unique categories are supported. Submission length, cooldown, duplicate window, rolling report limit, closed-report retention and all evidence memory bounds are configurable.
Discord delivery is off by default. Set discord.enabled: true and provide a Discord HTTPS /api/webhooks/... URL. The URL is never printed to logs. Update checks only report that a newer Modrinth version exists; they never download or install files.
Metrics remain disabled until mReports receives its own public bStats project ID.
Storage and privacy
The local H2 database stores player UUIDs and names, report text, staff notes, status changes and audit events. When enabled, recent public chat from the reported player is held in bounded memory and copied into an accepted report. It does not capture commands, inventory data, IP addresses, images or video. Set retention and evidence limits to match your server's privacy policy.
API and build
Other plugins can obtain MReportsApi from Bukkit's Services Manager to submit, find, search and list reports. API methods return CompletableFuture values and must not be synchronously joined on the server thread.
./gradlew clean build
The distributable JAR is build/libs/mReports-1.1.1.jar; the separate API artifact is in api/build/libs.
Report an issue · View source · Join Discord
Licensed under the MIT License.
评论 0
登录后参与评分
还没有评论,来抢沙发吧