🛡️ PurplePunish

A complete, multi-platform moderation solution for Minecraft servers

PurplePunish is a powerful and flexible punishment management plugin designed for server administrators and moderation teams. Built to work seamlessly across multiple platforms, it provides everything you need to maintain order and enforce server rules efficiently.

---

✨ Key Features

📋 Complete Moderation Commands

• Ban & Unban players with automatic IP tracking
• Ban IP to prevent alternate account usage
• Mute & Unmute players to restrict chat
• Warn & Unwarn players with warning management
• Kick players instantly
• View history, banlist, and active punishments
• Check player status across all sanctions

🎯 Intelligent Autocomplete

• Predefined reasons with smart multi-word suggestions
• Automatic duration suggestions based on reason
• Tab-completion support for efficient command input

🌍 Multi-Language Support

• 100% customizable messages (English by default, French included)
• Easy locale switching via configuration
• Support for any language through message files

💾 Flexible Data Storage

• SQLite for standalone servers (default, no setup required)
• MySQL for networked environments (via HikariCP connection pooling)
• Automatic schema generation on first run
• Complete punishment history with active/expired flags

🔄 Real-Time Synchronization

• Optional Redis pub/sub integration for multi-server networks
• Instant punishment application across all connected servers
• Server identification to prevent message loops
• Support for both proxy and backend synchronization

📢 Discord Integration

• Automatic webhook notifications for all moderation actions
• Color-coded embeds:
  • 🔴 Red for bans
  • 🟡 Yellow for mutes
  • 🟠 Orange for warnings
  • 🔵 Blue for kicks
  • 🟢 Green for revocations
• Player avatars, operator name, duration, reason, and timestamp
• Customizable webhook URL and bot name

🎨 Interactive GUI

• /historygui command to view player punishment history in-game
• Inventory-based interface with pagination
• Previous/next buttons for easy navigation
• Page indicators and player head display

🔐 Flexible Deployment

• Universal JAR (recommended) - works on Spigot, Paper, BungeeCord, AND Velocity
• Platform auto-detection
• Individual JARs available for specific platforms
• Compact ~5 MB file size

🔧 Smart Permission System

• Granular control over moderation actions
• Bundle permissions for quick setup
• Admin tools and reload capabilities

⚙️ Proxy Mode Support

Two command modes to avoid conflicts:

• Base mode: /ban, /mute, /warn, /kick...
• Prefix mode: /pban, /pmute, /pwarn, /pkick...

---

🚀 Quick Start

1. Download the universal JAR from the releases page
2. Place it in your plugins/ directory
3. Start your server
4. Configure config.yml (default SQLite, no setup required!)
5. Use moderation commands - they work immediately

---

📝 Supported Durations

5s, 10m, 2h, 7d, 2w, 1y | Combinations: 1h30m, 2w 3d perm or permanent for indefinite sanctions

---

🔓 Permissions

Permission	Description
purplepunish.*	Full access
purplepunish.staff	Complete moderation bundle
purplepunish.ban	Ban players
purplepunish.banip	Ban IP addresses
purplepunish.mute	Mute players
purplepunish.warn	Warn players
purplepunish.kick	Kick players
purplepunish.history	View punishment history
purplepunish.check	Check player status
purplepunish.notify	Receive staff notifications

---

💡 Why PurplePunish?

✅ Works everywhere - Spigot, Paper, BungeeCord, Velocity all supported
✅ Zero configuration - SQLite works out of the box
✅ Enterprise ready - MySQL + Redis for large networks
✅ Fully customizable - All messages, colors, and behaviors
✅ Modern UX - GUI, autocomplete, and Discord integration
✅ Actively maintained - Regular updates and support

---

📄 License

Public and open-source. Free to use and modify.

---

Keep your server safe and organized with PurplePunish!