L-report v1.1.6

Player Reporting Plugin with GUI (Discord WebHook integration)
L-Report



Advanced Minecraft reporting system that allows players to report other players via GUI.





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
Code:
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

YAML:
# ============================================
# 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

# ============================================
# 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

1. Open Discord server settings
2. Go to Integrations > Webhooks > New Webhook
3. Copy the webhook URL
4. Paste into config file:

YAML:
webhook-enabled: true
webhook-url: "https://discord.com/api/webhooks/xxxxx/xxxxx"

Embed Appearance

Code:
: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:

XML:
<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).

XML:
<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:

Java:
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+)
EULA: Free EULA
142 Views
4 Downloads
Apr 28, 2026 Published
May 7, 2026 Updated
Not yet rated
81.6 KB File size
Open source
  1. Yes
DRM-free
  1. Yes
Unobfuscated
  1. Yes
Type
  1. Gameplay
  1. Staff
  1. GUI
Game mode
  1. Hub & lobby
Supported software
  1. Bukkit
  1. Spigot
  1. Paper
  1. Folia
  1. Purpur
Supported versions
  1. 1.21.11
  1. 1.21.8
  1. 1.21.5
  1. 1.21.4
  1. 1.21.2
  1. 1.21
  1. 1.20
  1. 1.19
  1. 1.18
Supported languages
  1. English
  1. Turkish
Creator
Struggling to cover the costs of your server? Set up your own webstore with Tebex in under 30 seconds.
Host a lag-free Minecraft or Hytale server in minutes.
Get 25% off your first order with our link.
Recommended for you
#1 BuiltByBit Plugin ~ Protects your server from crash packet exploits ~ Folia Support
5.00 star(s) 141 ratings
4,202 purchases
Create items, blocks, mobs, emojis, and more with automatic resourcepack generation!
5.00 star(s) 53 ratings
3,160 purchases
Protect your server from crash/dupe/packet exploits with the ultimate security fix plugin.
5.00 star(s) 44 ratings
3,088 purchases
High Performance | Customizable | Cross-Version | GeyserMC | Folia Support
4.50 star(s) 71 ratings
2,812 purchases
All-in-one dungeon creator. Create unlimited, timed dungeon experiences with your own builds
4.50 star(s) 72 ratings
2,579 purchases
142 Views
4 Downloads
Apr 28, 2026 Published
May 7, 2026 Updated
Not yet rated
81.6 KB File size
Open source
  1. Yes
DRM-free
  1. Yes
Unobfuscated
  1. Yes
Type
  1. Gameplay
  1. Staff
  1. GUI
Game mode
  1. Hub & lobby
Supported software
  1. Bukkit
  1. Spigot
  1. Paper
  1. Folia
  1. Purpur
Supported versions
  1. 1.21.11
  1. 1.21.8
  1. 1.21.5
  1. 1.21.4
  1. 1.21.2
  1. 1.21
  1. 1.20
  1. 1.19
  1. 1.18
Supported languages
  1. English
  1. Turkish
Creator
Struggling to cover the costs of your server? Set up your own webstore with Tebex in under 30 seconds.
Host a lag-free Minecraft or Hytale server in minutes.
Get 25% off your first order with our link.
Recommended for you
#1 BuiltByBit Plugin ~ Protects your server from crash packet exploits ~ Folia Support
5.00 star(s) 141 ratings
4,202 purchases
Create items, blocks, mobs, emojis, and more with automatic resourcepack generation!
5.00 star(s) 53 ratings
3,160 purchases
Protect your server from crash/dupe/packet exploits with the ultimate security fix plugin.
5.00 star(s) 44 ratings
3,088 purchases
High Performance | Customizable | Cross-Version | GeyserMC | Folia Support
4.50 star(s) 71 ratings
2,812 purchases
All-in-one dungeon creator. Create unlimited, timed dungeon experiences with your own builds
4.50 star(s) 72 ratings
2,579 purchases
Top