Slash Report — 网络举报套件
一套完整且可直接投入生产环境的 Minecraft 服务器网络玩家举报与管理套件。Slash Report 将 Paper 子服务器、BungeeCord / Velocity 代理与 Discord 连接,构建统一的实时举报流水线,包含游戏内的箱子 GUI、交互式 Discord 嵌入消息以及全网络范围的工作人员通知。
兼容性
| 平台 / 层级 | 支持情况 | 备注 |
|---|---|---|
| Paper (1.20.x – 1.21.x) | ✅ | 后端子服务器(兼容 Purpur / Pufferfish) |
| BungeeCord | ✅ | 代理网络加载器 |
| Waterfall | ✅ | 代理网络加载器 |
| Velocity | ✅ | 通过 bungeecord-plugin-compat = true 支持 |
| Minecraft 客户端 | ✅ 1.8 – 1.21+ | 玩家可通过 ViaVersion / ViaBackwards 支持 |
| Spigot / CraftBukkit | ❌ | 缺少 Paper Brigadier 和 Lifecycle API |
功能
面向玩家
- 游戏内原因选择 GUI:输入
/report <player>即可打开一个交互式的 3 行箱子 GUI 以选择举报原因。 - 直接命令提交:支持
/report <player> <reason> [details...]并具备完整的 Tab 补全功能。 - 简短别名:使用
/rep快速访问。 - 防刷屏冷却:可配置每位玩家的冷却时间(默认:60 秒)。
- 智能重复折叠:重复提交相同的举报会更新现有举报,而不是创建重复条目。
面向工作人员(游戏内)
- Paper 员工箱子 GUI:
/reports gui [open|claimed|closed]— 提供 6 行分页的员工箱子 GUI,带有玩家头像图标和状态过滤器。- 3 行举报详情 GUI,在箱子容器内直接提供 认领 (Claim) 和 关闭 (Close) 按钮。
- 全网络聊天警报:当举报被提交时,立即向所有已连接的子服务器广播通知。
- 来源服务器追踪:在聊天警报、命令和 Discord 嵌入消息中显示
[origin_server]标签(例如[survival-1])。 - 工作人员命令:
/reports list、/reports view、/reports claim和/reports close。
Discord 集成
- 单一中央机器人:仅在代理端运行(整个网络只需 1 个机器人)。
- 丰富嵌入消息:基于 JDA 6.5.0 的机器人发布详细的嵌入消息,包含目标玩家头像缩略图和服务器来源标签。
- 交互式按钮:Discord 嵌入消息上设有仅限拥有 Staff 角色的用户使用的 认领 (Claim) 和 解决 (Resolve) 按钮。
- 原地更新:当举报被认领或解决时,嵌入消息的状态会在原地更新——不会造成频道混乱。
- 优雅降级:即使 Discord 离线,游戏内的举报功能仍可继续正常运行。
数据与网络同步
- MySQL 支持:跨代理节点和后端 Paper 子服务器的共享数据库同步。
- SQLite 支持:单节点设置下的零配置选项。
- 插件消息管道:利用 BungeeCord 子通道(
reportplugin:report&reportplugin:notify)实现亚毫秒级的数据包转发。
命令与权限
命令
| 命令 | 平台 | 描述 |
|---|---|---|
/report <player> |
Paper | 打开原因选择箱子 GUI |
/report <player> <reason> [details] |
Both | 直接提交举报 |
/reports list [status] [page] |
Both | 列出举报(可过滤) |
/reports view <id> |
Both | 查看举报详情 |
/reports claim <id> |
Both | 认领举报 |
/reports close <id> [note] |
Both | 关闭/解决举报 |
/reports gui [status] |
Paper | 打开员工举报列表箱子 GUI |
权限
| 权限节点 | 默认值 | 描述 |
|---|---|---|
report.report |
true |
提交举报 |
report.staff |
op |
查看/管理举报 + 接收警报 |
report.immune |
false |
无法被举报 |
report.admin |
op |
完全管理员访问权限 |
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
27
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
Vivecraft Spigot Extension
fayer3
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
前置实用
12
旅行地图
mysticdrew
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
冒险实用
12
评论 0
登录后参与评分
还没有评论,来抢沙发吧