AntiSpam with web panel

AntiSpam - Professional Chat Moderation & Web Panel Control

AntiSpam is a powerful, modern, and all-in-one chat management solution for Minecraft servers. It is designed to keep your server chat clean and professional by automatically blocking unwanted behavior. The plugin is built with high performance in mind, ensuring it does not impact your server's TPS, even on large networks.

CORE FEATURES

• Advanced Chat Filtering
  • Percentage-Based Anti-Spam: No more clever filter bypasses! The plugin compares message similarity in percentages (fully configurable) and effectively blocks repetitive content.
    
    
  • Anti-Flood: Instantly blocks messages sent too fast or messages containing excessive repeating characters (for example: "ssssssssss").
    
    
  • Blocked Words: A fully customizable blacklist to prevent offensive language, which reliably catches blacklisted words even when hidden inside other text.
• Ladder Punishment System
  • Configure escalating punishments for each category separately.
    
    
  • Example: 1st offense = 30 min mute, 2nd offense = 2 hours, 3rd offense = Ban.
    
    
  • Full compatibility with custom commands and any moderation/ban plugins.
• Smart Chat Reporting
  • Players can report toxic users using /chatreport <player>.
    
    
  • Chat Logs: The plugin automatically archives recent messages from the reported player.
    
    
  • Admin GUI: Review reports directly in-game through an interactive book featuring clean pagination and color-coded message separators.
• Web Panel Integration
  • With MySQL database support, you gain access to an external web-based dashboard.
    
    
  • Search punishment records, view chat logs, and manage violations remotely from a web browser.
• Enhanced Discord Webhooks
  • Receive modern, real-time Discord notifications featuring thumbnails, custom footers, icons, clean formatting, and a clickable title link.
• 100% Modular
  • Every feature can be independently enabled or disabled in the configuration.

ADMIN UTILITIES

• Unique Punishment IDs: Every violation receives its own unique ID, making it easy to search, track, and verify records.
  
  
• Language Support: Built-in support for English, Czech, and German with easy translation editing.
  
  
• Bypass Permissions: Ability to grant players immunity from filters or report protections.

COMMANDS & PERMISSIONS
Command Description Permission
/antispam reload Reloads configuration and language files antispam.reload
/antispam check <ID> Displays detailed information about a punishment antispam.admin
/chatreport <player> Reports a player for chat violations antispam.chatreport
/chatreportlogs Displays recent chat reports antispam.admin
Additional Permissions:

• antispam.bypass – Completely bypasses all AntiSpam checks.
  
  
• antispam.punishnotify – Allows staff members to receive in-game notifications whenever a player is automatically punished.

REQUIREMENTS

• Storage: SQLite (built-in, zero setup required) or MySQL (required for the Web Panel).
  
  
• Compatibility: Fully compatible with all major permission plugins including LuckPerms.

PREVIEW & CONFIGURATION

• In-Game Report Book & Log Examples:
  
  
• Web panel:
  
  
  
  
  
  
  
• Default Configuration File (config.yml):

# --------------------------------------------
#
#          AntiSpam 3.2.0
#
# Thank you for downloading this plugin
# don't forget to leave a review
#
# if you have a suggestion for what could
# be added, write it to me on discord
#
# Plugin Developer: Kijler
# Discord Support: https://discord.gg/sk4QQAU2yv
#
# My websites: https://kijler.eu
#
# --------------------------------------------

server-name: Lobby

# Select the plugin language.
# Available options: EN (English), CZ (Czech), DE (German).
# You can edit these files in the /languages/ folder.
language: EN

# Database Configuration
# Type: Choose between "SQLITE" (local file) or "MYSQL" (external database).
# If using SQLITE, the file 'data.db' will be created in the plugin folder.
# If using MYSQL, fill in the host, port, database, username, and password.
database:
  type: SQLITE
  host: localhost
  port: 3306
  database: antispam_db
  username: root
  password: password
  useSSL: false

