PurplePunish

️ 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!