VeltrixBanned 2.0.0 — Initial Release

Welcome to the first official release of VeltrixBanned! 🎉

✨ Features

Ban System

• Player banning with custom reasons & durations
• IP banning — kicks all accounts on the target IP
• Offline player banning via Mojang API fallback
• Auto-expiration of temporary bans
• Permanent bans supported (perm time format)
• Ban history log (permanent — survives unbans)

Alt-Account Detection

• Records player IPs on join
• Auto-alerts staff (veltrixbanned.alts) when banned players join on alternate accounts
• Optional auto-ban for detected alts

Network Support

• BungeeCord & Velocity proxy sync
• Bans sync across all servers on the network
• Configurable channel and mode

PlaceholderAPI Integration

9 placeholders available:

%veltrixbanned_banned%
%veltrixbanned_ban_reason%
%veltrixbanned_ban_by%
%veltrixbanned_ban_expires%
%veltrixbanned_ban_permanent%
%veltrixbanned_ban_count%
%veltrixbanned_total_bans%
%veltrixbanned_total_ip_bans%

Performance

• Async database operations (zero TPS drop)
• HikariCP connection pool (5 isolated pools)
• Auto-cleanup of expired bans every 5 minutes
• Efficient SQLite storage with indexes

Design & UX

• Full colour support:
  • Legacy codes (&a, &c, &l, ...)
  • RGB hex (&#FF0000)
  • MiniMessage tags (<aqua>, <gold>, ...)
• Custom ban screens (banned.yml)
• Tab completion for players, times & reasons
• Configurable messages (messages.yml)

📦 Commands

🔑 Permissions

⏱ Time Format

Example: 1d12h → 1 day 12 hours

📂 Database Files

plugins/VeltrixBanned/database/
├── banned.db     (active account bans)
├── unbaned.db    (unban log)
├── banip.db      (active IP bans)
├── history.db    (permanent action log)
└── ipcache.db    (player IPs + UUID cache)

⚙ Requirements

• Paper / Spigot 1.21.x
• Java 17+
• (Optional) PlaceholderAPI 2.11+

🐛 Known Issues

• Folia is not supported (requires regionized scheduler)
• Proxy sync requires VeltrixBanned on every backend server

📝 Notes

• This is the first public release. Please report bugs on the Discussions tab or our Discord.
• Configuration files are auto-generated on first startup.
• Back up your plugins/VeltrixBanned/database/ folder before major updates.

Full documentation: See the project Overview tab. Support: Open an issue or join our Discord.

Thank you for using VeltrixBanned! ❤