Punish Velocity
A modern, scalable and production-ready punishment system for Velocity networks.
SiuuuHD-Punish is designed for professional Minecraft servers and provides a clean moderation workflow with automatic punishments, escalation handling, full history tracking, and Discord integration.
✨ Features
- Velocity support
- Minecraft 1.21+ compatibility
- Java 21 requirement
- MySQL / MariaDB / SQLite support
- HikariCP connection pooling
- LuckPerms integration
- Adventure MiniMessage support
- Discord webhook integration
- Network-wide punishment handling
- Offline player support
- UUID-based data storage
- Fully configurable system
- Automatic punishment escalation
- Staff notifications & alerts
- Professional ban screens
- Production-ready architecture
⚖️ Punishment System
Simple and fast moderation:
/punish
Example: /punish Notch HACKING
Punishments are automatically applied based on configuration:
HACKING: type: BAN duration: 14d
No manual duration handling required.
🧾 Commands
/punish /pun /lookup /banlist /punish reload
🔍 Player Lookup
Access detailed moderation data:
- Ban / Mute / Warn / Kick counts
- Active punishments
- Full punishment history
- First & last join
- Last seen status
- Staff actions
📈 Automatic Escalation
Progressive punishment system:
BELEIDIGUNG: type: MUTE escalation: - 1h - 6h - 1d - 7d
The system automatically increases punishment duration based on previous offenses.
💬 MiniMessage Support
Fully supports Adventure MiniMessage:
- Colors & gradients
- Hover & click events
- Advanced formatting
- Fully customizable messages
No hardcoded text.
🔗 Discord Integration
Staff Webhooks:
- Ban logs
- Mute logs
- Warn logs
- Unban / unmute logs
Public announcements:
- Ban announcements
- Mute announcements
- Security alerts
🗄️ Database Support
- MySQL
- MariaDB
- SQLite
All data is stored using UUIDs for maximum consistency.
🎮 Designed For
- Survival servers
- Minigame networks
- Practice servers
- Large Velocity networks
- Professional Minecraft communities
⚙️ Requirements
- Velocity Proxy
- Java 21
- Minecraft 1.21+
🚀 Why Punish Velocity?
Unlike traditional moderation plugins, Siuuuhd-Punish focuses on:
- Simplicity for staff
- Automatic decision handling
- High scalability
- Clean configuration-based logic
Staff only select a reason — everything else is handled automatically.
