bChatMod

!(https://cdn.modrinth.com/data/cached_images/baad0fdddd93731e1d2f08edc338d447faa50d1e_0.webp)

A lightweight, configurable chat moderation plugin for Paper/Spigot: blocks profanity (Italian + English), notifies staff with the full message, and supports anti-bypass modes (normal / strict / ultra).

## ✨ Features

### 🔧Core Features - Unicode-aware blacklist matching for words and phrases (reduces false positives). - Staff notifications include the full original message and the detected match (`{message}` + `{match}`). - Configurable anti-bypass modes: - `normal` — pattern-based detection only (least aggressive). - `strict` — pattern + leet & repeat normalization + insertion-only fuzzy detection. - `ultra` — strict + vowel-stripped checks (most aggressive). - Configurable messages and staff formatting. - No automatic muting by default (plugin focuses on detection and notification). - Lightweight, compatible with Paper/Spigot 1. 19+ (tested up to 1. 21.x).

### 🛡️ Anti-Bypass Techniques - Leet normalization (`f4ck` → `fack`). - Reduce repeated letters (`fuuuck` → `fuuck`). - Sliding-window insertion-only fuzzy detection (detects extra-letter bypasses while avoiding substitutions like `duck`). - Vowel-stripped checks (optional `ultra` mode).

## ❓ Why bChatMod? - Accurate: word/phrase boundaries and Unicode-aware patterns avoid many false positives. - Configurable: pick the level of aggressiveness for your community. - Transparent: staff receive the full message for context before action.

## 📦 Installation

1. Build or download the JAR and place it in your server `plugins/` folder. 2. Start the server to generate the default `config.yml`. 3. Edit `plugins/bChatMod/config.yml` to customize blacklist, messages and anti-bypass mode. 4. Reload the plugin with:

/bchatmod reload

⚙️ config.yml

```text # Anti-bypass mode: "normal" | "strict" | "ultra" anti-bypass-mode: "normal"

# Debug (toggle true while tuning) debug: block-log: false

# Messages player-block-message: "&7You cannot send that message. It contains blocked words." staff-message-format: "&b &7{player} tried cursing: &r{message} &7(matched: &b{match}&7)"

# Permission required to receive staff notifications staff-notify-permission: "bchatmod.notify"

# Blacklist (example entries) blacklist: - "fuck" - "shit" - "example-offensive-term" ``` [!(https://cdn.modrinth.com/data/cached_images/2a7cabfe48395a3a51d6d6c8dfbccc656c81ef21_0.webp)](https://dragonhosting.cloud/?ref=BLACKOWLZZ) 📝 Notes Short tokens (length ≤ 3) are handled conservatively to avoid false positives (e.g., "ass" inside "basso"). Use caution when adding short tokens. Use debug.block-log: true during tuning to see which pattern/candidate matched in console. Commands Command Description /bchatmod reload Reload configuration and rebuild blacklist patterns 🔑 Permissions bchatmod.notify — receive staff notifications (default: op)

bchatmod.reload — reload config (default: op)

bchatmod.bypass — bypass chat filter (default: op)

🧩 Placeholders {player} — player name

{message} — full original message the player attempted to send

{match} — the substring or variant that triggered the block

&b &7{player} tried cursing: &r{message} &7(matched: &b{match}&7)

!(https://bstats.org/signatures/bukkit/bChatMod.svg/)