AntiSpam

A lightweight, fully configurable chat spam protection plugin for Paper servers — with optional EssentialsX integration for mutes and kicks.

✨ Features

• Message cooldown — Stops players from flooding chat with a configurable delay between messages.
• Escalating punishments — Automatically progresses from warn → mute → kick, each with its own configurable threshold.
• EssentialsX support — Optionally uses EssentialsX's /mute and /kick commands to integrate with your existing punishment history and logs.
• Built-in fallback — No EssentialsX? No problem. Use the plugin's internal mute and kick system with a single config option.
• Fully configurable — Enable or disable the entire plugin, warnings, mutes, and kicks independently. Only want warnings? Disable mutes and kicks.
• Bypass permission — Exempt staff or trusted players from all spam checks.
• Reload support — Reload the configuration without restarting your server.

⚙️ Configuration

enabled: true
cooldown-seconds: 1.5

warn:
  enabled: true
  message: "&cYou're sending messages too fast!"

mute:
  enabled: true
  threshold: 5
  use-essentials: true
  essentials-duration: "2h"
  internal-duration-minutes: 120
  reason: "Spamming chat"
  message: "&cYou have been muted for spam."

kick:
  enabled: false
  threshold: 10
  use-essentials: true
  reason: "Kicked for spam"
  message: "&cYou have been kicked for spam."

📜 Commands

🔑 Permissions

📦 Requirements

• Paper 1.21+
• EssentialsX (optional — only required when use-essentials is enabled)