UDMR - Ultimate Discord Minecraft Reporter
Advanced report system with Discord integration
✨ 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
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
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?
- Discord: Join our server
- Bug Reports: GitHub Issues
- Documentation: Wiki
- Discussion: Use the discussion tab on this resource
⭐ 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
Pinned Versions
Pages
Members
