L-report

插件

· 作者 squezsaz

带有 GUI 的玩家举报插件(支持 Discord WebHook 集成)

0 本站下载 0 关注 更新于 6 个月前

最新 1.1.6 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

L-Report

高级 Minecraft 举报系统,允许玩家通过图形用户界面(GUI)举报其他玩家。


目录


功能

功能 描述
GUI 举报系统 通过 GUI 轻松举报玩家
理由选择 作弊、恶意行为、刷屏、广告、辱骂、其他
证据系统 在举报时添加证据
每日限制 每个玩家每天的举报上限
冷却时间 再次举报同一玩家的冷却期
管理面板 查看所有举报,接受/拒绝处理
统计信息 查看举报统计数据
冻结系统 冻结被举报的玩家
举报历史 查看你自己的举报记录
离线举报 举报离线玩家(可配置)
多语言支持 土耳其语和英语支持
Discord Webhook 发送通知到 Discord
奖励系统 当举报被采纳时,玩家可以获得奖励的系统

安装

1. 下载

将插件 JAR 文件放入 plugins/ 文件夹中。

2. 启动

启动服务器或使用 /reload 命令。

3. 自动生成文件

plugins/L-report/
├── config.yml          # 主配置文件
├── lang/
│   ├── tr.yml       # 土耳其语语言文件
│   └── en.yml       # 英语语言文件
├── lreport.db      # SQLite 数据库
└── reports/       # 举报数据

命令

玩家命令

命令 描述
/report 打开主菜单
/report <player> 通过 GUI 举报玩家
<playername> 举报离线玩家(需启用配置选项)

管理员命令

命令 描述
/reportadmin 打开管理面板
/reportadmin search <player> 搜索玩家的举报记录
/reportadmin stats 显示统计数据
/report reload 重新加载配置和语言文件
/report lang tr|en 更改语言

权限

权限 描述
lreport.player 可以创建举报
lreport.admin 可以使用管理员命令

配置设置

# ============================================
# L-Report 配置
# ============================================

# 语言设置
# 选项:tr (土耳其语), en (英语)
language: tr

# 在所有插件消息前显示的消息前缀
# 支持与 & 字符一起使用的颜色代码
# 示例:"&8[&cRapor&8] &7" -> [Rapor]
prefix: "&8[&cRapor&8] &7"

# 举报同一玩家之间的冷却时间(分钟)
# 设置为 0 以禁用冷却时间
cooldown: 30

# 每个玩家每天可以创建的最大举报数量
# 设置为 0 表示无限制
max-reports-per-day: 5

# 向所有在线管理员广播新举报
# true = 启用, false = 禁用
broadcast-reports: false

# 当创建新举报时通知在线管理员
# true = 启用, false = 禁用
notify-admins: true

# 允许通过 /report <player> 命令举报离线玩家
# true = 启用, false = 禁用
allow-offline-report: true

# ============================================
# Discord Webhook 设置
# ============================================

# 启用 Discord webhook 通知
# true = 启用, false = 禁用
webhook-enabled: false

# Discord webhook URL
# 从 Discord 频道设置 -> 集成 -> Webhooks 获取
webhook-url: ""

# Discord 消息中显示的 Webhook 用户名
webhook-username: "L-Report Bot"

# 嵌入颜色(十进制数值)
# 红色: 15548984, 绿色: 5767199, 黄色: 16440904, 蓝色: 3447003
webhook-color: 15548984

# 发送到 Discord 的事件类型
# true = 发送, false = 不发送
webhook-new-report: true
webhook-report-accepted: true
webhook-report-rejected: true
webhook-report-deleted: false

# ============================================
# 数据库设置
# ============================================

# 数据库类型:sqlite 或 mysql
database-type: sqlite

# MySQL 设置(仅在 database-type: mysql 时有效)
mysql:
  host: "localhost"
  port: 3306
  database: "lreport"
  username: "root"
  password: ""
  table-prefix: "lreport_"

