ReportPlugin — Player Reporting with Discord Integration
Easily manage player reports on your server with a powerful, lightweight plugin.
Reports are stored in a database, can be viewed in-game, and are sent directly to your staff team via
Discord webhooks.
✨ Features
✔️ Players can report other players with a reason
✔️ Reports stored in a database (MySQL, SQLite, MongoDB, or file storage)
✔️ Staff can view and manage reports via
commands or a GUI
✔️ Reports automatically sent to a
Discord channel via webhook
✔️ Configurable settings via config.yml
✔️ Permission-based access control
✔️ View detailed report data for any player
Installation
- Download the plugin and place it into your /plugins folder
- Start your server to generate the default config.yml
- Configure your Discord webhook URL and database settings
- Reload or restart the server — done!
⌨️ Commands
- /report <player> [reason] → Report a player
- /reports-list → List all reports
- /report-gui → Open the management GUI
- /report-data → View detailed player report data
Permissions
- reportplugin.report → Use /report
- reportplugin.list → Use /reports-list
- reportplugin.gui → Use /report-gui
- reportplugin.reportdata → Use /report-data
- reportplugin.report.notify → Receive new report notifications
⚙️ Configuration
The plugin is highly configurable through config.yml.
Supports
Discord Webhooks with full embed customization.
Example:
Code (YAML):
useDiscordWebhook
: false
database
: filesystem
discord:
create:
webhook-url
: YOUR_WEBHOOK_URL_HERE
username
: ReportBot
avatar-url
: https://example.com/avatar.png
content
: New report received!
embed:
title
: New Report
description
: '**Reported Player:**
%ReportedPlayer%\n**Reporter:** %Reporter%\n**Reason:**
%Reason%\n**Server:** %ServerName%\n**Location:** %Location%\n**World:** %WorldName%'
url
: https://example.com
footer:
text
: 'Report ID
:
%ReporterID%'
icon-url
: https://example.com/footer-icon.png
image:
url
: https://example.com/image.png
thumbnail:
url
: https://example.com/thumbnail.png
update:
webhook-url
: YOUR_WEBHOOK_URL_HERE
username
: ReportBot
avatar-url
: https://example.com/avatar.png
content
: Report updated!
embed:
title
: Report Updated
description
: '**Reported Player:**
%ReportedPlayer%\n**Reporter:** %Reporter%\n**Reason:**
%Reason%\n**Status:** %Status%\n**Additional Info:** %AdditionalInfo%\n**Resolution
Comment:**
%ResolutionComment%\n**Server:** %ServerName%\n**Location:** %Location%\n**World:**
%WorldName%'
url
: https://example.com
footer:
text
: 'Report ID
:
%ReporterID%'
icon-url
: https://example.com/footer-icon.png
image:
url
: https://example.com/image.png
thumbnail:
url
: https://example.com/thumbnail.png
mysql:
host
: localhost
port
: 3306
database
: reports
username
: yourUsername
password
: yourPassword
sqlite:
file
: reports.db
path
: database
mongodb:
host
: localhost
port
: 27017
database
: spigotTestDB
username
: yourUsername
password
: yourPassword
# This name will be displayed in the Discord webhook and saved in the database.
server-name
: Localhost Server
# This address will be displayed in the Discord webhook and saved in the database.
server-address
: localhost
Database Support
- ✅ MySQL
- ✅ SQLite
- ✅ MongoDB
- ✅ File storage
License
Created by
FrameDev.
Do not modify or redistribute without consent.