VeltrixBanned

by P0KEM0N · Veltrix Studio

Advanced punishment system with bans, mutes, warnings, alt detection, proxy sync & PlaceholderAPI

Features

• Bans — Player & IP, permanent or temporary
• Mutes — Chat blocking with auto-expire
• Warnings — With configurable auto-punishment
• Alt Detection — Alerts staff on alt accounts
• Offline Support — Ban players who never joined
• Proxy Sync — BungeeCord / Velocity
• PlaceholderAPI — 15+ placeholders
• Async Database — Zero TPS drop
• HikariCP — Fast, memory-safe pool
• Unified DB — Single veltrixbanned.db
• Auto-Cleanup — Expired punishments removed
• Punishment History — Permanent log

Commands

Bans

/ban <player> <time> <reason>
/tempban <player> <time> <reason>
/banip <player> <time> <reason>
/unban <player>
/unban-ip <player>

Mutes

/mute <player> <time> <reason>
/tempmute <player> <time> <reason>
/unmute <player>

Warnings

/warn <player> <reason>
/warnings <player>
/unwarn <player> <index>

**Admin**

/veltrixbanned help /veltrixbanned reload /veltrixbanned banlist /veltrixbanned alts

##  Permissions

veltrixbanned.ban veltrixbanned.tempban veltrixbanned.ban.ip veltrixbanned.unban veltrixbanned.unban.ip veltrixbanned.mute veltrixbanned.tempmute veltrixbanned.unmute veltrixbanned.warn veltrixbanned.warnings veltrixbanned.unwarn veltrixbanned.alts veltrixbanned.alts.notify veltrixbanned.reload veltrixbanned.admin

##  Time Format

s = seconds m = minutes h = hours d = days w = weeks M = months y = years perm = permanent

**Example:** `1d12h` → 1 day 12 hours


##  Installation

1. Drop `VeltrixBanned-2.0.1.jar` into `plugins/`
2. Restart server
3. Configure files in `plugins/VeltrixBanned/`
4. (Optional) Install PlaceholderAPI


##  Requirements

Paper / Spigot 1.21.x Java 17+ ◦ PlaceholderAPI 2.11+ (optional)

##  Placeholders

%veltrixbanned_banned% %veltrixbanned_ban_reason% %veltrixbanned_ban_expires% %veltrixbanned_muted% %veltrixbanned_mute_reason% %veltrixbanned_mute_expires% %veltrixbanned_warning_count% %veltrixbanned_has_warnings%

---


*Built with ▸ by **Veltrix Studio** · Building Better Servers*