GGuard
GGuard is a lightweight and highly configurable Paper plugin that protects your server from bad words, chat bypass attempts, and spam while providing an easy-to-use management interface for staff.
This is my first public plugin. Previously, I mainly developed private plugins directly for Minecraft servers, and I'm excited to finally share one with the community.
Features
🚫 Advanced Bad Word Filter
Block any word listed in
badwords.yml.Easily add or remove blocked words.
Advanced anti-bypass detection that catches variations such as:
fishFIshfi_shfi\sh- and many other common bypass methods.
💬 Anti-Spam Protection
- Detects spam messages automatically.
- Fully integrated with the flag system.
🚩 Flag System
- Players receive flags when they violate chat rules.
- Configure how many flags are required before punishment is applied.
- Fully customizable through configuration files.
🔇 Automatic Mute System
- Automatically executes a configurable mute command once a player reaches the flag limit.
- Use your preferred punishment plugin by changing the command in the config.
Commands
| Command | Aliases | Description | Permission |
|---|---|---|---|
/chatmoderation reload |
/cm reload |
Reload all plugin configuration files without restarting the server. | chatmoderation.admin |
/chatmoderation resetflags <player> |
/cm resetflags <player> |
Reset a player's flag count. | chatmoderation.admin |
/chatflags |
/flags, /chatflag |
Open the staff moderation GUI to view flagged players, flag counts, chat history, and manage punishments. | chatmoderation.admin |
Permissions
| Permission | Description | Default |
|---|---|---|
chatmoderation.admin |
Grants access to all admin commands and the moderation GUI. | OP |
chatmoderation.bypass.spam |
Allows a player to bypass the anti-spam system. | False |
chatmoderation.bypass.badwords |
Allows a player to bypass the bad word filter. | False |
chatmoderation.notify |
Receives notifications whenever a player is flagged. | OP |
🖥️ Staff Management GUI
Manage flagged players through an intuitive GUI.
Available actions include:
- View flagged players
- View each player's flag count
- Mute
- Unmute
- Clear flags
- Additional management actions
⚙️ Highly Configurable
Almost everything can be customized:
- Messages
- GUI layouts
- Bad word list
- Flag limits
- Punishment commands
- And much more
Tested
GGuard has been tested on alaskamc.xyz, where it performed reliably in production without issues.
If you're looking for a server to play on, feel free to check them out—they offer both SMP and BoxPvP.
Future Plans
This is only the beginning. Planned updates include:
- Support for more Minecraft/Paper versions
- New moderation features
- Performance improvements
- Additional GUI options
- More configuration settings based on community feedback
Feedback
If you enjoy GGuard, consider leaving a review, reporting bugs, or suggesting new features. Sharing the plugin with other server owners is also greatly appreciated.
Thank you for your support, and I hope GGuard helps keep your server's chat clean and enjoyable!
