Punish System

# DiscordPunishBot v2.0.0 🇹🇷 **(#türkçe-readme)** | 🇺🇸 **(#english-readme)** --- ## 🇺🇸 English README **A professional punishment, appeal, and report management system plugin for Minecraft servers with advanced Discord integration.** ## ✨ Key Features ### 🤖 **Advanced Discord Integration** - **Interactive Button System**: Approve/reject appeals and reports directly from Discord - **Rich Embed Messages**: Beautiful, detailed embed messages with status colors - **Slash Commands**: Full Discord slash command support for all punishment types - **Role-Based Permissions**: Assign specific Discord roles for different operations - **Real-Time Notifications**: Instant Discord notifications for new appeals/reports - **Multi-Channel Support**: Separate channels for logs, appeals, and reports ### ⚖️ **Complete Appeal System** - **Appeal Commands**: `/appeal`, `/appeal list`, `/appeal status <id>` - **Interactive Discord Buttons**: Approve, reject, or investigate appeals from Discord - **Appeal Status Tracking**: Pending, Under Review, Approved, Rejected - **Automatic Notifications**: Players get notified of appeal decisions - **Cooldown System**: 24-hour cooldown between appeals - **Admin Response System**: Admins can add responses to appeal decisions ### 📋 **Advanced Report System** - **Report Commands**: `/report <player> <reason>`, `/report anonymous <player> <reason>` - **Interactive Moderation**: Approve, reject, or investigate reports from Discord - **Priority Levels**: Low, Medium, High, Urgent, Critical with color coding - **Anonymous Reports**: Complete privacy protection for reporters - **Status Tracking**: Pending, Under Review, Investigating, Resolved, Dismissed, Duplicate - **Cooldown Management**: 5-minute cooldown between reports ### 🎁 **Configurable Reward System** - **Console Command Rewards**: Execute any console command as reward - **Flexible Configuration**: Different rewards for correct reports/appeals - **Automatic Distribution**: Rewards given automatically upon approval - **Custom Messages**: Configurable reward notification messages ### 🗄️ **Database & Performance** - **Dual Database Support**: SQLite (default) and MySQL - **Transaction Management**: Proper commit/rollback for data integrity - **Connection Pool**: Optimized database connection management - **Async Operations**: Non-blocking database operations for better performance - **Error Recovery**: Automatic error handling and recovery mechanisms ## 🚀 Installation ### 1. Requirements - **Java 17+** - **Spigot/Paper 1.20+** - **Essentials Plugin** - **Discord Bot with permissions** ### 2. Plugin Setup 1. Download `DiscordPunishBot-2.0.0.jar` 2. Place in your `plugins` folder 3. Start server (config files will be generated) 4. Stop server and configure ### 3. Discord Bot Setup 1. Go to (https://discord.com/developers/applications) 2. Create new application → Bot tab → Create bot 3. Copy bot token 4. OAuth2 → URL Generator: - **Scopes**: `bot`, `applications.commands` - **Permissions**: `Send Messages`, `Use Slash Commands`, `Read Message History`, `Manage Messages` 5. Add bot to your server using generated URL ### 4. Configuration Edit `config.yml`: ```yaml # Discord Configuration discord: token: "YOUR_BOT_TOKEN_HERE" guild-id: "YOUR_GUILD_ID_HERE" # Channel Configuration log-channel-id: "LOG_CHANNEL_ID" # General punishment logs appeal-channel-id: "APPEAL_CHANNEL_ID" # Appeal notifications report-channel-id: "REPORT_CHANNEL_ID" # Public report notifications report-log-channel-id: "REPORT_LOG_ID" # Admin report management # Admin Role Configuration report-admin-role-id: "REPORT_ADMIN_ROLE" # Role for report management appeal-admin-role-id: "APPEAL_ADMIN_ROLE" # Role for appeal management # Punishment Roles roles: mute: "MUTE_ROLE_ID" ban: "BAN_ROLE_ID" kick: "KICK_ROLE_ID" tempban: "TEMPBAN_ROLE_ID" jail: "JAIL_ROLE_ID" warn: "WARN_ROLE_ID" other: "OTHER_ROLE_ID" # Reward System Configuration reward-system: enabled: true # Commands to execute when a report is approved report-correct-commands: - "eco give %player% 100" - "tellraw %player% {\"text\":\"Thanks for the correct report! +100 coins\",\"color\":\"green\"}" # Commands to execute when an appeal is approved appeal-approved-commands: - "eco give %player% 50" - "tellraw %player% {\"text\":\"Your appeal was approved! +50 coins\",\"color\":\"green\"}" # Custom messages report-approved-message: "§a§l §7Your report was correct! You received a reward." appeal-approved-message: "§a§l §7Your appeal was approved! You received a reward." ``` ## 🎮 Commands ### Discord Slash Commands - `/mute <player> ` - Mute a player - `/ban <player> ` - Ban a player - `/kick <player> ` - Kick a player - `/tempban <player> `