Skip to content

Permissions

Every node defaults to op only. There is deliberately no finexbans.* wildcard — one mistyped wildcard would hand the whole punishment system to a stranger. Grant nodes one by one:

lp group moderator permission set finexbans.ban true
lp group moderator permission set finexbans.mute true
lp group moderator permission set finexbans.warn true
lp group moderator permission set finexbans.info true
lp group moderator permission set finexbans.staff true

Punishing

NodeAllows
finexbans.ban/ban, /tempban
finexbans.ban.permanenta ban without a duration
finexbans.ipban/ipban
finexbans.ipban.permanentpermanent IP ban
finexbans.mute/mute, /tempmute
finexbans.mute.permanentpermanent mute
finexbans.kick/fkick
finexbans.warn/warn
finexbans.gui/punish menu

Lifting

finexbans.unban, finexbans.unipban, finexbans.unmute, finexbans.unwarn

Looking up

finexbans.history, finexbans.check, finexbans.alts, finexbans.banlist, finexbans.mutelist — or all five at once with finexbans.info.

Staff and admin

Node
finexbans.staffstaff alerts (alts, banned player tried to join, filter hits) and /sc
finexbans.admin/finexbans reload, license, import

Protection and bypasses

Node
finexbans.exemptthis player cannot be punished. Checked for offline players too when LuckPerms is installed
finexbans.exempt.bypassmay punish exempt players anyway
finexbans.limits.bypassignores limits: in config
finexbans.filter.bypassnot checked by the chat filter

A typical setup

GroupNodes
helperkick, mute, warn, unmute, unwarn, info, staff, exempt
moderatorhelper + ban, unban, ipban, unipban, gui
adminmoderator + ban.permanent, mute.permanent, ipban.permanent, exempt.bypass, limits.bypass, admin

FinExBans · Paper, Folia, Velocity, BungeeCord · 1.21 → 26.2