Velocity-Report

VelocityReport is a lightweight cross-server player report system for Velocity proxies. Install it on the proxy only — no backend server plugins required. Reports are stored centrally (SQLite or MySQL) and staff on any sub-server can see and handle them.

Install on the proxy only · SQLite or MySQL · English & Simplified Chinese · Install it on the proxy, nothing else.

---

English

Features

Requirements

Installation

1. Download the JAR and drop it into your Velocity plugins/ folder.
2. Restart the proxy.
3. On first start the plugin generates plugins/velocity-report/config.yml, a lang/ folder and the database file. Edit the config, then apply it with /reportadmin reload (the console can run it too).

Commands

Players

Staff — every staff command requires velocityreport.staff or a name on the staff list.

Permissions

No permissions plugin? Velocity grants players no permissions of its own (an undefined permission counts as false). Add names to staff-users in config.yml — or in game with /reportstaff add <player> — and those players can use every staff command and receive notifications. Reloading is the exception: /reportadmin reload only answers to velocityreport.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 is in-game only; the console can use /reportadmin history.
• Offline reports rely on the plugin's own last-seen records, gathered while players are online — every player becomes reportable while offline once they have been seen on the network after the plugin was installed.
• Report tables and the player_last_seen table are created automatically on both storage backends.
• Upgrading from 2.2.0 or older: the old /reportreload command has been removed — use /reportadmin reload. Anyone who could reload through velocityreport.staff now needs velocityreport.reload.

---

简体中文

VelocityReport 是一款轻量级的 Velocity 跨服举报插件，只需装在代理端，不需要任何后端子服插件。举报集中存储（SQLite 或 MySQL），任意子服的管理员都能看到并处理。

功能一览

环境要求

安装

1. 下载 JAR，放进 Velocity 的 plugins/ 目录
2. 重启代理端
3. 首次启动会生成 plugins/velocity-report/config.yml、lang/ 目录和数据库文件。改完配置后用 /reportadmin reload 生效（控制台也能执行）

命令

玩家命令

管理命令 —— 全部需要 velocityreport.staff，或在管理员名单里

权限节点

没装权限插件？ 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: [email protected]

License

MIT