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.