Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for Lolka12321

Ultimate Discord Minecraft Reporter

Report UDMR?

Release
1.0

Lolka12321 released UDMR version 1.0 on January 28, 2026

ReportSystem

Advanced report system with Discord integration

https://img.shields.io/badge/Minecraft-1.21-brightgreen.svg https://img.shields.io/badge/Paper-Required-blue.svg https://img.shields.io/badge/Discord-Integration-7289da.svg

✨ FEATURES

Report System

  • Interactive Report Creation - Step-by-step form directly in Minecraft chat
  • Beautiful GUI - View your reports with pagination and real-time status
  • Multi-language Support - English and Russian localizations included
  • Spring Color Palette - Pleasant gradients for better user experience
  • Smart Validation - Automatic player existence check and self-report prevention

Discord Integration

  • Real-time Notifications - Reports sent instantly to your Discord channel
  • Interactive Buttons - Approve, Reject, Check, and Comment directly from Discord
  • Punishment System - Modal form for ban/mute/kick/warn with custom duration
  • Player Check Feature - Freeze players and call them to voice channel for verification
  • Automatic Execution - Punishments are executed automatically

⚙️ Admin Tools

  • Report Management - Review, comment, and update report status
  • Player Freeze - Freeze violators during verification process
  • Voice Integration - Call players for checks via Discord voice channels
  • Statistics - Track approved, rejected, and pending reports
  • Hot Reload - Update configuration without server restart

INSTALLATION

Requirements:

  • Minecraft Server 1.21+
  • Paper or Spigot
  • Java 17+
  • Discord Bot (optional, but highly recommended)

Setup Guide:

click to expand installation guide

Step 1: Download the plugin Download the latest version and place it in your plugins/ folder

Step 2: Start your server This will generate the configuration files

Step 3: Create Discord Bot

  • Go to Discord Developer Portal
  • Create a new application
  • Go to "Bot" section and create a bot
  • Enable these intents:
    • MESSAGE CONTENT
    • GUILD MESSAGES
    • GUILD VOICE STATES
  • Copy the bot token

Step 4: Configure the plugin Edit plugins/ReportSystem/config.yml:


# language: "en-EN"  or "ru-RU"

discord:
  use-bot: true
  bot-token: "YOUR_BOT_TOKEN_HERE"
  channel-id: "YOUR_CHANNEL_ID_HERE"

reports:
  max-active-reports: 5
  form-timeout: 300
  history-limit: 18

Step 5: Restart the server Your report system is now ready to use!

COMMANDS & PERMISSIONS

Player Commands

[TR] [TH]Command[/TH] [TH]Aliases[/TH] [TH]Description[/TH] [TH]Permission[/TH] [/TR] [TR] [TD]/report[/TD] [TD]/rep[/TD] [TD]Create a new report[/TD] [TD]reportsystem.report[/TD] [/TR] [TR] [TD]/reports[/TD] [TD]-[/TD] [TD]View your reports[/TD] [TD]reportsystem.reports[/TD] [/TR] [TR] [TD]/report help[/TD] [TD]-[/TD] [TD]Show help menu[/TD] [TD]reportsystem.report[/TD] [/TR]

Admin Commands

[TR] [TH]Command[/TH] [TH]Description[/TH] [TH]Permission[/TH] [/TR] [TR] [TD]/report reload[/TD] [TD]Reload configuration[/TD] [TD]reportsystem.admin.reload[/TD] [/TR] [TR] [TD]/unfreeze [/TD] [TD]Unfreeze a player after check[/TD] [TD]reportsystem.admin[/TD] [/TR]

Permissions


# Full access to all features
reportsystem.*

# Player permissions
# reportsystem.report         Create reports
# reportsystem.reports        View own reports

# Admin permissions
# reportsystem.admin          Access to all admin commands
# reportsystem.admin.reload   Reload plugin configuration

HOW TO USE

Creating a Report

step-by-step guide
  • Type /report in chat
  • Enter the violator's nickname when prompted
  • Enter the reason for the report
  • Add additional details or type 'skip' to skip
  • Review your report information
  • Click the [YES] button to submit

https://i.imgur.com/report-creation-example.gif

Discord Moderation

moderation features

Approve with Punishment:

  • Click the Approve button in Discord
  • Fill out the punishment modal:
    • Punishment Type: ban, mute, kick, or warn
    • Duration: 30m, 7d, 1y, or permanent
    • Reason: Additional details
  • The player is automatically punished

Call for Check:

  • Join a voice channel in Discord
  • Click the Check button
  • The player is frozen in-game
  • Player receives notification with your voice channel name
  • Conduct your verification
  • Use /unfreeze when done

https://i.imgur.com/discord-buttons-example.png

LOCALIZATION

Supported Languages

  • English (en-EN)
  • Russian (ru-RU)

Custom Languages

You can easily add your own language!

how to add a custom language
  • Copy locales/en-EN.yml to locales/your-lang.yml
  • Translate all strings in the file
  • Set language: "your-lang" in config.yml
  • Reload the plugin with /report reload

Color Gradients

The plugin uses beautiful spring-themed gradients:


# Cherry Blossom → Peach
prefix: "<gradient:#FFB7C5:#FFDAB9>[Report]</gradient>"

# Mint → Fresh Green
success: "<gradient:#98FB98:#7FFF00>Report submitted!</gradient>"

SPRING COLOR PALETTE

The plugin features a beautiful, eye-friendly color scheme:

  • Cherry Blossom Pink - Headers and prefixes
  • Peach - Warnings and pending status
  • Lavender - Questions and information
  • Mint Green - Process indicators
  • Fresh Green - Success and approvals

⚙️ CONFIGURATION

config.yml


# Language (en-EN, ru-RU)
language: "en-EN"

# Discord settings
discord:
  use-bot: true
  bot-token: "YOUR_BOT_TOKEN_HERE"
  channel-id: "YOUR_CHANNEL_ID_HERE"

# Report settings
reports:
#   max-active-reports: 5    Maximum pending reports per player
#   form-timeout: 300         Form timeout in seconds (0 = no timeout)
#   history-limit: 18         Reports shown per page in GUI

TROUBLESHOOTING

discord bot not working

Solution:

  • Check bot token in config.yml
  • Verify bot has required intents enabled in Discord Developer Portal
  • Ensure channel ID is correct
  • Check bot has permissions to send messages and embeds in the channel
player can't create reports

Solution:

  • Check they have reportsystem.report permission
  • Verify they haven't reached max reports limit (max-active-reports in config)
  • Check if Discord bot is connected (look in server console)
voice check not working

Solution:

  • Ensure GUILD_VOICE_STATES intent is enabled in Discord Developer Portal
  • Admin must be in a voice channel when clicking the button
  • Player must be online on the server
  • Check bot has voice state permissions

CHANGELOG

Version 1.0 (Latest)

  • Initial release
  • Interactive report creation system
  • Discord integration with interactive buttons
  • Punishment modal with custom duration
  • Player freeze and voice check feature
  • Multi-language support (English, Russian)
  • Beautiful spring color palette
  • Paginated GUI for viewing reports
  • Statistics tracking
  • Hot reload support

SUPPORT

Need help?

⭐ REVIEWS

If you like this plugin, please leave a ⭐ 5-star review!

It helps me a lot and motivates me to continue development!

LICENSE

This plugin is licensed under the MIT License. You are free to use, modify, and distribute it.

Made with for the Minecraft community

Created by Lolka12321

Information

Published onJanuary 28, 2026
Downloads2

Platforms

Paper Paper (1.21-1.21.11)
Waterfall Waterfall (1.21)
Velocity Velocity (3.5)