# **UDMR - Ultimate Discord Minecraft Reporter** Advanced report system with Discord integration ![https://img.shields.io/badge/Minecraft-1.21-brightgreen.svg](https://img.shields.io/badge/Minecraft-1.21-brightgreen.svg) ![https://img.shields.io/badge/Paper-Required-blue.svg](https://img.shields.io/badge/Paper-Required-blue.svg) ![https://img.shields.io/badge/Discord-Integration-7289da.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](https://discord.com/developers/applications) * 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](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](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: "[Report]" # Mint → Fresh Green success: "Report submitted!" ``` ## **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](https://discord.gg/yourserver) * **Bug Reports:** [GitHub Issues](https://github.com/yourusername/reportsystem/issues) * **Documentation:** [Wiki](https://github.com/yourusername/reportsystem/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***

Lolka12321

Lolka12321's Plugins

UDMR by Lolka12321

PassportPlugin by Lolka12321

Lolka12321's Organizations

Stars

Watching

UDMR by

PassportPlugin by