# ============================================
# 奖励系统
# ============================================

# 当举报被采纳时启用奖励系统
# true = 启用, false = 禁用
reward-enabled: false

# 奖励命令列表(添加键:0, 1, 2 等)
# %player% = 举报者的名字
# console: true = 以控制台身份运行, false = 以玩家身份运行
reward-commands:
  0:
    command: "give %player% money 100"
    console: true
  1:
    command: "crate give %player% basic 1"
    console: true

Discord 集成

设置步骤

  1. 打开 Discord 服务器设置
  2. 进入 Integrations > Webhooks > New Webhook
  3. 复制 webhook URL
  4. 粘贴到配置文件中:
webhook-enabled: true
webhook-url: "https://discord.com/api/webhooks/xxxxx/xxxxx"

嵌入外观示例

:inbox_tray: 新举报通知
一名玩家创建了新的举报。请查看管理面板以获取详细信息。

:bust_in_silhouette: 举报人    | PlayerName
:skull: 被举报者           | TargetName
:clipboard: 理由        | :crossed_swords: 作弊
:file_folder: 证据    | 证据文本
:shield: 处理者         | AdminName

L-Report 插件 | 23/04/2026 23:16

嵌入颜色

事件 颜色 HEX
新举报 橙色 15105570
已采纳 绿色 5767199
已拒绝 红色 15548984
已删除 黄色 16440904

数据库

SQLite(默认)

存储在自动生成的 lreport.db 文件中。


常见问题解答 (FAQ)

问:插件无法正常工作——我该怎么办?

答:首先检查控制台是否有错误信息。然后尝试执行 /reload 命令。

问:GUI 界面打不开?

答:请检查您是否拥有 inventory 权限。

问:语言文件不生效?

答:删除服务器上的语言文件并重启服务器。

问:Discord Webhook 无法工作?

答:请检查 URL 是否正确。确保配置中设置了 webhook-enabled: true。


许可证

MIT License


占位符

通用报告统计

  • %lreport_total_reports%:报告总数。
  • %lreport_pending_reports%:状态为“待处理”的报告数量。
  • %lreport_accepted_reports%:状态为“已接受”的报告数量。
  • %lreport_rejected_reports%:状态为“已拒绝”的报告数量。
  • %lreport_today_reports%:今天提交的报告数量。
  • %lreport_week_reports%:本周提交的报告数量。
  • %lreport_month_reports%:本月提交的报告数量。
  • %lreport_acceptance_rate%:整体报告接受率百分比。
  • %lreport_rejection_rate%:整体报告拒绝率百分比。
  • %lreport_pending_rate%:整体待处理报告百分比。
  • %lreport_most_common_reason%:最常见的举报原因。

玩家个人统计

  • %lreport_my_reports%:该玩家提交的报告总数。
  • %lreport_my_pending_reports%:该玩家提交的待处理报告数量。
  • %lreport_my_accepted_reports%:该玩家提交的已接受报告数量。
  • %lreport_my_rejected_reports%:该玩家提交的已拒绝报告数量。
  • %lreport_my_today_reports%:该玩家今天提交的报告数量。
  • %lreport_my_remaining_reports%:该玩家今天剩余的举报次数。
  • %lreport_my_status%:该玩家最近一次报告的状态。
  • %lreport_my_can_report%:该玩家当前是否允许创建报告(true/false)。
  • %lreport_my_acceptance_rate%:该玩家自身报告的接受率百分比。
  • %lreport_my_cooldown%:该玩家的剩余冷却时间(秒)。

排行榜(前列名单)

  • 举报者:
    • %lreport_top_reporter%:提交报告最多的玩家名称。
    • %lreport_top_reporter_count%:排名第一的举报者的报告数量。
    • %lreport_top_reporter_2%:排名第二的举报者名称。
    • %lreport_top_reporter_3%:排名第三的举报者名称。
  • 被举报玩家:
    • %lreport_most_reported%:收到举报最多的玩家名称。
    • %lreport_most_reported_count%:收到举报最多的玩家收到的举报总数。
  • 工作人员/处理者:
    • %lreport_top_handler%:处理报告最多的工作人员名称。
    • %lreport_top_handler_count%:排名第一的工作人员处理的报告数量。

