# ChatManagement 2<\/p>\n
**Advanced Anti-Spam & Chat Protection Plugin for Minecraft 1.21.x**<\/p>\n
ChatManagement 2 is a complete rewrite of the original ChatProtection plugin, featuring improved spam detection algorithms, fewer false positives, and enhanced performance. Fully compatible with Folia’s region-based threading.<\/p>\n
—<\/p>\n
## \ud83c\udfaf Key Features<\/p>\n
### Smart Spam Detection
\n– **Similarity Matching** – Detects spam even with typos using an improved Levenshtein distance algorithm
\n – `”hello everyone”` vs `”helo everyone”` \u2192 Blocked if too similar
\n – Configurable similarity threshold (default: 80%)
\n – Length-based filtering prevents false positives on short messages<\/p>\n
### Blocked Words System ### Technical Excellence #### Chat Colors<\/p>\n Enable colored chat feature:<\/p>\n “`yaml —<\/p>\n ## \ud83d\udcdd Commands<\/p>\n ### Main Commands ### Private Messaging —<\/p>\n ## \ud83d\udd10 Permissions<\/p>\n – `chatmanagement.reload` – Allows reloading the plugin (default: op) —<\/p>\n ## \ud83d\udd27 Troubleshooting<\/p>\n ### Too Many False Positives<\/p>\n If legitimate messages are being blocked:<\/p>\n 1. **Increase similarity threshold**: 2. **Disable partial word matching**: 3. **Increase minimum message length**: ### Messages Not Being Blocked<\/p>\n If spam is getting through:<\/p>\n 1. **Decrease similarity threshold**: 2. **Lower spam thresholds**: 3. **Enable debug mode**: ### Database Issues<\/p>\n If database connection fails:<\/p>\n 1. Check credentials in config —<\/p>\n ## \ud83d\udcca Performance<\/p>\n ChatManagement 2 is designed for minimal impact:<\/p>\n – **Average overhead**: <1ms per message\n- **Memory usage**: ~2-5 MB for typical servers\n- **Database queries**: Optimized with prepared statements\n- **Thread-safe**: Fully compatible with Folia's threading model\n\n---\n\n## \ud83c\udd9a Differences from ChatProtection\n\nChatManagement 2 is a complete rewrite with major improvements:\n\n1. **Better Accuracy** - Improved spam detection with fewer false positives\n2. **Length-Based Filtering** - Prevents blocking short, legitimate messages\n3. **Partial Match Control** - Smart boundary detection for blocked words\n4. **Database Support** - Optional SQLite\/MySQL for better performance\n5. **Enhanced Mute System** - Pause\/resume on disconnect\/reconnect\n6. **Improved Configuration** - More granular control over all features\n7. **Better Documentation** - Comprehensive comments and examples\n\n---\n\n## \ud83d\udccb Changelog\n\n### v1.0.0 (Initial Release)\n- Complete rewrite of ChatProtection\n- Improved spam detection algorithms\n- Database support (SQLite\/MySQL)\n- Enhanced mute system with persistence\n- Better configuration options\n- Comprehensive documentation\n- Folia compatibility\n- Fewer false positives\n- Performance optimizations\n\n\n<\/p>\n","protected":false},"excerpt":{"rendered":" Simple Anti-Spam & Chat Protection Plugin<\/p>\n","protected":false},"featured_media":38871,"template":"","meta":{"_minecraft_slug":"chatmanagement2","_minecraft_project_id":"MGsMaOSN","_minecraft_author":"MistaSoup","_minecraft_license":"MIT","_minecraft_downloads":63,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"chatmanagement2.zip","_minecraft_size_bytes":39849,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T20:39:40.944691Z","_minecraft_date_created":"2026-02-08T05:53:16.445909Z","_minecraft_date_modified":"2026-02-07T22:58:36.194396Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/chatmanagement2","_minecraft_icon_attachment_id":38871,"_minecraft_imported_at":"2026-06-01T20:15:47+00:00","_minecraft_import_hash":"d287efe0d0e5c901eec2c5fb50f50c1d","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,127,128,129],"mod_loader":[131,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-38870","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","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
\n– **Intelligent Pattern Matching** – Automatically detects obfuscations:
\n – Leetspeak: `f*ck`, `fvck`, `fu
\n– **Silent Blocking** – Configurable notifications when messages are blocked
\n– **Permission Bypass** – Trusted players skip all checks
\n– **Customizable Messages** – All plugin messages can be customized<\/p>\n
\n– **Folia Compatible** – Full support for region-based threading
\n– **High Performance** – Minimal overhead (<1ms per message)\n- **Database Support** - SQLite or MySQL for persistent storage\n- **Hot Reload** - `\/cm reload` updates config without restart\n- **Comprehensive Logging** - Debug and verbose modes for troubleshooting\n\n---\n\n## \ud83d\udce6 Installation\n\n1. Download the latest `ChatManagement2-1.0.0.jar`\n2. Place in your server's `plugins` folder\n3. Start\/restart your server\n4. Configure `plugins\/ChatManagement2\/config.yml` to your needs\n5. Run `\/cm reload` to apply changes\n\n### Requirements\n- **Minecraft Server**: 1.21.x (Paper, Folia, or compatible fork)\n- **Java**: 21 or higher\n\n---\n\n## \u2699\ufe0f Configuration\n\n### Basic Setup\n\nThe default configuration works well out-of-the-box, but you can customize everything:\n\n```yaml\n# Core spam detection\nsettings:\n similarity-threshold: 80 # 0-100%, higher = more strict\n message-history-size: 10 # Messages to track per player\n\n# Duplicate message blocking\nduplicate-messages:\n max-repeats: 2 # Allow 2 repeats before blocking\n cooldown-seconds: 30 # Clear history after this time\n\n# Rapid spam detection\nanti-spam-kick:\n enabled: true\n message-threshold: 7 # Messages in time window = kick\n time-window-seconds: 5\n\n# Auto-mute for repeat offenders\nauto-mute:\n enabled: true\n kick-threshold: 3 # Kicks in window = mute\n kick-window-minutes: 10\n mute-duration-seconds: 300\n```\n\n### Advanced Configuration\n\n#### Database Setup\n\nFor better performance with many mutes, enable database storage:\n\n**SQLite (Recommended for most servers)**:\n```yaml\ndatabase:\n enabled: true\n type: sqlite\n```\n\n**MySQL (For large servers)**:\n```yaml\ndatabase:\n enabled: true\n type: mysql\n mysql:\n host: localhost\n port: 3306\n database: chatmanagement\n username: your_username\n password: your_password\n```\n\n#### Blocked Words\n\nConfigure the word filter to your needs:\n\n```yaml\nblocked-words:\n enabled: true\n block-partial-matches: false # Prevent false positives\n min-word-length: 4 # Minimum length for partial matching\n word-list:\n - badword1\n - badword2\n```\n\n#### Custom Messages\n\nAll messages can be customized and toggled:\n\n```yaml\nmessages:\n notify-blocked-message: false # Silent blocking\n blocked-message-notification: \"&cYour message was blocked.\"\n \nanti-spam-kick:\n notify-player: true\n kick-message: \"&cYou have been kicked for spamming!\"\n\nauto-mute:\n notify-player: true\n mute-notification: \"&cYou have been muted for &e{duration} &cseconds.\"\n mute-message: \"&cYou are muted. Time remaining: &e{time} &cseconds.\"\n```\n\n#### Private Messaging\n\nCustomize PM appearance:\n\n```yaml\nprivate-messaging:\n enabled: true\n message-color: \"&d\" # Magenta\n sent-format: \"&7[&dYou &7-> &d{receiver}&7] &r{message}”
\n received-format: “&7[&d{sender} &7-> &dYou&7] &r{message}”
\n“`<\/p>\n
\nchat-colors:
\n enabled: true
\n color-prefix: “>” # Type >message for colored text
\n prefix-color: “&a” # Light green
\n“`<\/p>\n
\n– `\/chatmanagement` or `\/cm` – Main plugin command
\n– `\/cm reload` – Reload configuration
\n– `\/cm help` – Show help message
\n– `\/cm version` – Show plugin version<\/p>\n
\n– `\/msg
\n– `\/w
\n– `\/tell
\n– `\/pm
\n– `\/dm
\n– `\/whisper
\n– `\/r
\n– `\/reply
\n– `chatmanagement.bypass` – Bypass all chat restrictions (default: op)<\/p>\n
\n “`yaml
\n settings:
\n similarity-threshold: 85 # Higher = more strict, fewer false positives
\n “`<\/p>\n
\n “`yaml
\n blocked-words:
\n block-partial-matches: false
\n “`<\/p>\n
\n “`yaml
\n duplicate-messages:
\n min-message-length: 5
\n “`<\/p>\n
\n “`yaml
\n settings:
\n similarity-threshold: 75 # Lower = catches more spam
\n “`<\/p>\n
\n “`yaml
\n anti-spam-kick:
\n message-threshold: 5
\n “`<\/p>\n
\n “`yaml
\n settings:
\n debug: true
\n “`
\n Check console for detection information.<\/p>\n
\n2. Ensure database exists (for MySQL)
\n3. Plugin will automatically fall back to YAML storage
\n4. Check console for error messages<\/p>\n