CleanSpeak is a lightweight but powerful chat moderation plugin designed to keep your Minecraft server clean and friendly. It automatically detects and blocks offensive, racist, and toxic language in the chat and applies configurable punishments such as kick, ban, or tempban.

Features

• Fully configurable list of banned words (supports all languages)
  
  
• Customizable punishments:
  
  • kick – kicks the player
    
    
  • ban – permanent ban
    
    
  • tempban-7d – temporary ban for 7 days (adjustable)
    
• Custom warning message to the player
  
  
• Commands executed via console for compatibility with ban systems like EssentialsX, LiteBans, etc.
  
  
• Simple /cleanspeak reload command to reload configuration without restarting the server
  

Configuration
The config.yml file is easy to use:

yaml
bannedWords:
- exampleword
- anotherword
punishment: tempban-3d
warnMessage: "&cOffensive language is not allowed!"

You can define any punishment:

• kick
  
  
• ban
  
  
• tempban-1h, tempban-3d, tempban-1w, etc.
  

Compatible with all plugins that handle punishments via console commands.

Installation

1. Download the plugin and place it in your plugins/ folder.
   
   
2. Restart your server or use /reload.
   
   
3. Edit config.yml to add your own banned words and choose your desired punishment.
   
   
4. Use /cleanspeak reload to apply changes at any time.
   

Compatibility

• Works on Spigot, Paper, Purpur
  
  
• Tested on Minecraft 1.21+
  
  
• Supports Java 17+
  

Notes

• The plugin does not store player data or IPs.
  
  
• You are free to add/remove any words in the list.
  
  
• If using tempban, make sure your ban plugin supports it (e.g., EssentialsX, LiteBans, AdvancedBan).