ProfanityFilter

Bymirko0
Mods

ProfanityFilter is a lightweight, configurable plugin for detecting and blocking offensive language in chat, supporting simple, moderate, and advanced filtering modes.

Description

🛡️ ProfanityFilter — Lightweight, Powerful Chat Moderation

ProfanityFilter is a staff-friendly chat moderation plugin that automatically detects and blocks offensive language on your Hytale server. Perfect for keeping your community safe, friendly, and welcoming.

📍 Filter Modes

ProfanityFilter supports multiple filter modes to fit your server’s needs:

SIMPLE
Blocks exact offensive words only.

MODERATE
Detects words with symbols, accents, and spaced letters (e.g., f u c k, fück).

ADVANCED
Uses the Aho-Corasick algorithm to catch obfuscated, embedded, or cleverly disguised offensive words in chat.

⚙️ Word Lists

ProfanityFilter is designed for flexible, dynamic word management:

Place all .txt files in the /words/ folder inside your plugin directory.
Multiple files are supported; words from all files are loaded automatically.
Add comments in your files using # at the beginning of a line — these will be ignored.
A default word list is automatically loaded on first run if no .txt files are present.

✨ Features Overview

Feature	Description
Dynamic Word Loading	Load custom `.txt` files at boot
Default Ready-to-Use List	Comes with default profanity words for instant setup
Three Filter Modes	SIMPLE, MODERATE, ADVANCED
Configurable Permissions	Staff can bypass the filter via permission
Fast & Efficient	Optimized for high-volume chat without performance hits
Hot-Reload Support	Reload word lists without restarting the server

🧭 Commands

ProfanityFilter has one simple command:

📋 Command Overview

Command	Arguments	Description	Example
`/reloadprofanitywords`	—	Reload all word lists from the `/words/` folder	`/reloadprofanitywords`

📝 Configuration

All settings are stored in ProfanityFilter.json:

BypassPermission: Permission node for trusted players to bypass the filter. FilterMode: Select SIMPLE, MODERATE, or ADVANCED (all caps).

{
  "BypassPermission": "profanityfilter.bypass",
  "FilterMode": "MODERATE"
}

💬 Support

Need help or want to report an issue? Support: https://discord.gg/veUKtz2cg4

ProfanityFilter keeps your chat safe, clean, and under control — without complexity.