Installation

FinExBans ships as three jars. Pick the one for each server you run.

Jar	Where it goes	Minecraft
FinExBans-<version>.jar	Paper, Purpur, Pufferfish, Leaf and other Paper forks; Folia	1.21 → 26.2
FinExBans-Velocity-<version>.jar	Velocity 3.x and 4.x	any
FinExBans-Bungee-<version>.jar	BungeeCord, Waterfall	any

Not supported

Spigot and CraftBukkit — the plugin uses the Paper API. Modded servers (Forge, Fabric, Arclight) are not supported either.

Single server

1. Drop FinExBans-<version>.jar into plugins/.
2. Start the server. The plugin creates plugins/FinExBans/config.yml, three language files and an SQLite database.
3. Get a free 3-day key with the promo code FINEX at ban.finex.best/account and enter it with /finexbans license <key> — see License & trial.

Java 21 or newer is required (Paper 1.21+ already needs it).

Network (proxy + backends)

Put the proxy jar on Velocity or Bungee and the Paper jar on every backend, then point all of them at one MySQL database. The proxy stops banned players before they reach any server; the backends enforce mutes in chat, signs and books. Read Networks for the exact settings.

Optional plugins

Plugin	What it adds
LuckPerms	finexbans.exempt is checked for offline players too, so staff cannot be banned after logging out
PlaceholderAPI	%finexbans_…% placeholders — see PlaceholderAPI

First commands

/ban Steve 7d Cheating
/mute Alex 1h Spam
/warn Notch Caps
/history Steve
/finexbans license

All commands need permissions — a regular player has none. Grant them with LuckPerms, see Permissions.