Chat Filter System

StarChat includes a built-in, highly configurable chat filter designed to keep your community safe from spam, toxicity, and unauthorized advertising.

Anti-Spam & Cooldowns

Stop players from cluttering the chat with repetitive messages.

  • Message Cooldown:Enforces a strict delay between messages (default 3 seconds). Bypassed with starchat.filter.bypass.cooldown.
  • Similarity Check:Prevents players from sending the exact same message twice in a row, or a message that is X% similar to their last one.
  • Anti-Flood (Repeated Characters):Automatically catches and blocks messages like "Heeeeelllllpppp!!!!" from being broadcasted.

Content Filtering

Automatically format or block undesirable content.

  • Anti-Caps:If a message contains too many uppercase letters (e.g., > 50%), it is automatically converted to lowercase. Bypassed with starchat.filter.bypass.caps.
  • IP & URL Blocker:Detects standard IPv4 addresses and website links to prevent unauthorized advertising. Offenders are silently warned. Bypassed with starchat.filter.bypass.urls.
  • Bad Words List:Define a custom list of words in chat-filter.yml. Depending on config, these words will either be replaced with asterisks (***) or the entire message will be blocked.

Automated Punishments

The filter uses a built-in point system. Every time a player triggers a severe filter (like swearing or advertising), they gain points. By default, reaching 3 points results in an automatic temporary mute.

You can configure the punishment command (e.g., running litebans mute %player% 1h Auto-Mute) in the settings.