ChatProtect is a robust and modern moderation plugin that automatically moderates your chat, preventing spam, offensive language, and advertisements. Are you tired of players advertising their servers? Annoyed by a flooded chat? ChatGuard is here to help, ensuring your community remains engaging and enjoyable.
Features
Intelligent AI Moderation: Unlike simple word filters, ChatProtect is integrated with the Google Perspective API to instantly score messages for Toxicity and offensive context. This delivers a significantly higher detection rate and catches slurs, subtle insults, and nuanced threats that standard filters miss.
Massive Blacklist Coverage: Every single chat message is checked against our expansive, modern blacklist. Pre-loaded with over 4500 blacklisted words spanning 25+ different languages, you're protected against most common profanity from day one.
Advertisement & IP Blocking: Automatically and instantly shut down players trying to advertise other servers. We block IP addresses, domain names, and suspicious links to keep your player count safe.
Advanced Spam & Flood Prevention: Keep your chat clean and readable. ChatProtect automatically filters out:
Repetitive Messaging (Chat flooding)
Excessive Caps (Screaming/Uppercase spam)
Random Letter Spam
Real-Time Discord Alerts: Integrate seamlessly with your staff team's communication. Use Discord Webhooks to automatically send clear, detailed alerts to your private staff channel the moment an issue (like a toxic message or ad) is flagged and punished.
Spam bot detection: ChatProtect can identify spam bots, which are often found in compromised clients such as Liquidbounce.
Installation
Download the plugin: Get the latest version of ChatGuard from SpigotMC.
Install: Place the ChatGuard.jar file into your server's plugins directory.
Restart Server: Restart your server to enable the plugin.
Configure: Customize the plugin by editing the config.yml file in the plugins/ChatGuard directory. Replace the default kick and ban commands with your own punishment commands (e.g. replace kicking with a temporary mute). Adjust the strictness of various checks to suit your server's needs.
Testing: When testing the plugin make sure you don't have operator permissions. Otherwise you will bypass the checks.
# We can also check private messages using commands for spam, advertisements
# and inappropriate language. This is a list of all the commands we check.
commands:
- "msg"
- "message"
- "tell"
- "me"
- "*"
discord:
# If you want to enable this discord bot. (true/false)
enabled: false
# ChatProtect requires a webhook to send messages to your Discord server.
# Watch this tutorial to learn how to create a webhook: https://www.youtube.com/watch?v=fKksxz2Gdnc
webhook: ""
inline: false
# The name and value have to be separated by the symbol "|"
# Placeholders: %player% %message% %check%
content:
- "**Player**| %player%"
- "**Message**| %message%"
- "**Check**| %check%"
checks:
# The toxicity check penalizes players for using offensive language in chat.
# This check will use the Google Perspective API by default. You can add custom
# blacklisted words to the blacklist.yml file in the server directory.
toxicity:
enabled: true
message: "Please watch your language!"
# Info: Offensive messages detected by the Google Perspective API will not be blocked.
# Only bad words from the blacklist.yml file will be affected.
silent: false
# The score (0.0 to 1.0) when a message should be flagged as offensive.
maxScore: 0.7
# Here, you can set different punishments for each check. Every line always follows this format:
# Threshold:Interval Command.
# Placeholders: %player% (the player's name) and %message% (the flagged message).
# This command is always executed in the server's console. You can also use [Discord] to send an alert
# to Discord (see above), or [alert] to send an alert to all online staff via "chatprotect.notify".
# Info: Please note that flags created using the Google Perspective API will not execute any commands at this time.
punishments:
- "1:1 [discord]"
- "1:1 [alert]"
- "10:10 tempmute %player% 10m Swearing"
# The spamming check will prevent players from flooding the chat with messages. It will detect
# random letters, repetitive messages and messages sent too quickly.
spamming:
enabled: true
message: "Please do not spam the chat!"
# The cooldown period is in milliseconds between each message sent. Note: we will not immediately block.
# Messages will not be blocked immediately for being sent too quickly, but rather when lots of messages exceed this limit.
minMessageCooldown: 500
# The percentage of a message that must be in uppercase for it to be blocked (default: 0.4, or 40%).
maxUppercasePercentage: 0.4
# The maximum allowed similarity between messages is 0.7 (70%).
maxSimilarityPercentage: 0.7
# The brackets mean that there are currently no punishments or alerts for this check.
# However, you can add them yourself, as shown above.
punishments: []
# The advertising check will prevent players from sending IP addresses and links in the chat.
# The advanced mode provides an additional level of protection but may result in some normal messages being blocked.
advertising:
enabled: true
message: "Advertising is not allowed on our network!"
# Please note that this may result in some false positives!
advanced: false
By installing or using ChatProtect, you acknowledge and agree to the following:
Data Processing: ChatProtect sends a small, rate-limited sample of player chat messages to our secure servers. These messages are then forwarded to the Google Perspective API solely to obtain toxicity scores for moderation purposes.
No Personally Identifiable Information (PII) Sent: Usernames, IP addresses, server IDs, and any other personally identifiable information are never transmitted to Google or stored by our servers. Only the raw chat text is analyzed.
Consent Requirement: As the server owner, you are solely responsible for informing all players that a small portion of their chat messages may be processed for AI moderation. This disclosure must be included in your server’s public Privacy Policy or Terms of Service, in a clear and visible manner, before players use your server.
Compliance: ChatProtect has been designed to minimize privacy risks. However, you must ensure your server complies with all applicable data protection laws (e.g., GDPR, CCPA) regarding user consent and data handling.
Opt-Out and Liability: By using this plugin, you confirm that players have been or will be informed and have consented as required by law. ChatProtect and its developers are not liable for failure to obtain proper player consent or legal compliance.
Please send a private message for support! Leave a review