Anti-Spam Plugin

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

1. NORMALIZATION: Incoming strings are trimmed and converted to lowercase for accurate comparison.
2. BUFFER CHECK: The new message is compared against the player's recent historical chat data.
3. SIMILARITY SCORING: If the calculated similarity exceeds the threshold (default: 80%), the message is canceled.
4. 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.