# L-Report<\/p>\n
\n
\n<\/p>\n<\/div>\n
> Advanced Minecraft reporting system that allows players to report other players via GUI.<\/p>\n
—<\/p>\n
## Table of Contents<\/p>\n
– [Features](#features)
\n– [Installation](#installation)
\n– [Commands](#commands)
\n– [Permissions](#permissions)
\n– [Config Settings](#config-settings)
\n– [Discord Integration](#discord-integration)
\n– [FAQ](#faq)
\n– [License](#license)
\n– [PlaceholderAPI](#placeholderapi)
\n– [API Documentation](#api-documentation)<\/p>\n
—<\/p>\n
## Features<\/p>\n
| Feature | Description |
\n|———|————-|
\n| GUI Report System | Report players easily via GUI |
\n| Reason Selection | Hack, Toxic, Spam, Advertising, Insult, Other |
\n| Evidence System | Add evidence with report |
\n| Daily Limit | Daily report limit per player |
\n| Cooldown | Cooldown for re-reporting same player |
\n| Admin Panel | View all reports, accept\/reject |
\n| Statistics | View report statistics |
\n| Freeze System | Freeze reported player |
\n| Report History | View your own reports |
\n| Offline Reporting | Report offline players (configurable) |
\n| Multi-Language | Turkish and English support |
\n| Discord Webhook | Send notifications to Discord |
\n| Reward | A system where players can receive rewards for their accepted reports |<\/p>\n
—<\/p>\n
## Installation<\/p>\n
### 1. Download
\nPlace the plugin JAR file in the `plugins\/` folder.<\/p>\n
### 2. Start
\nStart the server or use `\/reload` command.<\/p>\n
### 3. Auto-Generated Files
\n“`
\nplugins\/L-report\/
\n\u251c\u2500\u2500 config.yml # Main config file
\n\u251c\u2500\u2500 lang\/
\n\u2502 \u251c\u2500\u2500 tr.yml # Turkish language file
\n\u2502 \u2514\u2500\u2500 en.yml # English language file
\n\u251c\u2500\u2500 lreport.db # SQLite database
\n\u2514\u2500\u2500 reports\/ # Report data
\n“`<\/p>\n
—<\/p>\n
## Commands<\/p>\n
### Player Commands<\/p>\n
| Command | Description | ### Admin Commands<\/p>\n | Command | Description | —<\/p>\n ## Permissions<\/p>\n | Permission | Description | —<\/p>\n ## Config Settings<\/p>\n “`yaml # Language setting # Message prefix shown before all plugin messages # Cooldown time in minutes between reporting the same player # Maximum number of reports a player can create per day # Broadcast new reports to all online admins # Notify online admins when a new report is created # Allow reporting offline players via \/report # ============================================ # Enable Discord webhook notifications # Discord webhook URL # Webhook username shown in Discord messages # Embed color (in decimal) # Which events to send to Discord # ============================================ # Database type: sqlite or mysql # MySQL settings (only if database-type: mysql) # ============================================ # Enable reward system when reports are accepted # Reward commands list (add keys: 0, 1, 2, etc.) —<\/p>\n ## Discord Integration<\/p>\n ### Setup<\/p>\n 1. Open Discord server settings “`yaml ### Embed Appearance<\/p>\n “` :bust_in_silhouette: Reporter | PlayerName L-Report Plugin | 23\/04\/2026 23:16 ### Embed Colors<\/p>\n | Event | Color | HEX | —<\/p>\n ## Database<\/p>\n ### SQLite (Default) —<\/p>\n ## FAQ<\/p>\n **Q: Plugin not working – What should I do?** **Q: GUI not opening?** **Q: Language file not working?** **Q: Discord webhook not working?** —<\/p>\n ## License<\/p>\n MIT License<\/p>\n —<\/p>\n Placeholders<\/p>\n ### General Report Statistics —<\/p>\n ### Personal Player Statistics —<\/p>\n ### Leaderboards (Top Lists) —<\/p>\n ### Statistics by Reason —<\/p>\n ### Date and Time Information —<\/p>\n ### System and Database ## Developer API Integration<\/p>\n Integrate L-report into your own plugin to interact with our reporting system. Follow the steps below to get started.<\/p>\n ### 1. Add Repository “`xml ### 2. Add Dependency “`xml > **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.<\/p>\n ### 3. Usage Example “`java public class MyPlugin extends JavaPlugin { if (api != null) { —<\/p>\n ### API Documentation —<\/p>\n ### Quick Tips: ## Contact<\/p>\n For any questions or suggestions, discord: squezsaz<\/p>\n —<\/p>\n **Note:** This plugin works on Spigot, Paper and derivatives. (1.18 – 1.21+)<\/p>\n","protected":false},"excerpt":{"rendered":" Player Reporting Plugin with GUI (Discord WebHook integration)<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"l-report","_minecraft_project_id":"8vBfyMx0","_minecraft_author":"squezsaz","_minecraft_license":"MIT","_minecraft_downloads":7,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"l-report.zip","_minecraft_size_bytes":274754,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-16T12:22:26.118678Z","_minecraft_date_created":"2026-05-02T22:53:16.480981Z","_minecraft_date_modified":"2026-05-07T13:49:14.797597Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/l-report","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-05T05:19:18+00:00","_minecraft_import_hash":"3999c618e5519251f6ac935b74a36265","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,126,127,128,867,129,123,92],"mod_loader":[130,131,132,133,134],"minecraft_version":[438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-91384","mod","type-mod","status-publish","hentry","mod_category-bukkit","mod_category-folia","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|———|————-|
\n| `\/report` | Opens main menu |
\n| `\/report
\n| `
\n|———|————-|
\n| `\/reportadmin` | Opens admin panel |
\n| `\/reportadmin search
\n| `\/reportadmin stats` | Show statistics |
\n| `\/report reload` | Reload config and language files |
\n| `\/report lang tr|en` | Change language |<\/p>\n
\n|————|————-|
\n| `lreport.player` | Can create reports |
\n| `lreport.admin` | Can use admin commands |<\/p>\n
\n# ============================================
\n# L-Report Configuration
\n# ============================================<\/p>\n
\n# Options: tr (Turkish), en (English)
\nlanguage: tr<\/p>\n
\n# Supports color codes with & character
\n# Example: “&8[&cRapor&8] &7” -> [Rapor]
\nprefix: “&8[&cRapor&8] &7”<\/p>\n
\n# Set to 0 to disable cooldown
\ncooldown: 30<\/p>\n
\n# Set to 0 for unlimited reports
\nmax-reports-per-day: 5<\/p>\n
\n# true = Enabled, false = Disabled
\nbroadcast-reports: false<\/p>\n
\n# true = Enabled, false = Disabled
\nnotify-admins: true<\/p>\n
\n# true = Enabled, false = Disabled
\nallow-offline-report: true<\/p>\n
\n# Discord Webhook Settings
\n# ============================================<\/p>\n
\n# true = Enabled, false = Disabled
\nwebhook-enabled: false<\/p>\n
\n# Get this from Discord channel settings -> Integrations -> Webhooks
\nwebhook-url: “”<\/p>\n
\nwebhook-username: “L-Report Bot”<\/p>\n
\n# Red: 15548984, Green: 5767199, Yellow: 16440904, Blue: 3447003
\nwebhook-color: 15548984<\/p>\n
\n# true = Send, false = Don’t send
\nwebhook-new-report: true
\nwebhook-report-accepted: true
\nwebhook-report-rejected: true
\nwebhook-report-deleted: false<\/p>\n
\n# Database Settings
\n# ============================================<\/p>\n
\ndatabase-type: sqlite<\/p>\n
\nmysql:
\n host: “localhost”
\n port: 3306
\n database: “lreport”
\n username: “root”
\n password: “”
\n table-prefix: “lreport_”<\/p>\n
\n# Reward System
\n# ============================================<\/p>\n
\n# true = Enabled, false = Disabled
\nreward-enabled: false<\/p>\n
\n# %player% = Reporter’s name
\n# console: true = Run as console, false = Run as player
\nreward-commands:
\n 0:
\n command: “give %player% money 100”
\n console: true
\n 1:
\n command: “crate give %player% basic 1”
\n console: true
\n“`<\/p>\n
\n2. Go to **Integrations** > **Webhooks** > **New Webhook**
\n3. Copy the webhook URL
\n4. Paste into config file:<\/p>\n
\nwebhook-enabled: true
\nwebhook-url: “https:\/\/discord.com\/api\/webhooks\/xxxxx\/xxxxx”
\n“`<\/p>\n
\n:inbox_tray: New Report Notification
\nA player has created a new report. Check the admin panel for details.<\/p>\n
\n:skull: Reported | TargetName
\n:clipboard: Reason | :crossed_swords: Hack
\n:file_folder: Evidence | evidence text
\n:shield: Handler | AdminName<\/p>\n
\n“`<\/p>\n
\n|——|——-|—–|
\n| New Report | Orange | 15105570 |
\n| Accepted | Green | 5767199 |
\n| Rejected | Red | 15548984 |
\n| Deleted | Yellow | 16440904 |<\/p>\n
\nStored in auto-generated `lreport.db` file.<\/p>\n
\n> A: First check the console for errors. Then try `\/reload`.<\/p>\n
\n> A: Check if you have `inventory` permission.<\/p>\n
\n> A: Delete the language files on server and restart.<\/p>\n
\n> A: Check if URL is correct. Make sure `webhook-enabled: true`.<\/p>\n
\n* `%lreport_total_reports%`: Total number of reports.
\n* `%lreport_pending_reports%`: Number of reports with “PENDING” status.
\n* `%lreport_accepted_reports%`: Number of reports with “ACCEPTED” status.
\n* `%lreport_rejected_reports%`: Number of reports with “REJECTED” status.
\n* `%lreport_today_reports%`: Number of reports submitted today.
\n* `%lreport_week_reports%`: Number of reports submitted this week.
\n* `%lreport_month_reports%`: Number of reports submitted this month.
\n* `%lreport_acceptance_rate%`: The overall percentage of accepted reports.
\n* `%lreport_rejection_rate%`: The overall percentage of rejected reports.
\n* `%lreport_pending_rate%`: The overall percentage of pending reports.
\n* `%lreport_most_common_reason%`: The most frequently cited reason for reports.<\/p>\n
\n* `%lreport_my_reports%`: Total reports submitted by the player.
\n* `%lreport_my_pending_reports%`: Number of pending reports submitted by the player.
\n* `%lreport_my_accepted_reports%`: Number of accepted reports submitted by the player.
\n* `%lreport_my_rejected_reports%`: Number of rejected reports submitted by the player.
\n* `%lreport_my_today_reports%`: Number of reports submitted by the player today.
\n* `%lreport_my_remaining_reports%`: Number of report attempts the player has left for today.
\n* `%lreport_my_status%`: Status of the player’s most recent report.
\n* `%lreport_my_can_report%`: Whether the player is currently allowed to create a report (`true`\/`false`).
\n* `%lreport_my_acceptance_rate%`: The acceptance rate percentage for the player’s own reports.
\n* `%lreport_my_cooldown%`: The remaining cooldown time for the player (in seconds).<\/p>\n
\n* **Reporters:**
\n * `%lreport_top_reporter%`: Name of the player who has submitted the most reports.
\n * `%lreport_top_reporter_count%`: The report count of the top reporter.
\n * `%lreport_top_reporter_2%`: Name of the 2nd rank reporter.
\n * `%lreport_top_reporter_3%`: Name of the 3rd rank reporter.
\n* **Reported Players:**
\n * `%lreport_most_reported%`: Name of the player with the most reports against them.
\n * `%lreport_most_reported_count%`: The number of reports the most reported player has received.
\n* **Staff\/Handlers:**
\n * `%lreport_top_handler%`: Name of the staff member who has handled the most reports.
\n * `%lreport_top_handler_count%`: The number of reports handled by the top staff member.<\/p>\n
\n* **Hack:** `%lreport_hack_reports%`, `%lreport_hack_pending%`, `%lreport_hack_accepted%`, `%lreport_hack_rejected%`
\n* **Toxic:** `%lreport_toxic_reports%`, `%lreport_toxic_pending%`, `%lreport_toxic_accepted%`, `%lreport_toxic_rejected%`
\n* **Spam:** `%lreport_spam_reports%`, `%lreport_spam_pending%`, `%lreport_spam_accepted%`, `%lreport_spam_rejected%`
\n* **Ad:** `%lreport_ad_reports%`, `%lreport_ad_pending%`, `%lreport_ad_accepted%`, `%lreport_ad_rejected%`
\n* **Insult:** `%lreport_insult_reports%`, `%lreport_insult_pending%`, `%lreport_insult_accepted%`, `%lreport_insult_rejected%`<\/p>\n
\n* `%lreport_first_report_date%`: Date of the very first report on the server.
\n* `%lreport_first_report_time%`: Time of the very first report on the server.
\n* `%lreport_last_report_date%`: Date of the most recent report on the server.
\n* `%lreport_last_report_time%`: Time of the most recent report on the server.
\n* `%lreport_last_report_datetime%`: Full date and time of the last report.
\n* `%lreport_my_first_report_date%`: The player’s individual first report date.
\n* `%lreport_my_last_report_date%`: The player’s individual last report date.<\/p>\n
\n* `%lreport_db_total%`: Total report count directly from the database.
\n* `%lreport_is_frozen%`: Whether the player is currently frozen (`true`\/`false`).
\n* `%lreport_frozen_count%`: Total number of players currently frozen.
\n* `%lreport_plugin_version%`: The current version of the L-Report plugin.
\n* `%lreport_cooldown%`: The global cooldown setting from the config.
\n* `%lreport_online_players%`: Number of players currently online.<\/p>\n
\nFirst, add the JitPack repository to the `
\n
\n
\n
\n
\n <\/repository>
\n<\/repositories>
\n“`<\/p>\n
\nNext, add the L-report API dependency to your `
\n
\n
\n
\n
\n
\n
\n <\/dependency>
\n<\/dependencies>
\n“`<\/p>\n
\nYou can access the API by getting an instance through the main class:<\/p>\n
\nimport com.lreport.api.LReportAPI;<\/p>\n
\n @Override
\n public void onEnable() {
\n \/\/ Accessing the API
\n LReportAPI api = LReport.getApi();<\/p>\n
\n int pendingReports = api.getPendingReportCount();
\n getLogger().info(“There are currently ” + pendingReports + ” pending reports.”);
\n }
\n }
\n}
\n“`<\/p>\n
\nFor a detailed list of methods and descriptions, please visit our online JavaDoc page:
\n\ud83d\udc49 L-report JavaDocs<\/p>\n
\n* **Version:** If you want to always pull the latest code, you can use `master-SNAPSHOT` as the `
\n* **JitPack Logs:** If the dependency fails to download, check the build logs on JitPack to identify the error.<\/p>\n