按原因分类统计

  • 作弊: %lreport_hack_reports%, %lreport_hack_pending%, %lreport_hack_accepted%, %lreport_hack_rejected%
  • 辱骂/有毒言论: %lreport_toxic_reports%, %lreport_toxic_pending%, %lreport_toxic_accepted%, %lreport_toxic_rejected%
  • 垃圾信息: %lreport_spam_reports%, %lreport_spam_pending%, %lreport_spam_accepted%, %lreport_spam_rejected%
  • 广告: %lreport_ad_reports%, %lreport_ad_pending%, %lreport_ad_accepted%, %lreport_ad_rejected%
  • 人身攻击: %lreport_insult_reports%, %lreport_insult_pending%, %lreport_insult_accepted%, %lreport_insult_rejected%

日期和时间信息

  • %lreport_first_report_date%:服务器上第一份报告的日期。
  • %lreport_first_report_time%:服务器上第一份报告的时间。
  • %lreport_last_report_date%:服务器上最新报告的日期。
  • %lreport_last_report_time%:服务器上最新报告的时间。
  • %lreport_last_report_datetime%:最后一份报告的完整日期和时间。
  • %lreport_my_first_report_date%:该玩家的第一份报告日期。
  • %lreport_my_last_report_date%:该玩家的最后一份报告日期。

系统和数据库

  • %lreport_db_total%:数据库中直接获取的报告总数。
  • %lreport_is_frozen%:该玩家当前是否被冻结(true/false)。
  • %lreport_frozen_count%:当前被冻结的玩家总数。
  • %lreport_plugin_version%:L-Report 插件的当前版本。
  • %lreport_cooldown%:配置中的全局冷却设置。
  • %lreport_online_players%:当前在线玩家数量。

开发者 API 集成

将 L-report 集成到您的插件中,以与我们的报告系统进行交互。请按照以下步骤开始使用。

1. 添加仓库

首先,将 JitPack 仓库添加到您的 pom.xml 文件的 <repositories> 部分:

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

2. 添加依赖

接下来,将 L-report API 依赖添加到您的 <dependencies> 部分。将 TAG 替换为您想要使用的版本(例如 v1.0.0)。

<dependencies>
    <dependency>
        <groupId>com.github.squezsaz</groupId>
        <artifactId>L-report</artifactId>
        <version>TAG</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

注意: 由于您的插件在运行时需要 L-report,请将作用域保持为 provided,并记得在您的 plugin.yml 文件中添加 depend: [L-report]。

3. 使用示例

您可以通过主类获取实例来访问 API:

import com.lreport.api.LReportAPI;

```java
public class MyPlugin extends JavaPlugin {
    @Override
    public void onEnable() {
        // 访问 API
        LReportAPI api = LReport.getApi();
        
        if (api != null) {
            int pendingReports = api.getPendingReportCount();
            getLogger().info("当前有 " + pendingReports + " 个待处理的报告。");
        }
    }
}

API 文档

如需查看方法和描述的详细列表,请访问我们的在线 JavaDoc 页面: ? L-report JavaDocs


快速提示:

  • 版本: 如果您希望始终获取最新代码,可以使用 master-SNAPSHOT 作为 <version>,但建议使用固定版本(如 v1.0.0)以确保稳定性。
  • JitPack 日志: 如果依赖项下载失败,请检查 JitPack 上的构建日志以识别错误。

联系方式

如有任何问题或建议,请联系 Discord: squezsaz


注意: 此插件适用于 Spigot、Paper 及其衍生服务端。(支持 1.18 - 1.21+)

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源