VelocityReport 是一款面向 Velocity 代理的轻量级跨服务器玩家举报系统。仅在代理端安装——无需后端服务器插件。举报数据集中存储(SQLite 或 MySQL),任何子服务器的工作人员均可查看和处理。
仅在代理端安装 · SQLite 或 MySQL · 英文与简体中文 · 仅在代理端安装,无需其他操作。
English
Features
| Feature | Description |
|---|---|
| Cross-server reporting | Players can report anyone on the network from any sub-server. Reports are stored centrally and staff are notified wherever they are. |
| Offline reports | A player can still be reported after they log out — as long as they were last online within the configured window (24 hours by default). |
| Clickable reason menu | /report <player> opens a clickable menu of preset reasons — no typing required. |
| Staff management menu | Browse report history with clickable, paginated chat menus; open details, resolve or reopen. |
| Status tracking | Mark reports resolved / pending with an optional resolution note; the reporter is notified when their report is handled. |
| Live staff notifications | Staff are notified the moment a report is filed, and reminded of pending reports when they join. |
| In-game staff list | Manage the fallback staff list without touching config files: /reportstaff add|remove|list. Names are written to staff-users.yml and merged with config.yml — your config comments stay intact. |
| One admin command | /reportadmin (alias /ra) collects reload, list, view, close, resolve/reopen, history and the staff list in a single entry point. |
| SQLite or MySQL | Zero-config SQLite by default; MySQL through a HikariCP pool. Tables are created automatically by both backends. |
| Bilingual | Built-in English and Simplified Chinese language files, switchable at runtime. |
| Server name mapping | Show raw backend names (lobby) as friendly text (Lobby), with & color codes. |
| Anti-spam cooldown | Configurable delay between reports, with a bypass permission. |
| Tab completion | /report <TAB> completes online players and players still inside the report window. |
| MiniMessage formatting | Every message is a MiniMessage template, and individual keys can be overridden from config.yml. |
Requirements
| Requirement | Version |
|---|---|
| Java | 17+ |
| Proxy | Velocity 3.x / 4.x (API 3.3.0+) |
| Storage | SQLite (bundled) or MySQL 5.7+ / MariaDB |
| Optional | A permissions plugin such as LuckPerms |
Installation
- Download the JAR and drop it into your Velocity
plugins/folder. - Restart the proxy.
- On first start the plugin generates
plugins/velocity-report/config.yml, alang/folder and the database file. Edit the config, then apply it with/reportadmin reload(the console can run it too).
Commands
Players
| Command | Description |
|---|---|
/report <player> (/rep) |
Open the clickable reason menu |
/report <player> <reason> |
Submit a report directly (a free-text reason is allowed) |
Staff — every staff command requires velocityreport.staff or a name on the staff list.
| Command | Description |
|---|---|
/reportadmin (/ra, /reportadm) |
Staff entry point — no arguments prints the help |
/reportadmin reload |
Reload config, language files and the staff file |
/reportadmin list [page] |
Open reports |
/reportadmin view <id> |
Full report details |
/reportadmin close <id> [note] |
Close a report, with an optional note |
/reportadmin resolve|reopen <id> |
Mark resolved / pending |
/reportadmin history [page] [player] |
Full report history |
/reportadmin staff add|remove|list [player] |
Manage the staff list |
/reports [page], /reportview <id>, /reportclose <id> [note] |
Shortcuts for the commands above |
/reportcd (list, view, resolve, reopen) |
Interactive report menu — in game only |
/reportstaff [list|add|remove] [player] |
Manage the staff list |
Permissions
| Permission | Default | Description |
|---|---|---|
velocityreport.report |
everyone | Submit reports (the command itself is not permission-checked) |
velocityreport.staff |
none | All staff commands and report notifications. A name on the staff list counts as having this node |
velocityreport.reload |
none | Use /reportadmin reload. Not interchangeable with staff |
velocityreport.notify |
none | Receive report notifications only |
velocityreport.bypasscooldown |
none | Ignore the report cooldown |
No permissions plugin? Velocity grants players no permissions of its own (an undefined permission counts as false). Add names to
staff-usersinconfig.yml— or in game with/reportstaff add <player>— and those players can use every staff command and receive notifications. Reloading is the exception:/reportadmin reloadonly answers tovelocityreport.reload, so use the console for that case.
Configuration
The generated config.yml is fully commented. The options you are most likely to touch:
language: zh_CN # zh_CN or en_US (files live in lang/)
cooldown-seconds: 60 # 0 disables the cooldown
offline-report-window-hours: 24 # reportable after logout; 0 = online players only
reports-per-page: 10
staff-users: [] # fallback staff list; /reportstaff writes to staff-users.yml
server-aliases: # raw server name → display text
lobby: "&eLobby"
survival: "&aSurvival"
Storage is configured under database: — type: sqlite, or type: mysql with connection details and optional HikariCP pool tuning.
Notes
/reportcd仅限游戏内使用;控制台可使用/reportadmin history。- 离线举报依赖于插件自身在玩家在线期间记录的「最后在线时间」——只要玩家在安装插件后曾在网络中出现过一次,其下线后即可被举报。
- 举报表与
player_last_seen表会在两种存储后端自动创建。 - 从 2.2.0 或更早版本升级:旧的
/reportreload命令已移除——请使用/reportadmin reload。原来通过velocityreport.staff权限进行重载的玩家,现在需要velocityreport.reload权限。
简体中文
VelocityReport 是一款轻量级的 Velocity 跨服举报插件,只需安装在代理端,无需任何后端子服插件。举报集中存储(SQLite 或 MySQL),任意子服的管理员均可查看并处理。
功能一览
| 功能 | 说明 |
|---|---|
| 跨服举报 | 玩家可在任意子服举报网络中的其他玩家。举报集中存储,管理员在任何子服都能收到通知 |
| 离线举报 | 玩家下线后仍可被举报,只要其最后在线时间处于配置的时间窗口内(默认 24 小时) |
| 点击选择原因 | /report <玩家> 弹出可点击的预设原因菜单,无需手动输入 |
| 管理菜单 | 支持点击、翻页的举报历史界面,可查看详情、标记已处理、重新打开 |
| 状态跟踪 | 标记已处理 / 未处理,并可填写处理说明;举报人会自动收到通知 |
| 实时通知 | 有新举报立即通知在线管理员;管理员上线时提示待处理数量 |
| 游戏内名单管理 | /reportstaff add|remove|list 直接管理备用管理员名单,名字写入 staff-users.yml 并与 config.yml 合并生效——不会破坏 config.yml 中的注释 |
| 管理总命令 | /reportadmin(别名 /ra)一个入口管完:重载、列表、详情、关闭、处理、历史、名单 |
| 双数据库 | 默认零配置 SQLite;也可使用 MySQL(HikariCP 连接池)。两者均会自动建表 |
| 双语言 | 内置英文与简体中文语言文件,运行时可切换 |
| 子服名映射 | 将 lobby 显示为 登录服,支持 & 颜色代码 |
| 防刷冷却 | 可配置举报间隔,支持绕过权限 |
| Tab 补全 | /report <TAB> 补全在线玩家及时间窗口内的离线玩家 |
| MiniMessage | 所有消息均为 MiniMessage 模板,也可在 config.yml 中单独覆盖 |
环境要求
| 要求 | 版本 |
|---|---|
| Java | 17+ |
| 代理端 | Velocity 3.x / 4.x(API 3.3.0+) |
| 数据库 | SQLite(内置)或 MySQL 5.7+ / MariaDB |
| 可选 | LuckPerms 等权限插件 |
安装
- 下载 JAR 文件,放入 Velocity 的
plugins/目录 - 重启代理端
- 首次启动会生成
plugins/velocity-report/config.yml、lang/目录和数据库文件。修改配置后使用/reportadmin reload生效(控制台也可执行)
命令
玩家命令
| 命令 | 说明 |
|---|---|
/report <玩家>(/rep) |
打开可点击的原因菜单 |
/report <玩家> <原因> |
直接提交举报(支持自定义原因) |
管理命令 —— 全部需要 velocityreport.staff 权限,或在管理员名单中
| 命令 | 说明 |
|---|---|
/reportadmin(/ra、/reportadm) |
管理总入口,不带参数显示帮助 |
/reportadmin reload |
重载配置、语言文件与名单文件 |
/reportadmin list [页码] |
待处理举报列表 |
/reportadmin view <编号> |
举报详情 |
/reportadmin close <编号> [说明] |
关闭举报,可附带处理说明 |
/reportadmin resolve|reopen <编号> |
标记已处理 / 未处理 |
/reportadmin history [页码] [玩家] |
全部举报历史 |
/reportadmin staff add|remove|list [玩家] |
管理管理员名单 |
/reports [页码]、/reportview <编号>、/reportclose <编号> [说明] |
上述部分命令的快捷方式 |
/reportcd(list、view、resolve、reopen) |
交互式举报菜单——仅游戏内可用 |
/reportstaff [list|add|remove] [玩家] |
管理管理员名单 |
权限节点
| 权限 | 默认 | 说明 |
|---|---|---|
velocityreport.report |
所有人 | 提交举报(该命令本身不做权限校验) |
velocityreport.staff |
无 | 所有管理命令 + 接收举报通知;名单内的玩家等同拥有此节点 |
velocityreport.reload |
无 | 使用 /reportadmin reload,与 staff 互不通用 |
velocityreport.notify |
无 | 仅接收举报通知 |
velocityreport.bypasscooldown |
无 | 跳过举报冷却 |
未安装权限插件? Velocity 自身不给玩家任何默认权限(未定义的权限一律按 false 处理)。将玩家名写进
config.yml的staff-users,或在游戏内使用/reportstaff add <玩家>添加,该玩家即可使用全部管理命令并收到通知。唯一例外是重载:/reportadmin reload仅识别velocityreport.reload权限,此种情况请使用控制台。
配置
生成的 config.yml 包含完整注释,最常修改的几项如下:
language: zh_CN # zh_CN 或 en_US(文件位于 lang/ 目录)
cooldown-seconds: 60 # 设为 0 关闭冷却
offline-report-window-hours: 24 # 离线后仍可被举报的时长,0 = 只能举报在线玩家
reports-per-page: 10
staff-users: [] # 备用管理员名单;/reportstaff 写入的是 staff-users.yml
server-aliases: # 原始子服名 → 显示文本
lobby: "&e登录服"
survival: "&a生存服"
数据库配置位于 database: 段:type: sqlite,或 type: mysql 加连接信息与可选的 HikariCP 连接池参数。
说明
/reportcd仅限游戏内使用;控制台请使用/reportadmin history- 离线举报依赖插件自身记录的「最后在线时间」——玩家在安装插件后上线过一次,下线后即可被举报
- 举报表与离线举报用的
player_last_seen表都会在两种数据库下自动创建 - 从 2.2.0 及更早版本升级:旧的
/reportreload命令已移除,改用/reportadmin reload;原来依靠velocityreport.staff权限进行重载的玩家需补充velocityreport.reload权限
Support
- Author: YuHongChen (LiquidTeam)
- QQ:
1464670605· Email:1464670605@qq.com
License
MIT
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