AntiSpam

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

---

✨ Features

• 🚫 Chat Cooldown
  Prevent players from flooding chat with a configurable delay between messages.

• ⚠️ Escalating Punishments
  Automatically escalate from Warn → Mute → Kick based on configurable thresholds.

• 🔗 EssentialsX Integration
  Use EssentialsX's /mute and /kick commands to keep punishment history and logs in one place.

• 🛠️ Built-in Fallback System
  Don't use EssentialsX? The plugin includes its own internal mute and kick system.

• ⚙️ Fully Configurable
  Enable or disable warnings, mutes, kicks, or the entire plugin independently.

• 👮 Bypass Permission
  Allow staff or trusted players to bypass all spam protection.

• 🔄 Hot Reload
  Reload the configuration without restarting your server.

---

📖 Commands

Command	Description	Permission
/antispam reload	Reload the plugin configuration	antispam.reload
/antispam unmute <player>	Remove an internal mute	antispam.unmute

---

🔑 Permissions

Permission	Description	Default
antispam.reload	Reload the configuration	OP
antispam.unmute	Unmute internally muted players	OP
antispam.bypass	Bypass all spam checks	False

---

⚙️ Example 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."

---

📦 Requirements

• Paper 1.21+
• Java 21+
• EssentialsX (Optional - only required when use-essentials is enabled.)

---

❤️ Support

If you find a bug or have a feature request, please open an issue on GitHub or leave a comment on the Modrinth page.