VelocityChatFilter

A lightweight and powerful chat filter plugin for Velocity proxy.

---

Features

• Words Filter — Block messages containing blacklisted words
• Spam Filter — Prevent players from sending messages too quickly
• Similar Filter — Block identical consecutive messages
• Regex Filter — Detect bypass attempts like F.U.C.K or F U C K
• Caps Filter — Block messages with excessive uppercase
• Links Filter — Prevent players from sending URLs

---

Per-Server Configuration

Configure different settings for each backend server. Server settings override global settings automatically.

---

Customizable Messages

Choose how blocked messages appear:

• Chat message
• Actionbar
• Title
• Subtitle

Each filter can play a custom sound when triggered.

---

Commands

Command	Description
/chatfilter info	View current server settings
/chatfilter global info	View global settings
/chatfilter blacklist-word <word>	Add a blocked word
/chatfilter whitelist-word <word>	Remove a blocked word
/chatfilter enable-feature <feature>	Enable a filter
/chatfilter disable-feature <feature>	Disable a filter
/chatfilter spam-cooldown <seconds>	Set spam cooldown
/chatfilter edit-message <feature> <type> <text>	Change filter message
/chatfilter edit-message-sound <feature> <sound>	Change filter sound
/chatfilter reload	Reload configuration

Use /chatfilter global <command> to apply changes to all servers.

Permissions

Permission	Description
velocitychatfilter.admin	Access to all commands
velocitychatfilter.bypass	Bypass all chat filters

---

Supported Versions

• Velocity 3.3.0+
• Minecraft 1.21.x
• Works with all backend servers (Paper, Purpur, Spigot, Folia, etc.)

---

Installation

1. Download the jar file
2. Place it in your Velocity plugins folder
3. Restart the proxy
4. Configure in plugins/velocitychatfilter/config.yml

---

Support

Please contact me on Discord if you have any suggestions or edits.