AntiSlur

A powerful, highly configurable chat moderation plugin for Paper and Spigot servers.

Unlike basic word filters that simply block messages, AntiSlur categorizes offenses, tracks repeat offenders, automatically escalates punishments, detects common bypass methods, and integrates with EssentialsX and Discord—all while remaining easy to configure.

---

✨ Features

📂 Category-Based Filtering

Organize blocked words into custom categories such as Slurs, Profanity, Harassment, Advertising, or any category you create.

Each category can have its own:

• Severity level
• Detection strictness
• Punishment settings
• Override actions

---

⚠️ Automatic Punishment Escalation

AntiSlur tracks player violations and automatically increases punishments over time.

Example progression:

Warning → Mute → Longer Mute → Kick → Temporary Ban → Permanent Ban

Everything is fully configurable.

---

🚨 Instant Punishments

Need certain words to receive an immediate punishment?

Configure any category to instantly:

• Warn
• Mute
• Kick
• Tempban
• Permanently ban

Perfect for zero-tolerance slur policies.

---

🧠 Advanced Bypass Detection

AntiSlur detects many common attempts to bypass filters, including:

• Leetspeak

  • h3ll0
  • b@dw0rd

• Repeated letters

  • baaaadword

• Accented characters

  • bädwörd

• Spaced-out words

  • b a d w o r d

• Mixed formatting tricks

Whole-word matching helps prevent false positives such as detecting "ass" inside "class".

---

🔗 EssentialsX Integration

Already using EssentialsX?

AntiSlur can automatically use EssentialsX's punishment commands, keeping all moderation history centralized.

No EssentialsX?

Simply enable the built-in punishment system.

---

📨 Discord Webhook Logging

Automatically log every violation to Discord.

Each log can include:

• Player
• Category
• Detected word
• Original message
• Violation score
• Punishment taken
• Timestamp

Webhook requests are asynchronous to avoid impacting server performance.

---

💬 Fully Customizable Messages

Every player-facing message can be edited.

Supports:

• Minecraft color codes
• Custom prefixes
• Personalized punishment messages

Only the offending player sees filter messages, keeping chat clean for everyone else.

---

🛠️ In-Game Administration

Manage everything without restarting your server.

Available commands include:

• Reload configuration
• Add blocked words
• Remove blocked words
• List categories
• Check violation scores
• Reset violations
• Mute or unmute players
• Test Discord webhooks

---

⚙️ Example Configuration

Basic Category

profanity:
  - word1
  - word2
  - word3

Advanced Category

slurs:
  severity: severe
  strict: true
  action: tempban

  words:
    - word1
    - word2

---

📖 Commands

Command	Description
/antislur reload	Reload the configuration
/antislur add	Add a filtered word
/antislur remove	Remove a filtered word
/antislur list	List categories and words
/antislur check	View a player's violation score
/antislur mute	Mute a player
/antislur unmute	Unmute a player
/antislur reset	Reset a player's violations
/antislur testwebhook	Test the configured Discord webhook

---

🔐 Permissions

Permission	Description
antislur.admin	Access all admin commands
antislur.bypass	Bypass all filtering and punishments

---

📦 Requirements

• Paper / Spigot 1.21+
• Java 21+
• EssentialsX (Optional — only required if using Essentials punishments.)

---

❤️ Why AntiSlur?

Most chat filters only block messages.

AntiSlur is designed to be a complete moderation solution—combining intelligent detection, configurable punishments, Discord logging, and category-based filtering into one lightweight plugin that's simple to configure and powerful enough for large communities.