Skip to content

wulnrydev/wChatShield

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

wChatShield

wChatShield is a lightweight, asynchronous, and high-performance chat security and moderation plugin for Minecraft servers. It is built to operate with zero lag, ensuring your server's chat is kept clean and safe.

Features

  • Asynchronous Processing: All chat checks and database operations run asynchronously to prevent server lag.
  • SQLite Warning System: Automatically tracks player warnings and issues commands when the limit is reached.
  • Discord Webhook Integration: Notifies a Discord channel of chat violations.
  • In-Game Staff Notifications: Alerts staff when a player is warned or punished (with opt-out support).
  • Reload Command: Reload configurations without losing in-memory data such as smart cooldowns or anti-flood timestamps.

Modules

wChatShield comes with a variety of modules that can be toggled via config.yml:

  • anti-swear: Advanced filter with multiple severity categories.
  • anti-link: Blocks unauthorized URLs while supporting a whitelist.
  • anti-spam: Prevents repetitive messages using Levenshtein distance checks.
  • anti-flood: Restricts the number of messages sent within a specific timeframe.
  • anti-caps: Prevents excessive use of uppercase letters.
  • anti-zalgo: Blocks strange or unreadable unicode symbols (Zalgo).
  • anti-unicode: Prevents the use of emojis and non-standard mathematical characters.
  • anti-ip: Detects and blocks IPv4 addresses.
  • smart-cooldown: Enforces a mandatory cooldown delay between consecutive messages.
  • anti-repeat-char: Trims or blocks messages with excessively repeated characters (e.g., "aaaaa").

Commands

  • /wcs reload - Reloads the plugin configuration and modules seamlessly.
  • /wcs status - Displays the status of all active chat modules.
  • /wcs notify - Toggles in-game punishment notifications for staff.
  • /wcs warnings check <player> - Shows a player's current warning count.
  • /wcs warnings reset <player> - Resets a player's warning count.

Aliases: /wchatshield, /shield

Permissions

Admin Permissions

  • wchatshield.admin - Full access to all /wcs commands.
  • wchatshield.notify - Permission to receive in-game staff notifications.

Bypass Permissions

If a player has OP or the bypass permission for a module, they will not be checked by that specific module.

  • wchatshield.bypass.anti-swear
  • wchatshield.bypass.anti-link
  • wchatshield.bypass.anti-spam
  • wchatshield.bypass.anti-flood
  • wchatshield.bypass.anti-caps
  • wchatshield.bypass.anti-zalgo
  • wchatshield.bypass.anti-unicode
  • wchatshield.bypass.anti-ip
  • wchatshield.bypass.smart-cooldown
  • wchatshield.bypass.anti-repeat-char

Installation

  1. Drop the wChatShield-1.0.0.jar into your server's plugins folder.
  2. Restart the server.
  3. Edit the config.yml inside the plugins/wChatShield folder to fit your needs.
  4. Run /wcs reload in-game or via console.

About

A lightweight, modular, and zero-lag asynchronous chat security plugin for Minecraft.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages