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 集成
设置步骤
- 打开 Discord 服务器设置
- 进入 Integrations > Webhooks > New Webhook
- 复制 webhook URL
- 粘贴到配置文件中:
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+)
L-Report
Advanced Minecraft reporting system that allows players to report other players via GUI.
Table of Contents
Features
| Feature |
Description |
| GUI Report System |
Report players easily via GUI |
| Reason Selection |
Hack, Toxic, Spam, Advertising, Insult, Other |
| Evidence System |
Add evidence with report |
| Daily Limit |
Daily report limit per player |
| Cooldown |
Cooldown for re-reporting same player |
| Admin Panel |
View all reports, accept/reject |
| Statistics |
View report statistics |
| Freeze System |
Freeze reported player |
| Report History |
View your own reports |
| Offline Reporting |
Report offline players (configurable) |
| Multi-Language |
Turkish and English support |
| Discord Webhook |
Send notifications to Discord |
| Reward |
A system where players can receive rewards for their accepted reports |
Installation
1. Download
Place the plugin JAR file in the plugins/ folder.
2. Start
Start the server or use /reload command.
3. Auto-Generated Files
plugins/L-report/
├── config.yml # Main config file
├── lang/
│ ├── tr.yml # Turkish language file
│ └── en.yml # English language file
├── lreport.db # SQLite database
└── reports/ # Report data
Commands
Player Commands
| Command |
Description |
/report |
Opens main menu |
/report <player> |
Report player via GUI |
<playername> |
Report offline player (config must be enabled) |
Admin Commands
| Command |
Description |
/reportadmin |
Opens admin panel |
/reportadmin search <player> |
Search player's reports |
/reportadmin stats |
Show statistics |
/report reload |
Reload config and language files |
/report lang tr|en |
Change language |
Permissions
| Permission |
Description |
lreport.player |
Can create reports |
lreport.admin |
Can use admin commands |
Config Settings
# ============================================
# L-Report Configuration
# ============================================
# Language setting
# Options: tr (Turkish), en (English)
language: tr
# Message prefix shown before all plugin messages
# Supports color codes with & character
# Example: "&8[&cRapor&8] &7" -> [Rapor]
prefix: "&8[&cRapor&8] &7"
# Cooldown time in minutes between reporting the same player
# Set to 0 to disable cooldown
cooldown: 30
# Maximum number of reports a player can create per day
# Set to 0 for unlimited reports
max-reports-per-day: 5
# Broadcast new reports to all online admins
# true = Enabled, false = Disabled
broadcast-reports: false
# Notify online admins when a new report is created
# true = Enabled, false = Disabled
notify-admins: true
# Allow reporting offline players via /report <player> command
# true = Enabled, false = Disabled
allow-offline-report: true
# ============================================
# Discord Webhook Settings
# ============================================
# Enable Discord webhook notifications
# true = Enabled, false = Disabled
webhook-enabled: false
# Discord webhook URL
# Get this from Discord channel settings -> Integrations -> Webhooks
webhook-url: ""
# Webhook username shown in Discord messages
webhook-username: "L-Report Bot"
# Embed color (in decimal)
# Red: 15548984, Green: 5767199, Yellow: 16440904, Blue: 3447003
webhook-color: 15548984
# Which events to send to Discord
# true = Send, false = Don't send
webhook-new-report: true
webhook-report-accepted: true
webhook-report-rejected: true
webhook-report-deleted: false
# ============================================
# Database Settings
# ============================================
# Database type: sqlite or mysql
database-type: sqlite
# MySQL settings (only if database-type: mysql)
mysql:
host: "localhost"
port: 3306
database: "lreport"
username: "root"
password: ""
table-prefix: "lreport_"
# ============================================
# Reward System
# ============================================
# Enable reward system when reports are accepted
# true = Enabled, false = Disabled
reward-enabled: false
# Reward commands list (add keys: 0, 1, 2, etc.)
# %player% = Reporter's name
# console: true = Run as console, false = Run as player
reward-commands:
0:
command: "give %player% money 100"
console: true
1:
command: "crate give %player% basic 1"
console: true
Discord Integration
Setup
- Open Discord server settings
- Go to Integrations > Webhooks > New Webhook
- Copy the webhook URL
- Paste into config file:
webhook-enabled: true
webhook-url: "https://discord.com/api/webhooks/xxxxx/xxxxx"
Embed Appearance
:inbox_tray: New Report Notification
A player has created a new report. Check the admin panel for details.
:bust_in_silhouette: Reporter | PlayerName
:skull: Reported | TargetName
:clipboard: Reason | :crossed_swords: Hack
:file_folder: Evidence | evidence text
:shield: Handler | AdminName
L-Report Plugin | 23/04/2026 23:16
Embed Colors
| Event |
Color |
HEX |
| New Report |
Orange |
15105570 |
| Accepted |
Green |
5767199 |
| Rejected |
Red |
15548984 |
| Deleted |
Yellow |
16440904 |
Database
SQLite (Default)
Stored in auto-generated lreport.db file.
FAQ
Q: Plugin not working - What should I do?
A: First check the console for errors. Then try /reload.
Q: GUI not opening?
A: Check if you have inventory permission.
Q: Language file not working?
A: Delete the language files on server and restart.
Q: Discord webhook not working?
A: Check if URL is correct. Make sure webhook-enabled: true.
License
MIT License
Placeholders
General Report Statistics
%lreport_total_reports%: Total number of reports.
%lreport_pending_reports%: Number of reports with "PENDING" status.
%lreport_accepted_reports%: Number of reports with "ACCEPTED" status.
%lreport_rejected_reports%: Number of reports with "REJECTED" status.
%lreport_today_reports%: Number of reports submitted today.
%lreport_week_reports%: Number of reports submitted this week.
%lreport_month_reports%: Number of reports submitted this month.
%lreport_acceptance_rate%: The overall percentage of accepted reports.
%lreport_rejection_rate%: The overall percentage of rejected reports.
%lreport_pending_rate%: The overall percentage of pending reports.
%lreport_most_common_reason%: The most frequently cited reason for reports.
Personal Player Statistics
%lreport_my_reports%: Total reports submitted by the player.
%lreport_my_pending_reports%: Number of pending reports submitted by the player.
%lreport_my_accepted_reports%: Number of accepted reports submitted by the player.
%lreport_my_rejected_reports%: Number of rejected reports submitted by the player.
%lreport_my_today_reports%: Number of reports submitted by the player today.
%lreport_my_remaining_reports%: Number of report attempts the player has left for today.
%lreport_my_status%: Status of the player's most recent report.
%lreport_my_can_report%: Whether the player is currently allowed to create a report (true/false).
%lreport_my_acceptance_rate%: The acceptance rate percentage for the player's own reports.
%lreport_my_cooldown%: The remaining cooldown time for the player (in seconds).
Leaderboards (Top Lists)
- Reporters:
%lreport_top_reporter%: Name of the player who has submitted the most reports.
%lreport_top_reporter_count%: The report count of the top reporter.
%lreport_top_reporter_2%: Name of the 2nd rank reporter.
%lreport_top_reporter_3%: Name of the 3rd rank reporter.
- Reported Players:
%lreport_most_reported%: Name of the player with the most reports against them.
%lreport_most_reported_count%: The number of reports the most reported player has received.
- Staff/Handlers:
%lreport_top_handler%: Name of the staff member who has handled the most reports.
%lreport_top_handler_count%: The number of reports handled by the top staff member.
Statistics by Reason
- Hack:
%lreport_hack_reports%, %lreport_hack_pending%, %lreport_hack_accepted%, %lreport_hack_rejected%
- Toxic:
%lreport_toxic_reports%, %lreport_toxic_pending%, %lreport_toxic_accepted%, %lreport_toxic_rejected%
- Spam:
%lreport_spam_reports%, %lreport_spam_pending%, %lreport_spam_accepted%, %lreport_spam_rejected%
- Ad:
%lreport_ad_reports%, %lreport_ad_pending%, %lreport_ad_accepted%, %lreport_ad_rejected%
- Insult:
%lreport_insult_reports%, %lreport_insult_pending%, %lreport_insult_accepted%, %lreport_insult_rejected%
Date and Time Information
%lreport_first_report_date%: Date of the very first report on the server.
%lreport_first_report_time%: Time of the very first report on the server.
%lreport_last_report_date%: Date of the most recent report on the server.
%lreport_last_report_time%: Time of the most recent report on the server.
%lreport_last_report_datetime%: Full date and time of the last report.
%lreport_my_first_report_date%: The player's individual first report date.
%lreport_my_last_report_date%: The player's individual last report date.
System and Database
%lreport_db_total%: Total report count directly from the database.
%lreport_is_frozen%: Whether the player is currently frozen (true/false).
%lreport_frozen_count%: Total number of players currently frozen.
%lreport_plugin_version%: The current version of the L-Report plugin.
%lreport_cooldown%: The global cooldown setting from the config.
%lreport_online_players%: Number of players currently online.
Developer API Integration
Integrate L-report into your own plugin to interact with our reporting system. Follow the steps below to get started.
1. Add Repository
First, add the JitPack repository to the <repositories> section of your pom.xml file:
<repositories>
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
</repositories>
2. Add Dependency
Next, add the L-report API dependency to your <dependencies> section. Replace TAG with the version you wish to use (e.g., v1.0.0).
<dependencies>
<dependency>
<groupId>com.github.squezsaz</groupId>
<artifactId>L-report</artifactId>
<version>TAG</version>
<scope>provided</scope>
</dependency>
</dependencies>
Note: Since your plugin will require L-report at runtime, keep the scope as provided and remember to add depend: [L-report] to your plugin.yml file.
3. Usage Example
You can access the API by getting an instance through the main class:
import com.lreport.api.LReportAPI;
public class MyPlugin extends JavaPlugin {
@Override
public void onEnable() {
// Accessing the API
LReportAPI api = LReport.getApi();
if (api != null) {
int pendingReports = api.getPendingReportCount();
getLogger().info("There are currently " + pendingReports + " pending reports.");
}
}
}
API Documentation
For a detailed list of methods and descriptions, please visit our online JavaDoc page:
? L-report JavaDocs
Quick Tips:
- Version: If you want to always pull the latest code, you can use
master-SNAPSHOT as the <version>, though fixed versions like v1.0.0 are recommended for stability.
- JitPack Logs: If the dependency fails to download, check the build logs on JitPack to identify the error.
Contact
For any questions or suggestions, discord: squezsaz
Note: This plugin works on Spigot, Paper and derivatives. (1.18 - 1.21+)
评论 0
登录后参与评分
还没有评论,来抢沙发吧