VelocityReport [MySQL/SQLite] - VelocityReport

💡VelocityReport —— 跨平台举报插件

VelocityReport 是一款专为 Minecraft 服务器网络设计的现代化举报插件。它不仅完美支持 Velocity 代理，也可作为后端在 Spigot、Paper、Purpur 等服务器上运行，填补了 Velocity 网络缺乏实用举报工具的空白。

🎮核心特性

功能丰富

• BookGUI：提供基于书的图形用户界面，操作直观。
• 多阶段处理：举报可经历提交、处理、解决等多个状态。
• 奖励系统：可配置奖励来鼓励玩家使用举报系统。
• 高级消息：全面支持 RGB 颜色、渐变和 MiniMessage 组件格式的消息。
• 自定义举报理由：管理员可以完全自定义玩家可选的举报原因。
• 扩展 API：提供丰富的 API 方法和事件，方便开发者创建插件扩展或新增功能。

高性能与稳定性

• 异步数据库操作：所有数据库更新均为异步处理，有效避免服务器卡顿和高线程负载，实现真正的高性能。
• 持续更新：插件保持活跃开发，会定期修复已知漏洞并进行性能优化，确保运行流畅。

支持与兼容性

• 多数据库支持：支持 MySQL 和 SQLite 数据库，方便不同规模的服务器选用。
• 多平台后端：原生支持 Velocity 网络，同时兼容 Spigot、Paper、Purpur 等作为后端服务器。
• 优质支持：您可以加入我们的 Discord 社区，快速（甚至即时）获得使用帮助。

VelocityReport 是一个专为 Velocity 代理服务器设计的报告插件，允许玩家轻松报告其他玩家的不当行为。管理员可以通过简洁的网页界面查看和处理这些报告，从而高效地管理服务器社区。

💡功能特性

• 跨服务器报告：玩家可以在 Velocity 网络中的任何子服务器上进行报告。
• 网页管理面板：通过浏览器访问直观的界面来查看和处理报告。
• 可自定义：支持配置报告原因、消息、权限和数据库设置。
• 数据持久化：报告数据存储在 MySQL 或 MariaDB 数据库中。
• Discord 集成：可选功能，可将报告通知发送到 Discord 频道。
• 多语言支持：内置多种语言，并支持自定义消息。

🎮命令与权限

玩家命令

• /report <player> <reason>：报告指定玩家。

- 权限：`velocityreport.report` (默认所有玩家拥有)

• /reports：打开报告管理网页界面。

- 权限：`velocityreport.reports.gui` (默认管理员拥有)

管理员命令

• /velocityreport reload：重载插件配置和消息文件。

- 权限：`velocityreport.admin`

🔧安装与设置

要求

• Velocity 代理服务器：版本 3.1.0 或更高。
• 数据库：MySQL 或 MariaDB。
• Java：版本 11 或更高。

安装步骤

• 将 VelocityReport 的 JAR 文件放入 Velocity 服务器的 plugins 文件夹。
• 重启 Velocity 服务器。
• 编辑生成的配置文件 plugins/VelocityReport/config.toml。
• 配置数据库连接和其他设置。
• 再次重启服务器以使配置生效。

配置文件

主要配置文件为 config.toml，您可以在其中设置：

• 数据库连接信息（主机、数据库名、用户名、密码）。
• 网页界面的访问端口和密钥。
• 报告原因列表。
• Discord Webhook 设置（可选）。
• 语言设置。

❓常见问题

网页界面无法访问？

• 确保配置文件中 host 和 port 设置正确，且端口未被防火墙阻止。
• 检查 Velocity 日志中是否有插件启动错误。

报告没有保存到数据库？

• 确认数据库连接信息（如密码）正确无误。
• 确保数据库服务器正在运行且可访问。

如何更新插件？

• 从官方来源下载新版本的 JAR 文件。
• 停止 Velocity 服务器。
• 替换 plugins 文件夹中的旧 JAR 文件。
• 启动服务器。通常配置和数据会自动迁移。

如何贡献翻译？

插件的翻译文件位于 GitHub 仓库的 src/main/resources/lang 目录。欢迎提交改进或新的语言文件。

⭐链接与支持

• GitHub 仓库：https://github.com/Syrent/VelocityReport
• Wiki 文档：https://github.com/Syrent/VelocityReport/wiki
• 问题与支持：请在 GitHub 仓库的 Issues 页面提交问题。