hReport - Advanced Player Reporting with Discord & Database Integration
Tired of managing player reports through clunky commands or external forms? Streamline your server's moderation with hReport!
hReport is an advanced, highly configurable player reporting system designed for Spigot & Paper servers (1.16+). It allows players to easily report suspicious behavior, rule-breaking, or other issues directly in-game. Staff members can then efficiently manage these reports through a powerful Discord integration or via in-game commands, with the optional ability to log everything to a MySQL database.
Built with performance and ease-of-use in mind, hReport aims to be a comprehensive, license-free solution for server communities.
Key Features:
- Simple In-Game Reporting: Players use the intuitive
/report <player> [reason] [proof_url] command. Reason and proof URL (e.g., image/video link) are optional but encouraged.
- Instant Discord Notifications: Receive detailed reports immediately in a designated Discord channel. No more missed reports!
- Rich Embed Information: Discord embeds include:
- Reporting Player & Target Player (with UUIDs)
- Report Reason & optional Proof Link
- Timestamp
- Configurable number of recent chat messages from the target player for context.
- Report Status (Pending, Processed, Invalid)
- Interactive Discord Management: Staff can manage reports directly within Discord using interactive buttons on the report embed:
- Quickly mark reports as valid or invalid.
- Initiate punishment procedures (configurable).
- Execute Punishments via Discord: Define your server's punishment commands (kick, mute, tempban, warn, custom commands, etc.) in
config.yml. Staff can trigger these commands directly from Discord for reported players, using placeholders for player name, UUID, reason, staff name, and report ID.
- Optional MySQL Database Logging: Enable database support in the config to keep a persistent history of all reports, their status, and how they were handled. Perfect for tracking and accountability. (Table created automatically).
- Highly Configurable: Customize almost every aspect:
- Enable/disable Discord and Database features independently.
- Configure all messages (with color code support
&) in messages.yml.
- Set up Discord Bot Token, Guild ID, Channel ID.
- Define all punishment commands executed from Discord.
- Set a cooldown for the
/report command.
- Customize embed appearance (Title, Description, Colors for different statuses - via
messages.yml).
- PlaceholderAPI Support: Use PAPI placeholders in configurable messages for added context.
- Reload Command: Apply configuration changes instantly with
/hreport reload (requires permission).
- (Planned/Optional) In-Game Management: Commands for staff to list and view reports directly in Minecraft.
- Free to Use: No license key or payment required for the core features.
Commands & Permissions:
/report <player> [reason] [proof_url] - Reports a player.
- Permission:
hreport.report (Default: true)
/hreport reload - Reloads the configuration files.
- Permission:
hreport.admin (Default: op)
- (Planned/Future:
/hreport list, /hreport view <id>, etc. for in-game management)
- Permission:
hreport.view (Default: op)
hreport.notify - Allows staff to receive in-game notifications when a new report is created. (Default: op)
Dependencies:
