<\/p>\n
# bChatMod<\/p>\n
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).<\/p>\n
## \u2728 Features<\/p>\n
### \ud83d\udd27Core Features
\n– Unicode-aware blacklist matching for words and phrases (reduces false positives).
\n– Staff notifications include the full original message and the detected match (`{message}` + `{match}`).
\n– Configurable anti-bypass modes:
\n – `normal` \u2014 pattern-based detection only (least aggressive).
\n – `strict` \u2014 pattern + leet & repeat normalization + insertion-only fuzzy detection.
\n – `ultra` \u2014 strict + vowel-stripped checks (most aggressive).
\n– Configurable messages and staff formatting.
\n– No automatic muting by default (plugin focuses on detection and notification).
\n– Lightweight, compatible with Paper\/Spigot 1.19+ (tested up to 1.21.x).<\/p>\n
### \ud83d\udee1\ufe0f Anti-Bypass Techniques
\n– Leet normalization (`f4ck` \u2192 `fack`).
\n– Reduce repeated letters (`fuuuck` \u2192 `fuuck`).
\n– Sliding-window insertion-only fuzzy detection (detects extra-letter bypasses while avoiding substitutions like `duck`).
\n– Vowel-stripped checks (optional `ultra` mode).<\/p>\n
## \u2753 Why bChatMod?
\n– Accurate: word\/phrase boundaries and Unicode-aware patterns avoid many false positives.
\n– Configurable: pick the level of aggressiveness for your community.
\n– Transparent: staff receive the full message for context before action.<\/p>\n
## \ud83d\udce6 Installation<\/p>\n
1. Build or download the JAR and place it in your server `plugins\/` folder.
\n2. Start the server to generate the default `config.yml`.
\n3. Edit `plugins\/bChatMod\/config.yml` to customize blacklist, messages and anti-bypass mode.
\n4. Reload the plugin with:<\/p>\n
\/bchatmod reload<\/p>\n
\u2699\ufe0f config.yml<\/p>\n
“`text
\n# Anti-bypass mode: “normal” | “strict” | “ultra”
\nanti-bypass-mode: “normal”<\/p>\n
# Debug (toggle true while tuning)
\ndebug:
\n block-log: false<\/p>\n
# Messages
\nplayer-block-message: “&7You cannot send that message. It contains blocked words.”
\nstaff-message-format: “&b[bChatMod] &7{player} tried cursing: &r{message} &7(matched: &b{match}&7)”<\/p>\n
# Permission required to receive staff notifications
\nstaff-notify-permission: “bchatmod.notify”<\/p>\n
# Blacklist (example entries)
\nblacklist:
\n – “fuck”
\n – “shit”
\n – “example-offensive-term”
\n“`<\/p>\n
\ud83d\udcdd Notes
\nShort tokens (length \u2264 3) are handled conservatively to avoid false positives (e.g., “ass” inside “basso”). Use caution when adding short tokens.
\nUse debug.block-log: true during tuning to see which pattern\/candidate matched in console.<\/p>\n
Commands
\nCommand
\nDescription
\n\/bchatmod reload
\nReload configuration and rebuild blacklist patterns<\/p>\n
\ud83d\udd11 Permissions
\nbchatmod.notify \u2014 receive staff notifications (default: op)
\nbchatmod.reload \u2014 reload config (default: op)
\nbchatmod.bypass \u2014 bypass chat filter (default: op) <\/p>\n
\ud83e\udde9 Placeholders
\n{player} \u2014 player name
\n{message} \u2014 full original message the player attempted to send
\n{match} \u2014 the substring or variant that triggered the block <\/p>\n
&b[bChatMod] &7{player} tried cursing: &r{message} &7(matched: &b{match}&7)<\/p>\n
<\/p>\n","protected":false},"excerpt":{"rendered":"
A lightweight, configurable chat moderation plugin: blocks profanity (Italian + English), notifies staff with the full message, and supports anti-bypass modes (normal\/strict\/ultra). Suitable for lifesteal and SMP<\/p>\n","protected":false},"featured_media":26535,"template":"","meta":{"_minecraft_slug":"bchatmod","_minecraft_project_id":"VprRUpdo","_minecraft_author":"blackowlzz","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":27,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"bchatmod.zip","_minecraft_size_bytes":43793,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:18:04.154666Z","_minecraft_date_created":"2026-03-19T21:24:12.470384Z","_minecraft_date_modified":"2026-03-16T21:02:39.567050Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/bchatmod","_minecraft_icon_attachment_id":26535,"_minecraft_imported_at":"2026-06-01T09:55:31+00:00","_minecraft_import_hash":"bca18e352ed6424f32463be30be2715c","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,126,127,128,867,129,92],"mod_loader":[130,131,132,133,134],"minecraft_version":[118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-26534","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n