📖About Swear Blocker

SwearBlocker

A profanity filter for Spigot, Paper, and Folia. Catches the bypasses people actually try.

Punctuation between letters, leet substitutions, repeated characters, reversed words, diacritics, visually-confusable Unicode (Cyrillic, fullwidth, math italic). All caught. assistant, class, bass — left alone.

Runs on chat, signs, written books, anvil renames, and a configurable list of commands. MC 1.19+.

What happens when someone swears

The bad word gets swapped. By default you get whimsical nonsense:

steve: sparkly cosmic waffle overlord, friend of hamster

Set tone: serious if you'd rather see asterisks.

Detection

If darn were blocked, all of these would still get caught:

darn         exact match
daaarn       repeat collapse
d@rn         leet (a → @)
d.a.r.n      separators
nrad         reversed
därn         diacritics
dаrn         homoglyph fold (Cyrillic 'а')
d·a·r·n      zero-widths

Phonetic matching (Metaphone, catches sound-alikes) is opt-in.

Escalation

Optional, off by default. If you want it:

actions:
  enabled: true
  ladder:
    - { threshold: 1,  window-minutes: 60,   run: [replace, title, log] }
    - { threshold: 3,  window-minutes: 60,   run: [warn, warn-staff, log] }
    - { threshold: 6,  window-minutes: 60,   run: [mute, log], mute-duration-minutes: 10 }
    - { threshold: 10, window-minutes: 60,   run: [kick] }
    - { threshold: 15, window-minutes: 1440, run: [ban] }

Rolling-window per player, persisted to disk.

Commands

All under /swearblocker (/sb).

/sb info · /sb test <msg> · /sb add · /sb remove · /sb exclude · /sb stats · /sb clear · /sb reload

Install

Paper or Folia (1.20.5+): SwearBlocker-Paper-2.0.0.jar
Spigot (1.19+): SwearBlocker-Spigot-2.0.0.jar

Drop in plugins/, restart. No required dependencies.

Velocity?

Not in 2.0. Signed chat in 1.19.1+ blocks proxy-side rewrites unless you install a bridge plugin everywhere, and the broken-paths weren't worth shipping. Run SwearBlocker on each backend instead.