Velocity代理端跨服举报插件
Velocity-Report
跨服举报插件 — 仅需安装在 Velocity 代理端，子服务器无需任何插件或模组。
概述
Velocity-Report 是一款轻量级、跨子服的玩家举报管理系统。它运行在 Velocity 代理端，允许玩家举报任意子服的在线玩家，管理员可在统一界面查看、处理和跟踪举报记录。
核心优势：
仅代理端安装，子服零负担
支持 SQLite / MySQL 双数据库
可点击的原因选择菜单，无需手动输入
管理员 GUI 管理界面，支持分页
中英双语配置切换
实时管理员通知
支持管理员游戏内/reportcd管理员可以查看并处理历史举报
功能详解
跨服举报
玩家可在任意子服举报其他在线玩家，不受服务器边界限制。系统自动记录被举报人、举报人、所在子服、时间和原因。支持TAB自动补全玩家名称。
原因选择菜单
玩家输入 /report <玩家> 后，聊天框弹出可点击的原因选择菜单，无需手动打字。每个原因支持自定义名称、描述和图标。同时也支持玩家 手动补充举报原因。
管理员管理 GUI
管理员通过聊天界面查看举报历史，支持分页浏览、查看详情、标记处理状态，全程点击操作。
状态标记与通知
举报可标记为"已处理"或"重新打开"。状态变更后系统自动通知举报人，无需手动回复。
管理员实时通知
新举报产生时，在线管理员立即收到通知，包含被举报人、举报原因和所在服务器。
权限控制
支持 LuckPerms 等权限插件，也支持在配置文件中直接填写管理员名单，两种模式自动适配。
双数据库支持
默认使用 SQLite，零配置开箱即用。也可切换为 MySQL，适合多代理或多节点部署。
防刷机制
可配置举报冷却时间，防止玩家频繁提交重复举报。
热重载
修改配置文件后执行 /reportreload，无需重启代理即可生效。
Tab 补全
输入 /report 后按 Tab 键可自动补全在线玩家名称，提升操作效率。
服务器名映射
子服内部名称可映射为自定义显示名称，支持颜色代码，让举报信息更直观。
命令列表
玩家命令
| 命令 | 权限 | 说明 |
| :--- | :--- | :--- |
| /report <玩家> | 所有玩家 | 打开举报原因选择菜单 |
| /report <玩家> <原因> | 所有玩家 | 直接提交举报 |
| /rep <玩家> ... | 所有玩家 | /report 的别名 |
管理员命令
| 命令 | 权限 | 说明 |
| :--- | :--- | :--- |
| /reports [页码] | velocityreport.staff | 查看待处理举报列表 |
| /reportview <编号> | velocityreport.staff | 查看举报详情 |
| /reportclose <编号> [说明] | velocityreport.staff | 关闭举报 |
| /reportcd | velocityreport.staff | 打开举报管理菜单 |
| /reportcd list [页码] [玩家] | velocityreport.staff | 查看举报记录 |
| /reportcd view <编号> | velocityreport.staff | 查看详情（含操作按钮） |
| /reportcd resolve <编号> | velocityreport.staff | 标记已处理 |
| /reportcd reopen <编号> | velocityreport.staff | 重新打开举报 |
| /reportreload | velocityreport.staff | 热重载配置文件 |
权限节点
| 权限 | 默认 | 说明 |
| :--- | :--- | :--- |
| velocityreport.report | 所有玩家 | 使用 /report 提交举报 |
| velocityreport.staff | OP | 查看和管理举报记录 |
| velocityreport.notify | OP | 接收新举报通知 |
| velocityreport.bypasscooldown | OP | 绕过举报冷却限制 |
配置文件
配置文件位于 plugins/velocity-report/config.yml，插件首次启动自动生成。
完整配置示例
── 语言设置 ──
zh — 简体中文 | en — English
language: zh
── 数据库配置 ──
database:
type: sqlite # sqlite 或 mysql
sqlite:
filename: "reports.db"
mysql:
host: "127.0.0.1"
port: 3306
database: "velocity_report"
user: "root"
password: ""
── 举报冷却(秒)，0 为关闭 ──
cooldown-seconds: 60
── 每页显示数量 ──
reports-per-page: 10
── 举报原因模板 ──
玩家输入 /report <玩家> 时显示可点击菜单
report-reasons:
id: "hacking"
name: "&c外挂作弊"
description: "透视、自瞄、连点器等"
icon: "X"
id: "chat"
name: "&e违规言论"
description: "骂人、刷屏、违规广告等"
icon: "!"
id: "griefing"
name: "&6破坏行为"
description: "破坏建筑、偷窃物品等"
icon: ""
id: "admin-abuse"
name: "&5管理员滥用"
description: "管理员滥用职权"
icon: "#"
id: "other"
name: "&7其他"
description: "使用 /report <玩家> <原因> 自定义"
icon: "?"
── 管理员名单(不区分大小写) ──
未安装权限插件时在此填写管理员用户名
staff-users:
"YuHongChen"
── 服务器名称映射 ──
原始子服名 → 自定义显示名
server-aliases:
lobby: "&e大厅"
survival: "&a生存服"
minigame: "&6小游戏"
── 消息配置(支持 MiniMessage 和 & 颜色代码) ──
messages:
prefix: "&c[举报]&r "
report-sent: "&a你对 &e{reported} &a的举报已提交，感谢反馈。"
report-cooldown: "&c请等待 {seconds} 秒后再提交举报。"
self-report: "&c不能举报自己。"
player-not-found: "&c找不到该玩家，请确认名称是否正确。"
no-reports: "&7当前没有待处理的举报。"
数据库设置
SQLite（默认）
数据文件位于 plugins/velocity-report/reports.db，首次启动自动创建，零配置。
MySQL
修改 config.yml 中 database.type 为 mysql，填写连接信息后重启或重载。
需提前创建数据库：
CREATE DATABASE IF NOT EXISTS velocity_report DEFAULT CHARSET utf8mb4;
安装步骤
下载 Velocity-Report 最新版 JAR 文件
将 JAR 放入 Velocity 的 plugins/ 目录
重启 Velocity 代理服务器
插件自动生成 config.yml 和 reports.db
按需修改配置后执行 /reportreload 热重载
使用流程
玩家举报
输入 /report Steve
聊天框弹出原因选择菜单
点击 "外挂作弊"
系统提示：你对 Steve 的举报已提交
管理员处理
收到通知：[举报] Alex 举报了 Steve 在 lobby：外挂作弊
输入 /reportcd 打开管理菜单
点击举报记录查看详情
点击 [标记已处理]
举报人自动收到处理通知
依赖要求
| 依赖 | 用途 |
| :--- | :--- |
| Velocity API 3.3.0+ | 代理端核心 API |
| SQLite JDBC | SQLite 数据库驱动（内置） |
| MySQL Connector/J | MySQL 数据库驱动（内置） |
| SnakeYAML | YAML 配置解析 |
| LuckPerms（可选） | 权限管理 |
兼容性
| 项目 | 版本 |
| :--- | :--- |
| Minecraft | 1.8 — 1.21.x |
| Velocity | 3.3.0+ |
| Java | 17+ |
作者与许可
作者： YuHongChen (组织:LiquidTeam)
许可证： MIT License
联系作者： QQ 1464670605 / 邮箱 1464670605@qq.com
Modrinth下载： https://modrinth.com/plugin/velocity-report
制作 by LT-YHC
评论 (0)