ANTI-SPAM v1.0
DEVELOPER: Mattis VERSION: 1.0.0 COMPATIBILITY: Paper, Folia (1.21.1+) LICENSE: Custom / All Rights Reserved
OVERVIEW Anti-Spam is a high-performance chat security system designed to maintain server decorum and prevent chat flooding. Built with a focus on thread-safety and advanced string-matching, it stops repetitive messaging patterns before they reach your players.
KEY FEATURES
- Smart Similarity Engine: Utilizes the Levenshtein Algorithm to identify and block "similar" messages, preventing bypasses like adding a single dot or space.
- Per-Player Message Memory: Maintains a rolling buffer of the last 10 messages (configurable) for every online player to detect long-term repetition.
- Thread-Safe Architecture: Engineered for Folia using ConcurrentHashMaps and synchronized logic to ensure stability in multi-threaded environments.
- Bypass Support: Integrated permission system allowing staff or automated bots to bypass spam restrictions.
COMMANDS AND PERMISSIONS
- /antispam reload Refreshes the configuration file and clears the current message history cache. Permission: antispam.admin
SECURITY LOGIC PROTOCOL
- NORMALIZATION: Incoming strings are trimmed and converted to lowercase for accurate comparison.
- BUFFER CHECK: The new message is compared against the player's recent historical chat data.
- SIMILARITY SCORING: If the calculated similarity exceeds the threshold (default: 80%), the message is canceled.
- NOTIFICATION: The player is issued an instant warning to prevent further repetition.
TECHNICAL REQUIREMENTS
- Java 21 or higher.
- Paper or Folia 1.21.1 or higher.
- Concurrent data handling support.
