# \ud83c\udf38 ReportSystem<\/p>\n
> Advanced report system for Minecraft servers with Discord integration and admin moderation tools<\/p>\n
\n
\n
\n<\/p>\n
## \u2728 Features<\/p>\n
### \ud83d\udcdd Report System
\n– **Interactive Report Creation** – Step-by-step form in Minecraft chat
\n– **Beautiful GUI** – View your reports with pagination and status tracking
\n– **Multi-language Support** – English and Russian localizations included
\n– **Spring Color Palette** – Pleasant gradients for better UX
\n– **Automatic Validation** – Checks player existence and prevents self-reports<\/p>\n
### \ud83c\udfae Discord Integration
\n– **Real-time Notifications** – Reports sent instantly to Discord channel
\n– **Interactive Buttons** – Approve, Reject, Check, and Comment directly from Discord
\n– **Punishment System** – Modal form for ban\/mute\/kick\/warn with duration
\n– **Player Check Feature** – Freeze players and call them to voice channel
\n– **Automatic Commands** – Execute punishments automatically<\/p>\n
### \u2699\ufe0f Admin Tools
\n– **Report Management** – Review, comment, and update report status
\n– **Player Freeze** – Freeze violators during verification
\n– **Voice Channel Integration** – Call players for checks via Discord
\n– **Statistics** – Track approved, rejected, and pending reports
\n– **Hot Reload** – Update configuration without server restart<\/p>\n
## \ud83d\udce6 Installation<\/p>\n
### Requirements
\n– Minecraft Server 1.21+
\n– Paper\/Spigot
\n– Java 17+
\n– Discord Bot (optional, but recommended)<\/p>\n
### Setup Steps<\/p>\n
1. **Download** the latest release from Releases<\/p>\n
2. **Install** the plugin:
\n “`bash
\n cp ReportSystem-1.0.0.jar \/path\/to\/server\/plugins\/
\n “`<\/p>\n
3. **Start** your server to generate configuration files<\/p>\n
4. **Configure Discord Bot**:
\n – Create a bot at Discord Developer Portal
\n – Enable the following intents:
\n – `MESSAGE CONTENT`
\n – `GUILD MESSAGES`
\n – `GUILD VOICE STATES`
\n – Copy the bot token<\/p>\n
5. **Edit** `plugins\/ReportSystem\/config.yml`:
\n “`yaml
\n language: “en-EN” # or “ru-RU”<\/p>\n
discord:
\n use-bot: true
\n bot-token: “YOUR_BOT_TOKEN_HERE”
\n channel-id: “YOUR_CHANNEL_ID_HERE”<\/p>\n
reports:
\n max-active-reports: 5
\n form-timeout: 300
\n history-limit: 18
\n “`<\/p>\n
6. **Restart** the server<\/p>\n
## \ud83c\udfa8 Commands<\/p>\n
### Player Commands
\n| Command | Aliases | Description | Permission |
\n|———|———|————-|————|
\n| `\/report` | `\/rep` | Create a new report | `reportsystem.report` |
\n| `\/reports` | – | View your reports | `reportsystem.reports` |
\n| `\/report help` | – | Show help | `reportsystem.report` |<\/p>\n
### Admin Commands ## \ud83d\udd10 Permissions<\/p>\n “`yaml # Player permissions # Admin permissions ## \ud83c\udfaf Usage Examples<\/p>\n ### Creating a Report<\/p>\n 1. Type `\/report` in chat ### Discord Moderation<\/p>\n #### Approve with Punishment #### Call for Check ## \ud83c\udf0d Localization<\/p>\n ### Supported Languages ### Custom Languages<\/p>\n 1. Copy `locales\/en-EN.yml` to `locales\/your-lang.yml` ### Gradient Colors<\/p>\n The plugin uses beautiful spring-themed gradients: # Mint \u2192 Fresh Green ## \ud83d\udd27 API Usage<\/p>\n ### Maven ### Example Code \/\/ Create a report programmatically \/\/ Save the report \/\/ Send to Discord ## \ud83d\udcca Statistics<\/p>\n View server-wide report statistics: ## \ud83d\udee0\ufe0f Configuration<\/p>\n ### config.yml discord: reports: ### Localization Files ## \ud83c\udfa8 Spring Color Palette<\/p>\n The plugin features a beautiful spring-themed color scheme:<\/p>\n – \ud83c\udf38 **Cherry Blossom Pink** – Headers and prefixes ## \ud83d\udc1b Troubleshooting<\/p>\n ### Discord Bot Not Working ### Player Can’t Create Reports ### Voice Check Not Working ## \ud83d\udcdd Changelog<\/p>\n ### Version 1.0.0 ## \ud83e\udd1d Contributing<\/p>\n Contributions are welcome! Please feel free to submit a Pull Request.<\/p>\n 1. Fork the repository ## \ud83d\udcdc License<\/p>\n This project is licensed under the MIT License – see the [LICENSE](LICENSE) file for details.<\/p>\n ## \ud83d\udc96 Credits<\/p>\n – **Author**: Lolka12321 ## \u2b50 Show Your Support<\/p>\n Give a \u2b50\ufe0f if this project helped you!<\/p>\n —<\/p>\n Made with \ud83d\udc9a for the Minecraft community<\/p>\n","protected":false},"excerpt":{"rendered":" Advanced report system with Discord integration<\/p>\n","protected":false},"featured_media":161110,"template":"","meta":{"_minecraft_slug":"udmr","_minecraft_project_id":"CWZTKek0","_minecraft_author":"Lolka12321","_minecraft_license":"MIT","_minecraft_downloads":8,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"udmr.zip","_minecraft_size_bytes":14421809,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T23:19:49.428292Z","_minecraft_date_created":"2026-01-30T05:05:07.221771Z","_minecraft_date_modified":"2026-01-28T00:59:14.050780Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/udmr","_minecraft_icon_attachment_id":161110,"_minecraft_imported_at":"2026-06-09T15:14:39+00:00","_minecraft_import_hash":"2a706f598a174cfedd6e3eeab38e9649","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,126,127,867,129,92],"mod_loader":[130,131,132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-161109","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-management","mod_category-paper","mod_category-social","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n| Command | Description | Permission |
\n|———|————-|————|
\n| `\/report reload` | Reload configuration | `reportsystem.admin.reload` |
\n| `\/unfreeze
\n# Full access
\nreportsystem.*<\/p>\n
\nreportsystem.report # Create reports
\nreportsystem.reports # View own reports<\/p>\n
\nreportsystem.admin # Access to all admin commands
\nreportsystem.admin.reload # Reload configuration
\nreportsystem.admin.stats # View statistics
\n“`<\/p>\n
\n2. Enter violator’s nickname
\n3. Enter reason for report
\n4. Add additional details or type ‘skip’
\n5. Confirm by clicking `[YES]` button<\/p>\n
\n1. Click `Approve` button
\n2. Fill the modal form:
\n – **Punishment Type**: `ban`, `mute`, `kick`, or `warn`
\n – **Duration**: `30m`, `7d`, `1y`, or `permanent`
\n – **Reason**: Additional details
\n3. Player is automatically punished<\/p>\n
\n1. Join a voice channel in Discord
\n2. Click `Check` button
\n3. Player is frozen in-game
\n4. Player receives notification with voice channel name
\n5. Conduct verification
\n6. Use `\/unfreeze
\n– \ud83c\uddec\ud83c\udde7 English (`en-EN`)
\n– \ud83c\uddf7\ud83c\uddfa Russian (`ru-RU`)<\/p>\n
\n2. Translate all strings
\n3. Set `language: “your-lang”` in `config.yml`<\/p>\n
\n“`yaml
\n# Cherry Blossom \u2192 Peach
\nprefix: “
\nreport-success: “
\n“`<\/p>\n
\n“`xml
\n
\n
\n
\n<\/repository><\/p>\n
\n
\n
\n
\n<\/dependency>
\n“`<\/p>\n
\n“`java
\n\/\/ Get the plugin instance
\nReportSystem plugin = ReportSystem.getInstance();<\/p>\n
\nReport report = new Report(
\n “REP-” + System.currentTimeMillis(),
\n player.getUniqueId(),
\n player.getName(),
\n “Griefer123”,
\n UUID.fromString(“…”),
\n “Griefing”,
\n “Destroyed spawn area”
\n);<\/p>\n
\nplugin.getDataManager().saveReport(report);<\/p>\n
\nplugin.getDiscordBot().sendReport(report);
\n“`<\/p>\n
\n“`
\n=== Report Statistics ===
\nTotal reports: 156
\nApproved: 89
\nRejected: 45
\nPending: 22
\n“`<\/p>\n
\n“`yaml
\nlanguage: “en-EN”<\/p>\n
\n use-bot: true
\n bot-token: “YOUR_TOKEN”
\n channel-id: “YOUR_CHANNEL_ID”<\/p>\n
\n max-active-reports: 5 # Maximum pending reports per player
\n form-timeout: 300 # Form timeout in seconds (0 = no timeout)
\n history-limit: 18 # Reports per page in GUI
\n“`<\/p>\n
\n– `locales\/en-EN.yml` – English translations
\n– `locales\/ru-RU.yml` – Russian translations<\/p>\n
\n– \ud83c\udf51 **Peach** – Warnings and timeouts
\n– \ud83d\udc9c **Lavender** – Questions and info
\n– \ud83c\udf3f **Mint Green** – Success messages
\n– \u2705 **Fresh Green** – Approvals<\/p>\n
\n1. Check bot token in `config.yml`
\n2. Verify bot has required intents enabled
\n3. Ensure channel ID is correct
\n4. Check bot has permissions in the channel<\/p>\n
\n1. Check permission: `reportsystem.report`
\n2. Verify they haven’t reached max reports limit
\n3. Check if report system is available (Discord connected)<\/p>\n
\n1. Ensure `GUILD_VOICE_STATES` intent is enabled
\n2. Admin must be in a voice channel
\n3. Player must be online
\n4. Check bot permissions<\/p>\n
\n– Initial release
\n– Report creation system
\n– Discord integration with buttons
\n– Punishment modal system
\n– Player freeze and check feature
\n– Multi-language support
\n– Spring color palette
\n– GUI with pagination<\/p>\n
\n2. Create your feature branch (`git checkout -b feature\/AmazingFeature`)
\n3. Commit your changes (`git commit -m ‘Add some AmazingFeature’`)
\n4. Push to the branch (`git push origin feature\/AmazingFeature`)
\n5. Open a Pull Request<\/p>\n
\n– **Discord Integration**: JDA Library
\n– **Color System**: Adventure API
\n– **Inspired by**: Community feedback and suggestions<\/p>\n