L-Report

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

Features
Installation
Commands
Permissions
Config Settings
Discord Integration
FAQ
License
PlaceholderAPI

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

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

Contact

For any questions or suggestions, discord: squezsaz

Note: This plugin works on Spigot, Paper and derivatives. (1.18 - 1.21+)

L-report