SimpleReportPlugin
一个适用于 Spigot/Paper 1.21.x 的简单轻量级玩家举报系统。玩家可以附带理由举报其他玩家,而工作人员/OP 则可以在整洁的物品栏 GUI 中查看所有举报记录,并决定对举报对象执行封禁或删除举报。
所有举报数据均持久化存储在 JSON 文件中,因此服务器重启后数据依然保留。
功能特性
- /report:玩家可以举报其他玩家(包括举报理由)
- 防垃圾举报保护
- 只要某条举报仍然存在,玩家对同一目标只能举报一次
- 全局5 分钟冷却时间:玩家每 5 分钟只能创建一条新举报
- 工作人员 GUI / 举报概览
- OP 可以通过物品栏 GUI查看举报记录
- 点击玩家头颅选择一条举报
- 通过按钮执行操作:
- 封禁(红色羊毛):封禁被举报的玩家并移除所选举报
- 删除(屏障):删除所选举报(不执行封禁)
- 关闭(红石粉):关闭 GUI
- 举报记录在服务器重启后依然保留
-
配置文件 (config.yml)
插件会在首次启动时自动生成配置文件。它允许你粘贴 Discord Webhook URL,以便在产生举报时即时将日志发送到你的 Discord 频道,并可选地启用 @特定角色或 @everyone 的通知提示。
命令
/report <player> <reason>
为指定玩家创建举报。
示例:
/report Steve Fly hacks
/report Alex Chat harassment
规则:
- 你不能举报自己
- 在举报存在期间,你不能多次举报同一玩家
- 每 5 分钟只能创建一个举报
/reports
打开举报管理 GUI。
- 默认仅限 OP(管理员) 使用 (
default: op)
- 以玩家头颅物品的形式显示每条举报,包含:
员工 GUI 使用方法
- 运行
/reports
- 点击一个头颅以选中某条举报
(纸张物品将显示 Selected: <playername>)
- 点击其中一个操作按钮:
- 封禁 (红羊毛):封禁该玩家并移除选中的举报
- 删除 (屏障):仅删除选中的举报
- 关闭 (红石粉):关闭 GUI
数据存储
- 在以下情况会自动保存举报:
- 创建举报时
- 删除举报时
- 服务器停止 / 插件禁用时
注意: 仅保存举报数据。5 分钟的冷却时间当前存储在内存中,重启服务器后会重置(举报记录仍会保留)。
兼容性
- 专为 Spigot/Paper 1.21.x 设计
- 推荐:Paper 以获得最佳性能
- Java 版本:Java 21
安装
- 将
.jar 文件放入服务器的 plugins/ 文件夹
- 启动服务器
- 当存在举报时,插件会自动创建
plugins/ReportPlugin/reports.json
支持
如果你发现 bug,请在 Discord 上添加我 Petarhrv16
SimpleReportPlugin
A simple and lightweight player report system for Spigot/Paper 1.21.x. Players can report other players with a reason, while staff/OPs can review all reports in a clean inventory GUI and decide to ban the reported player or delete the report.
All reports are stored persistently in a JSON file, so they remain available after server restarts.
Features
- /report: Players can report other players (including a reason)
- Anti-spam protection
- A player can report the same target only once as long as that report still exists
- Global 5 minute cooldown: a player can only create one new report every 5 minutes
- Staff GUI / Reports overview
- OPs can view reports in an inventory GUI
- Select a report by clicking the player head
- Actions via buttons:
- Ban (Red Wool): bans the reported player and removes the selected report
- Delete (Barrier): deletes the selected report (no ban)
- Close (Redstone): closes the GUI
- Reports stay after restart
-
Configuration (config.yml)
The plugin automatically generates a configuration file on the first startup. It allows you to paste a Discord Webhook URL to receive instant logs in your Discord channel whenever a report is made, with an optional toggle to ping a specific role or @everyone.
Commands
/report <player> <reason>
Creates a report for the given player.
Examples:
/report Steve Fly hacks
/report Alex Chat harassment
Rules:
- You cannot report yourself
- You cannot report the same player multiple times while the report exists
- You can only create one report every 5 minutes
/reports
Opens the reports GUI.
- OP only by default (
default: op)
- Shows each report as a player head item including:
- reporter
- reason
- timestamp
Staff GUI Usage
- Run
/reports
- Click a head to select a report
(the paper item will show Selected: <playername>)
- Click one of the action buttons:
- Ban (Red Wool): bans the player and removes the selected report
- Delete (Barrier): deletes the selected report only
- Close (Redstone): closes the GUI
Data Storage
- Reports are automatically saved when:
- a report is created
- a report is deleted
- the server stops / plugin disables
Note: Only reports are saved. The 5-minute cooldown is currently stored in memory and resets after server restart (reports remain saved).
Compatibility
- Designed for Spigot/Paper 1.21.x
- Recommended: Paper for best performance
- Java: Java 21
Installation
- Put the
.jar into your server plugins/ folder
- Start the server
- The plugin will automatically create
plugins/ReportPlugin/reports.json once reports exist
Support
If you find a bug add me on Discord Petarhrv16
评论 0
登录后参与评分
还没有评论,来抢沙发吧