L-Report | Advanced Player Report System
L-Report is a fully featured and advanced player reporting plugin for Spigot, Paper, Purpur and all compatible forks.
It allows players to report rule breakers through a modern GUI system while giving staff powerful moderation tools.

Main Features
Report System
✔ Easy GUI based report menu
✔ Report players instantly with /report <player>
✔ Support for reporting offline players (optional)
✔ Add custom evidence / proof text while reporting
✔ Smart duplicate protection system
✔ Re-report cooldown system
✔ Daily report limits per player
✔ Personal report history menu
✔ A system where players can receive rewards for their accepted reports
Report Reasons Included
✔ Hack
✔ Toxic
✔ Spam
✔ Advertising
✔ Insult
✔ Other

Staff Tools
✔ Powerful admin management panel
✔ View all pending reports
✔ Accept reports
✔ Reject reports
✔ Delete reports
✔ Search reports by player
✔ View statistics panel
✔ Freeze reported players
✔ Receive instant report notifications

Data & Performance
✔ SQLite database included
✔ Fast and lightweight
✔ Auto-generated files
✔ Safe persistent storage

Extra Integrations
✔ Discord Webhook support
✔ PlaceholderAPI support
✔ Multi-language system
✔ Turkish & English included

Installation
1. Download Plugin
Download the latest L-Report.jar

2. Move File
Place the file into:

plugins/

3. Start Server
Restart the server or use:

/reload

4. Finished
Plugin files will be automatically created.

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 files


Commands
Player Commands
Command Description
/report Opens main report menu
/report <player> Report an online player
/report <playername> Report offline player (if enabled)
Admin Commands
Command Description
/reportadmin Opens admin panel
/reportadmin search <player> Search reports of player
/reportadmin stats Show plugin statistics
/report reload Reload config and language files
/report lang tr Change language to Turkish
/report lang en Change language to English
Permissions
Permission Description
lreport.player Allows player report commands
lreport.admin Allows admin panel & management
Full Config
# ============================================
# 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
# %player% = Reporter's name
# console: true = Run as console
# 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 Webhook Integration
Send automatic notifications directly to your Discord server.

Setup

1. Open Discord Server Settings
   
   
2. Go to Integrations
   
   
3. Click Webhooks
   
   
4. Create New Webhook
   
   
5. Copy webhook URL
   
   
6. Paste into config:

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

Supported Webhook Events
✔ New Report Created
✔ Report Accepted
✔ Report Rejected
✔ Report Deleted

Embed Colors
Event Color HEX
New Report Orange 15105570
Accepted Green 5767199
Rejected Red 15548984
Deleted Yellow 16440904
Database
Default Storage: SQLite
Stored automatically in:

plugins/L-report/lreport.db

No MySQL setup required.

PlaceholderAPI Support
L-Report includes a huge amount of placeholders.

General Statistics
%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%

Personal Player Statistics
%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%
%lreport_my_acceptance_rate%
%lreport_my_cooldown%

Leaderboards
%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%

Reason Statistics
%lreport_hack_reports%
%lreport_toxic_reports%
%lreport_spam_reports%
%lreport_ad_reports%
%lreport_insult_reports%

Date / Time
%lreport_first_report_date%
%lreport_last_report_date%
%lreport_last_report_datetime%
%lreport_my_first_report_date%
%lreport_my_last_report_date%

System
%lreport_db_total%
%lreport_is_frozen%
%lreport_frozen_count%
%lreport_plugin_version%
%lreport_cooldown%
%lreport_online_players%

Languages
Included by default:

✔ English
✔ Turkish

Fully editable language files.

FAQ
Plugin not working?
Check console for errors first.

GUI not opening?
Check permission nodes.

Language file not updating?
Delete language folder and restart server.

Discord webhook not working?
Make sure:

webhook-enabled: true

and URL is valid.

Why Choose L-Report?
✔ Professional report workflow
✔ Clean GUI menus
✔ Staff efficiency increase
✔ Discord integration
✔ Detailed statistics
✔ Lightweight & optimized
✔ Easy setup
✔ Modern moderation solution

Contact
For questions or suggestions:

Discord: squezsaz

License
MIT License