# Chat Restrictions
# block-repeated-messages: If true, prevents players from sending similar messages repeatedly.
# repeat-message-delay: How many seconds a player must wait before sending the same message again.
# similarity-percentage: How similar (in percent) a message must be to the previous one to be blocked as spam.
# delay: The global cooldown in seconds between any chat messages.
# block-repeated-characters: Prevents excessive character repetition (e.g., "hellloooo").
# max-repeating-characters: The maximum allowed number of identical consecutive characters.
block-repeated-messages: true
repeat-message-delay: 60
similarity-percentage: 65.0
delay: 3
block-repeated-characters: true
max-repeating-characters: 3

# Report Settings
# enabled: Toggle the whole chat reporting system on or off.
# report-messages-count: Defines how many recent messages should be stored when reporting a player.
report-feature:
  enabled: true
report-messages-count: 5

# Punishment Settings
# punishment-issuer: The name that will appear as the source of the punishment command.
# punishment-notifications: Sends an alert to online staff (with antispam.punishnotify) when a player gets punished.
punishment-issuer: AntiSpam
punishment-notifications:
  enabled: true

# Punishment Categories
# You can configure automatic punishments for each violation type.
# enabled: Toggle this punishment category on or off.
# threshold: How many times a player must violate the rule before the command is executed.
# command: The fallback command to execute when the threshold is reached (used if ladder is disabled).
# ladder-enabled: If true, the plugin will track the player's previous violations and escalate the punishment.
# ladder: Defines the escalating sequence of commands. Level 1 is the first punishment, Level 2 is the second, etc.
# Placeholders: %player% (player name), %punish_id% (unique ID of the violation).
punishments:
  blocked-word:
    enabled: true
    threshold: 3
    command: tempmute %player% 2h Inappropriate behavior (#%punish_id%)
    ladder-enabled: true
    ladder:
      1: "tempmute %player% 30m Inappropriate behavior (#%punish_id%)"
      2: "tempmute %player% 2h Inappropriate behavior (#%punish_id%)"
      3: "tempmute %player% 10d Inappropriate behavior (#%punish_id%)"
      4: "ban %player% Inappropriate behavior (#%punish_id%)"

  spam:
    enabled: true
    threshold: 5
    command: tempmute %player% 30m Spamming (#%punish_id%)
    ladder-enabled: true
    ladder:
      1: "tempmute %player% 30m Spamming (#%punish_id%)"
      2: "tempmute %player% 2h Spamming (#%punish_id%)"
      3: "tempmute %player% 10d Spamming (#%punish_id%)"
      4: "ban %player% Spamming (#%punish_id%)"

  flood:
    enabled: true
    threshold: 5
    command: tempmute %player% 15m Flood (#%punish_id%)
    ladder-enabled: true
    ladder:
      1: "tempmute %player% 30m Flood (#%punish_id%)"
      2: "tempmute %player% 2h Flood (#%punish_id%)"
      3: "tempmute %player% 10d Flood (#%punish_id%)"
      4: "ban %player% Flood (#%punish_id%)"

discord-webhook:
  enabled: false
  url: https://discord.com/api/webhooks/your_webhook_url_here
  embed:
    title: "⚠️ New Chat Report Alert!"
    color: 16711680
    thumbnail: https://www.spigotmc.org/data/resource_icons/118/118730.jpg?1723066545
    description: |-
      > A player has been reported for inappropriate chat behavior. Please review the details below.
  
      **Reported Player:** `%reported%`
      ️ **Reporter:** `%reporter%`
  
      **Server:** `%server%`
      ️ **Report ID:** `#%id%`
    footer:
      text: "AntiSpam System • Chat Moderation"
      icon_url: https://www.spigotmc.org/data/resource_icons/118/118730.jpg?1723066545
    title-url: "https://www.spigotmc.org/resources/antispam-with-web-panel.118730/"

SUPPORT & COMMUNITY
By downloading this plugin, you agree not to redistribute, resell, or claim it as your own work. If you encounter any bugs, please report them through my Discord server rather than in the reviews.

Thank you for using AntiSpam!