EasyPlayerReport
使用 Paper 原生对话框 API 实现的游戏内玩家举报功能。没有物品栏 GUI,没有聊天刷屏:玩家填写真实表单,工作人员通过分页面板管理一切,被举报的玩家还可以提出申诉。
需要 Paper 1.21.7 或更高版本。 Dialog API 是在 Paper 1.21.7 中引入的,因此 Spigot、CraftBukkit 以及 Paper 1.21.6 或更低版本的服务器不受支持——在这些服务器上,插件会显示一条清晰的消息并自行禁用,而不会导致崩溃。
玩家端
/reportar 打开原生对话框:选择原因、描述发生的情况并提交。
- 冷却时间、每位玩家的最大活跃举报数、重复检测及虚假举报拦截。
/reportes — 你创建的所有举报或关于你的举报,包含状态和历史记录。
/apelacion <id> — 作为被举报玩家对某项举报提出申诉(每项举报仅限一次,具有可配置的冷却时间)。
工作人员端
/reportesadmin — 带有 OPEN / TAKEN / CLOSED / ALL 过滤器的分页面板。
- 接管、释放、重新分配、关闭和重新打开举报;传送至举报位置或目标玩家处。
- 举报专用聊天室(
/reportechat <id>),供举报人与指派的工作人员交流。
- 每条举报都有私人工作人员备注和完整的操作历史记录。
- 直接从举报详情中对被举报玩家执行踢出 / 警告 / 封禁,支持灵活的时间设置(
7d、12h、1d12h30m、permanent)。
- 将举报标记为虚假,并暂时阻止该举报人提交更多举报。
/reporteshistorial <player> — 查看指定用户名或 UUID 的完整历史。
/reportesestadisticas — 统计摘要。
/reportestoggle — 为每位工作人员单独静音举报提醒(重启后依然保存)。
- 在可配置时间段后自动关闭过时举报。
要求
- Paper 1.21.7 或更高版本(已在 1.21.7、1.21.11 和 26.3 上测试)
- Java 21 或更高版本
- 无需其他依赖 —— SQLite 和 MySQL 驱动由 Paper 自身下载。
命令
| 命令 |
描述 |
/reportar |
打开举报表单 |
/reportes |
查看与你相关的举报 |
/reportesadmin |
工作人员管理面板 |
/reportechat <id> |
举报专用聊天室 |
/reportestoggle |
切换举报提醒 |
/apelacion <id> |
申诉你作为被举报人的举报 |
/reporteshistorial <player> |
查看玩家的举报历史 |
/reportesestadisticas |
统计摘要 |
/easyplayerreport reload |
重载配置、消息和多语言文件 |
/easyplayerreport export <json|csv> |
导出所有举报 |
权限
| 权限 |
默认值 |
描述 |
easyplayerreport.use |
everyone |
创建和查看举报 |
easyplayerreport.staff |
op |
管理举报并传送 |
easyplayerreport.moderate |
op |
踢出、警告和封禁被举报玩家 |
easyplayerreport.falsereport |
op |
将举报标记为虚假并阻止举报人 |
easyplayerreport.admin |
op |
删除举报及使用管理功能 |
easyplayerreport.history |
op |
查看按玩家划分的历史记录 |
easyplayerreport.stats |
op |
查看统计数据 |
easyplayerreport.export |
op |
导出举报数据 |
easyplayerreport.reopen |
op |
重新打开已关闭的举报 |
easyplayerreport.appeal |
everyone |
申诉针对你的举报 |
存储
database.type 接受 sqlite(默认,存储在 plugins/EasyPlayerReport/reports.db)或 mysql。现有的 reports.yml 数据仅迁移一次,原始文件永远不会被删除;如果数据库失败,插件会回退到 YAML 格式且不会丢失任何数据。查询使用预编译语句;密码绝不会写入日志。
多语言支持
消息自带 西班牙语和英语(lang/lang_es.yml,lang/lang_en.yml),所有按钮、标签和过滤器均位于 menus.yml 中。所有冷却时间、限制、音效、药水效果、举报原因和保留规则均可在 config.yml 中配置。
EasyPlayerReport
In-game player reports using Paper's native dialog API. No inventory GUIs, no chat
spam: players fill out a real form, staff manage everything from a paginated panel, and
the reported player can appeal.
Requires Paper 1.21.7 or newer. The Dialog API was introduced in Paper 1.21.7, so
Spigot, CraftBukkit and Paper 1.21.6 or older are not supported — on those servers
the plugin disables itself with a clear message instead of breaking.
For players
/reportar opens a native dialog: pick a reason, describe what happened, submit.
- Cooldown, max active reports per player, duplicate detection and false-report blocking.
/reportes — every report you created or that is about you, with status and history.
/apelacion <id> — appeal a report where you are the reported player (once per report,
with a configurable cooldown).
For staff
/reportesadmin — paginated panel with OPEN / TAKEN / CLOSED / ALL filters.
- Take, release, reassign, close and reopen reports; teleport to the report location or
to the player.
- Private report chat (
/reportechat <id>) between the reporter and the assigned staff.
- Private staff notes and a complete action history on every report.
- Kick / warn / ban the reported player straight from the report detail, with flexible
durations (
7d, 12h, 1d12h30m, permanent).
- Mark a report as false and temporarily block the reporter from filing more.
/reporteshistorial <player> — full history for a name or UUID.
/reportesestadisticas — statistics summary.
/reportestoggle — mute report alerts per staff member (saved across restarts).
- Automatic auto-close of stale reports after a configurable period.
Requirements
- Paper 1.21.7 or newer (tested on 1.21.7, 1.21.11 and 26.3)
- Java 21 or newer
- Nothing else — SQLite and MySQL drivers are downloaded by Paper itself.
Commands
| Command |
Description |
/reportar |
Open the report form |
/reportes |
Your related reports |
/reportesadmin |
Staff management panel |
/reportechat <id> |
Private chat for a report |
/reportestoggle |
Toggle report alerts |
/apelacion <id> |
Appeal a report you are reported in |
/reporteshistorial <player> |
Report history for a player |
/reportesestadisticas |
Statistics summary |
/easyplayerreport reload |
Reload config, messages and languages |
/easyplayerreport export <json|csv> |
Export all reports |
Permissions
| Permission |
Default |
Description |
easyplayerreport.use |
everyone |
Create and view reports |
easyplayerreport.staff |
op |
Manage reports and teleport |
easyplayerreport.moderate |
op |
Kick, warn and ban the reported player |
easyplayerreport.falsereport |
op |
Mark reports as false and block reporters |
easyplayerreport.admin |
op |
Delete reports and admin features |
easyplayerreport.history |
op |
View per-player history |
easyplayerreport.stats |
op |
View statistics |
easyplayerreport.export |
op |
Export reports |
easyplayerreport.reopen |
op |
Reopen closed reports |
easyplayerreport.appeal |
everyone |
Appeal reports about you |
Storage
database.type accepts sqlite (default, stored in plugins/EasyPlayerReport/reports.db)
or mysql. Existing reports.yml data is migrated automatically exactly once, the original
file is never deleted, and if the database fails the plugin falls back to YAML without
losing anything. Queries use prepared statements; passwords are never written to logs.
Localization
Messages ship in Spanish and English (lang/lang_es.yml, lang/lang_en.yml), and every
button, label and filter lives in menus.yml. All cooldowns, limits, sounds, potion effects,
reasons and retention rules are configurable in config.yml.
评论 0
登录后参与评分
还没有评论,来抢沙发吧