SamB440's Reporter (Recoded) - SamB440's Reporter

简介

Reporter 是一款旨在简化玩家举报流程的 Minecraft 插件。它提供了直观的图形界面和命令支持，让举报和管理举报都变得轻松高效。

💡功能特性

• 支持多种存储方式：可选择 MySQL 数据库或本地文件存储举报数据。
• 完整的举报管理：支持通过 GUI 打开、关闭或删除举报。
• 广泛的版本兼容：完美支持 1.8 及以上版本的服务器。
• 便捷的举报方式：支持通过命令快速举报玩家。
• 智能命令补全：输入命令时提供智能提示。
• 轻量高效：插件本身占用资源极少，运行流畅。
• 开发者 API：提供 API 供开发者进行二次开发与集成。
• 简单易用：配置和使用都非常简单。
• 完全可定制：所有提示信息均可 100% 通过配置文件修改。
• 开源透明：插件代码完全开源。

🎮命令列表

• /report <玩家> <理由> - 举报指定玩家并陈述理由。
• /report list 或 /report reports - 查看所有举报（需要权限 report.view.reports）。
• /report list <玩家> - 查看针对特定玩家的举报。
• /report - 查看插件主命令帮助。

🔧权限节点

• report.view.new - 查看新举报的公告通知。
• report.report - 允许使用举报功能。
• report.toggle - 允许切换举报状态（如开启/关闭）。
• report.bypasslimit - 允许对同一玩家提交多次举报（绕过限制）。
• report.remove - 允许删除举报。

✨配置说明

数据库配置 (config.yml)

如需启用 MySQL 存储，请在配置文件中进行如下设置：

SQL:
  enabled: false
  host: localhost
  port: 3306
  database: Reporter
  username: root
  password: '123'
  variables: ?useSSL=false&autoReconnect=true

语言文件示例 (en_gb.yml)

以下为部分消息配置示例，您可以根据需要修改颜色代码和内容：

cannot_report_self: '&c你不能举报自己！'
no_reason: '&c&o请输入举报理由。'
no_permission: '&c抱歉，您没有执行此命令的权限。如果您认为这是一个错误，请联系服务器管理员。'
report_entry: '&b正在添加举报条目，举报对象：&3%0'
new_report: '&4&o%0 &c提交了一份针对 &4&o%1 &c的新举报：&b&o%2'
player_does_not_exist: '&c该玩家不存在。'
already_reported: '&c你已有一份针对该玩家的未处理举报。'
report_chat_prompt: '&a请在聊天栏中输入举报理由。&c输入“cancel”取消举报。'
report_cancelled: '&c你已取消本次举报。'

❓API 使用

插件的 API 及其文档目前仍在完善中 (WIP)。

获取所有举报条目

您可以通过以下方式获取举报缓存中的所有报告

Reporter.getAPI().getReportCache().getReports()

获取到的是 ReportEntry 类的实例集合。请注意，对举报条目进行任何修改后，务必使用 #saveEntry 方法保存更改。您也可以实例化此类来创建新的举报条目。

⭐重要提示

插件的“评价”部分并非用于报告程序错误。如果您因遇到错误而留下评价，将无法获得任何技术支持。请通过其他支持渠道反馈问题。