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.