FluxBans

<div align="center"> # FluxBans **The punishment management plugin your network's been waiting for.** (https://img.shields.io/badge/Java-8+-orange?style=for-the-badge&logo=openjdk&logoColor=white)](https://adoptium.net) (https://img.shields.io/bstats/servers/31262?style=for-the-badge&color=orange&label=Servers)](https://bstats.org/plugin/bukkit/FluxBans/31262) (https://img.shields.io/bstats/players/31262?style=for-the-badge&color=orange&label=Players)](https://bstats.org/plugin/bukkit/FluxBans/31262) (https://img.shields.io/modrinth/dt/fluxbans?style=for-the-badge&color=orange&label=Downloads)](https://modrinth.com/plugin/fluxbans) </div> --- Running a server means dealing with griefers, cheaters, toxic players and the occasional ban evader. You need a punishment system that keeps up, works across every platform you're running, and doesn't need babysitting. FluxBans handles bans, mutes, kicks and warnings across Spigot, Paper, Folia, BungeeCord, Velocity and NeoForge from a single shared database. It ships with an embedded web dashboard, a full ban appeals system, Discord webhooks and a REST API — no paid tier, no feature gates, no abandoned repo. --- ## Platform support <div align="center"> | Platform | JAR | Supported versions | |:---:|:---:|:---:| | Spigot / Paper | `FluxBans-Bukkit.jar` | 1.8.8 to 1.21.x | | Folia | `FluxBans-Folia.jar` | Latest stable | | BungeeCord | `FluxBans-BungeeCord.jar` | Latest stable | | Velocity | `FluxBans-Velocity.jar` | 3.x | | NeoForge | `FluxBans-Forge.jar` | 1.21.1 | </div> Every JAR is self-contained. Point them all at the same database and they stay in sync automatically. Ban someone on BungeeCord and they're blocked on every backend before they can reconnect. --- ## How it compares <div align="center"> | Feature | FluxBans | LiteBans | LibertyBans | AdvancedBan | BanManager | CMI | |:---|:---:|:---:|:---:|:---:|:---:|:---:| | Price | **Free** | $15 | Free | Free | Free | $15 | | Actively maintained | Yes | Yes | Yes | No | Yes | Yes | | Spigot / Paper | Yes | Yes | Yes | Yes | Yes | Yes | | BungeeCord | Yes | Yes | Yes | No | Yes | No | | Velocity | Yes | Yes | Yes | No | Yes | No | | Folia | Yes | No | No | No | No | No | | NeoForge | Yes | No | No | No | No | No | | Embedded web dashboard | Yes | Yes | No | No | No | No | | Built-in appeals system | Yes | No | No | No | No | No | | Discord webhooks | Yes | Yes | No | No | No | Yes | | Generic HTTP webhooks | Yes | No | No | No | No | No | | REST API | Yes | No | No | No | No | No | | IP / CIDR banning | Yes | Yes | Yes | No | Yes | Yes | | Auto escalating warnings | Yes | No | No | Yes | No | Yes | | LuckPerms weight exemptions | Yes | No | No | No | No | No | | ProtectCord support | Yes | No | No | No | No | No | | Config hot reload | Yes | No | No | No | No | Yes | | SQLite support | Yes | Yes | Yes | No | Yes | No | | MySQL / MariaDB support | Yes | Yes | Yes | No | Yes | Yes | | PostgreSQL support | Yes | Yes | Yes | No | No | No | | Import from other plugins | Yes | No | Yes | No | No | No | </div> --- ## Bans Banning blocks a player from rejoining for the duration you set. The check happens at connection time so they never get past the login screen. ``` /ban <player> /tempban <player> <duration> /banip <player|ip> /unban <player|uuid> /unbanip <ip> ``` Temp bans take durations like `7d`, `12h`, `30m` or combinations like `1d12h`. You can ban by username, UUID, IP address or an entire CIDR subnet. The `-s` flag makes the ban silent — see the silent mode section below. | Permission | Description | |:---|:---| | `fluxbans.ban` | Use /ban | | `fluxbans.ban.temp` | Use /tempban | | `fluxbans.ban.ip` | Use /banip and /unbanip | | `fluxbans.ban.silent` | Add the -s flag to ban commands | | `fluxbans.unban` | Use /unban | | `fluxbans.exempt.ban` | This player cannot be banned | --- ## Mutes Muting prevents a player from sending chat messages and using any command you list under `mute.blocked-commands` in `config.yml`. The check runs on every chat event and blocked command so it can't be bypassed by using an alias. ``` /mute <player> /tempmute <player> <duration> /unmute <player> ``` | Permission | Description | |:---|:---| | `fluxbans.mute` | Use /mute | | `fluxbans.mute.temp` | Use /tempmute | | `fluxbans.mute.silent` | Add the -s flag to mute commands | | `fluxbans.unmute` | Use /unmute | | `fluxbans.exempt.mute` | This player cannot be muted | --- ## Kicks Kicks disconnect the player immediately. They can reconnect straight away unless they're also banned. ``` /kick <player> ``` | Permission | Description | |:---|:---| | `fluxbans.kick` | Use /kick | | `fluxbans.kick.silent` | Add the -s flag | | `fluxbans.exempt.kick` | This player cannot be kicked | --- ## Warnings Warnings accumulate and trigger automatic punishments when a player hits the threshol