Better Anti Swear is a Spigot and Paper plugin that detects and handles inappropriate language in your server's chat. It is built with flexibility in mind, allowing server owners to configure nearly every aspect of the plugin through its configuration files.

Detection

The plugin goes beyond simple word matching. It handles leet-speak substitutions such as 3 for e, @ for a, 1 for i, and so on. It also catches words with repeated characters like "fuuuuck" and words typed with spaces between letters. Partial word matching is supported, and a whitelist is included to prevent false positives on words like "assassin" or "classic".

Punishment System

Each violation count maps to its own punishment entry in punishments.yml. The default setup escalates from a warning on the first offense, to an internal chat mute on the second, a kick on the third, a temporary ban on the fourth, and a permanent ban on the fifth. Every punishment is driven by console commands, which means it works with EssentialsX, LiteBans, AdvancedBan, CMI, or any other punishment plugin you already have installed. You can also use the built-in internal mute without any dependency.
Admin Notifications
When a player triggers a detection, admins receive two simultaneous alerts: a message in their chat feed and an action bar notification displayed above the hotbar. Both channels can be toggled independently in config.yml.

Configuration Files

config.yml: master switch, detection toggles, optimization settings, chat behavior
badwords.yml: word groups, whitelist, and optional regex patterns
punishments.yml: per-violation punishment definitions with full console command support
messages.yml: every string the plugin outputs, fully customizable

Commands

All commands are available under /bas with tab completion.

/bas reload
/bas check (player)
/bas reset (player)
/bas addword (word) (group)
/bas removeword (word)
/bas list (group)
/bas info

Permissions

The plugin uses standard Bukkit permissions, compatible with LuckPerms, PermissionsEx, GroupManager, PowerRanks, and any other Vault-compatible permission plugin.

betterantiswear.admin: full access to all commands and notifications
betterantiswear.bypass: skip detection entirely
betterantiswear.notify: receive alerts without full admin access
Individual permissions are available for each sub-command

Requirements

Spigot or Paper 1.20 and above. Java 17 or higher.