# 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 (``, ``, ...) - Custom ban screens (`banned.yml`) - Tab completion for players, times & reasons - Configurable messages (`messages.yml`) ## 📦 Commands | Command | Description | |---------|-------------| | `/ban ` | Ban a player's account | | `/banip ` | Ban a player's IP | | `/unban ` | Remove an account ban | | `/unban-ip ` | Remove an IP ban | | `/veltrixbanned help` | Show help menu | | `/veltrixbanned reload` | Reload configuration | | `/veltrixbanned banlist` | List active bans | | `/veltrixbanned alts ` | List alt accounts sharing IPs | ## 🔑 Permissions | Permission | Description | |------------|-------------| | `veltrixbanned.ban` | Access to `/ban` | | `veltrixbanned.ban.ip` | Access to `/banip` | | `veltrixbanned.unban` | Access to `/unban` | | `veltrixbanned.unban.ip` | Access to `/unban-ip` | | `veltrixbanned.alts` | View alt accounts | | `veltrixbanned.reload` | Reload configuration | | `veltrixbanned.admin` | Full access (parent of above) | ## ⏱ Time Format | Unit | Code | |------|------| | Seconds | `s` | | Minutes | `m` | | Hours | `h` | | Days | `d` | | Weeks | `w` | | Months | `M` | | Years | `y` | | Permanent | `perm` | 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](https://hangar.papermc.io/pokemon/VeltrixBanned) 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! ❤