Internet Explorer
Internet Explorer is not supported. Please upgrade to a more modern browser.
GateWayMC-Core
BetterTeam Extension (team/ally chat filter)
[1.0.0] team/ally chat filter!1.0.0 6 days ago
BetterTeams Chat Filter Extension
Advanced chat filtering for BetterTeams - Block bad words and URLs in team & ally chat!
Description
BetterTeams Chat Filter is a powerful extension for the BetterTeams plugin that adds comprehensive chat filtering to both team chat and ally chat. Keep your server's team communications clean and safe!
✨ Features
- Bad Words Filter - Block inappropriate language in team/ally chat
- URL Filter - Prevent spam links and malicious URLs
- Specific URL Pattern Blocking - Block discord.gg, bit.ly, and other specific domains
- Team Chat Filtering - Works with BetterTeams team chat
- Ally Chat Filtering - Also filters ally chat messages
- Flexible Word Matching - Match words exactly or inside other words
- Customizable Messages - Edit all warning messages with color codes
- Easy Configuration - Simple YAML configuration file
How It Works
- Players send messages in team or ally chat
- The extension checks the message against your filter rules
- If bad words or URLs are detected, the message is blocked
- The player receives a customizable warning message
- Clean communication for everyone!
Installation
- Make sure you have BetterTeams 5.0.0+ installed
- Download BetterTeamChatFilter.jar
- Place it in plugins/BetterTeams/extensions/
- Restart your server
- Configure the filter in plugins/BetterTeams/extensions/BetterTeamChatFilter/filter-config.yml
⚙️ Configuration
filter:
blockInsteadOfReplace: true
blockedMessage: "&cYour message was blocked in team/ally chat."
# Bad words filter
blocked:
- "shit"
- "fuck"
- "bitch"
- "idiot"
- "pussy"
- "kiddo"
- "nigger"
- "nigga"
- "faggot"
- "retard"
- "asshole"
- "dick"
- "cunt"
- "stfu"
- "kys"
matchInsideWords: true
# URL filter (NEW!)
blockUrls: true
urlBlockedMessage: "&cURLs are not allowed in team/ally chat!"
# Blocked URL patterns (blocks discord.gg, bit.ly, etc.)
blockedUrlPatterns:
- "discord.gg"
- "discord.com/invite"
- "bit.ly"
- "tinyurl.com"
- "youtu.be"
Configuration Options
General Settings:
- blockInsteadOfReplace - true = block messages, false = allow messages (default: true)
- blockedMessage - Message shown when a message is blocked
Bad Words Filter:
- blocked - List of words to block
- matchInsideWords - true = match "bad" in "badger", false = exact word match only
URL Filter:
- blockUrls - Enable/disable URL blocking
- urlBlockedMessage - Message shown when URLs are blocked
- blockedUrlPatterns - Specific URL patterns to block (discord.gg, bit.ly, etc.)
Color Codes
All messages support Minecraft color codes using the & symbol:
&0 = Black &8 = Dark Gray
&1 = Dark Blue &9 = Blue
&2 = Dark Green &a = Green
&3 = Dark Aqua &b = Aqua
&4 = Dark Red &c = Red
&5 = Dark Purple &d = Light Purple
&6 = Gold &e = Yellow
&7 = Gray &f = White
&l = Bold &n = Underline
&o = Italic &r = Reset
Examples
Example 1: Block Discord invites
blockedUrlPatterns:
- "discord.gg"
- "discord.com/invite"
Example 2: Custom warning message
blockedMessage: "&c&l[WARNING] &eYour message contained inappropriate content!"
Example 3: Exact word matching only
matchInsideWords: false # "hell" won't match "hello"
❓ FAQ
Q: Does this work with both team chat and ally chat?
A: Yes! It filters both team chat and ally chat messages.
Q: Can I customize the blocked words list?
A: Absolutely! Edit the filter-config.yml file and add/remove any words you want.
Q: Does it support regex patterns?
A: Currently it uses simple string matching for maximum performance.
Q: Will it slow down my server?
A: No, the filter is highly optimized and has minimal performance impact.
Q: Can I block specific domains only?
A: Yes! Use the blockedUrlPatterns list to block specific domains while allowing others.
Requirements
- Minecraft Server 1.18+
- BetterTeams 5.0.0 or higher
- Java 17+
Bug Reports & Suggestions
Found a bug or have a suggestion? Please report it in the discussion section!
License
This extension is provided as-is. Feel free to use it on your server!
Support
If you like this extension, please leave a review! It helps other server owners find this resource.
Download now and keep your team chat clean! ️
13 downloads |
Resource
Views
99
Total Downloads
13
First Release
27 Mar 2026
Last Release
27 Mar 2026
Category
BetterTeam Extensions
Rating
Version 1.0.0
Downloads
13
Release
27 Mar 2026, 08:54
Rating
