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!
Native Major MC Version 1.18
Tested Major MC Versions
1.21
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! ️
Contributors: ProsameOG Download Other Releases
Resource
Views
97
Total Downloads
12
First Release
27 Mar 2026
Last Release
27 Mar 2026
Category
BetterTeam Extensions
Rating
Version 1.0.0
Downloads
12
Release
27 Mar 2026, 08:54
Rating
Reviews
No reviews