# ChatModerator – AI-Powered Minecraft Chat Moderation Plugin<\/p>\n
A sophisticated Minecraft plugin that automatically moderates chat messages using AI, keeping your server safe and friendly. ChatModerator now supports **both OpenAI and Gemini AI providers** for content analysis, giving you flexibility and reliability.<\/p>\n
## Features<\/p>\n
* **AI-Powered Moderation**: Analyze chat messages with OpenAI or Gemini APIs to detect inappropriate content.
\n* **Universal Compatibility**: Works seamlessly on Spigot, Paper, Folia, and Luminol servers with automatic detection.
\n* **Configurable Word Filter**: Block specific words with a customizable blacklist.
\n* **Flexible AI Thresholds**: Adjust sensitivity for different categories like hate speech, harassment, sexual content, and violence.
\n* **Admin Tools**: Manage the plugin, word lists, and moderation behavior via commands.
\n* **Permission System**: Allow trusted players to bypass moderation.
\n* **Real-time Notifications**: Alert administrators when violations occur.
\n* **Comprehensive Logging**: Track all moderation actions and AI decisions.
\n* **AI Test Command**: Quickly test your API key with sample messages.
\n* **Folia\/Luminol Scheduler Support**: Ensures tasks run correctly on threaded server implementations.<\/p>\n
## Installation<\/p>\n
1. Download the plugin JAR file.
\n2. Stop your server.
\n3. Place the JAR in your server’s `plugins\/` folder.
\n4. Start your server to generate configuration files.
\n5. Configure your OpenAI or Gemini API key in `plugins\/ChatModerator\/config.yml`.
\n6. Restart your server or run `\/chatmod reload`.<\/p>\n
## Configuration<\/p>\n
### AI Provider Setup<\/p>\n
* **OpenAI**: Get an API key from OpenAI and replace `your-openai-api-key-here` in the config.
\n* **Gemini**: Get an API key from Gemini and replace `your-gemini-api-key-here` in the config.<\/p>\n
### Blocked Words<\/p>\n
Add words to the blocked list in the configuration:<\/p>\n
“`yaml
\nmoderation:
\n blocked-words:
\n – “badword1”
\n – “inappropriate”
\n – “spam”
\n“`<\/p>\n
### AI Moderation Thresholds<\/p>\n
Adjust sensitivity for different categories:<\/p>\n
“`yaml
\nmoderation:
\n thresholds:
\n hate: 0.3 # Lower = more sensitive
\n harassment: 0.3
\n sexual: 0.5
\n violence: 0.3
\n“`<\/p>\n
## Commands<\/p>\n
* `\/chatmod reload` – Reload configuration ## Permissions<\/p>\n * `chatmoderator.admin` – Access to all commands (default: op) ## How It Works<\/p>\n 1. **Message Interception**: Listens to all chat messages. ## Requirements<\/p>\n * Minecraft Server 1.20+ ## Building from Source<\/p>\n “`bash The compiled JAR will be in the `target\/` directory.<\/p>\n ## Support<\/p>\n For issues or feature requests, create an issue in the repository or contact the plugin developer.<\/p>\n ## License<\/p>\n This project is licensed under the MIT License.<\/p>\n","protected":false},"excerpt":{"rendered":" An AI powered chat moderation minecraft plugin for Bukkit\/Spigot\/Paper\/Folia<\/p>\n","protected":false},"featured_media":38881,"template":"","meta":{"_minecraft_slug":"chatmoderator","_minecraft_project_id":"TFJpizSO","_minecraft_author":"Hihelloy","_minecraft_license":"MIT","_minecraft_downloads":171,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"chatmoderator.zip","_minecraft_size_bytes":33663739,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T13:07:37.811476Z","_minecraft_date_created":"2025-08-31T21:54:27.780177Z","_minecraft_date_modified":"2025-09-16T05:20:33.758881Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/chatmoderator","_minecraft_icon_attachment_id":38881,"_minecraft_imported_at":"2026-06-01T20:16:18+00:00","_minecraft_import_hash":"36492412f7152ab9ce0a0075de90a94f","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,126,127,867,129,123,92],"mod_loader":[130,131,132,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,73,74,38,78,79,80,81],"class_list":["post-38880","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-management","mod_category-paper","mod_category-social","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-spigot","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-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"],"yoast_head":"\n
\n* `\/chatmod status` – Show plugin status
\n* `\/chatmod toggle` – Enable\/disable moderation
\n* `\/chatmod add-word
\n* `\/chatmod remove-word
\n* `\/chatmod unmute
\n* `\/chatmod aitest
\n* `chatmoderator.bypass` – Bypass chat moderation (default: false)<\/p>\n
\n2. **Server Detection**: Detects Folia\/Luminol and uses appropriate schedulers.
\n3. **Word Filter Check**: Checks messages against your custom blocked words.
\n4. **AI Analysis**: Sends message to OpenAI or Gemini for content analysis.
\n5. **Action Execution**: Blocks inappropriate messages, notifies admins, and logs actions.<\/p>\n
\n* Spigot, Paper, Folia, or Luminol
\n* Java 17+
\n* OpenAI or Gemini API key (optional for AI moderation)
\n* Internet connection<\/p>\n
\ngit clone
\ncd chat-moderator
\nmvn clean package
\n“`<\/p>\n