HolaAntiSpam

What is HolaAntiSpam?

HolaAntiSpam is a powerful anti-spam plugin designed for Velocity-powered Minecraft servers. It ensures a clean and professional server environment by preventing spam in chat and command usage. With configurable cooldowns, message length restrictions, and duplicate message detection, HolaAntiSpam empowers server administrators to maintain order and enhance the player experience.

Features

• 🛡️ Chat Cooldowns: Enforce customizable cooldowns between chat messages to prevent rapid spamming, ensuring smooth and controlled communication.

• ⏲️ Command Cooldowns: Apply cooldowns to command executions, reducing command spam and server overload.

• ✅ Duplicate Message Detection: Detect and block repeated messages, maintaining chat clarity and preventing abuse.

• 📏 Message Length Limits: Restrict message length to prevent overly long or spammy messages, with configurable maximum lengths.

• 🚨 Real-Time Alerts: Notify staff with the holaantispam.admin permission of spam violations through in-game and console alerts, with one-time alerts per player to avoid notification spam.

• ⚒️ Reloadable Configuration: Use /holaantispam reload or /has reload to dynamically update settings without restarting the server.

• 📘 Permission-Based Controls: Support for bypass permissions (holaantispam.bypass) to exempt certain players and reload permissions (holaantispam.admin) for configuration management.

• ✨ Customizable Alerts: Fully configurable alert formats using MiniMessage, with support for gradients, hover events, and click-to-copy player names for enhanced usability.

🫙 Requirements

• Velocity 3.3.0+
• Java 17+

⚙️ Configuration

HolaAntiSpam offers a highly customizable config.yml to tailor anti-spam settings to your server’s needs.

Anti-Spam Settings:

settings:
  # Prefix displayed before all messages
  prefix: "<gradient:dark_aqua:aqua>[HolaAntiSpam]</gradient> "

  # Permission required to receive spam alerts
  notify-permission: "holaantispam.admin"

  # Permission to bypass anti-spam restrictions
  bypass-permission: "holaantispam.bypass"

  # Permission to reload the configuration
  reload-permission: "holaantispam.admin"

chat:
  # Cooldown between chat messages (in milliseconds)
  cooldown-ms: 2000

  # Maximum allowed message length
  max-length: 100

command:
  # Cooldown between command executions (in milliseconds)
  cooldown-ms: 1000

spam:
  # Number of violations before resetting spam score
  threshold: 3

logging:
  # Enable or disable console logging
  enable: true

Messages Configuration:

messages:
  # Message displayed when configuration is reloaded
  reload: "<prefix><gray>[<green>✓</green>]</gray> <green>Configuration reloaded successfully!</green>"

  # Message displayed when the player lacks permission
  no-permission: "<prefix><gray>[<dark_red>✕</dark_red>]</gray> <gradient:dark_red:red>You do not have permission to use this command!</gradient>"

  spam:
    # Alert format sent to players with notify permission
    player: |
      <prefix><gray>╔══════════════╗</gray>
      <prefix><red>║ ⚠ <dark_red><bold>SPAM ALERT</bold></dark_red> ⚠ ║</red>
      <prefix><gray>╠══════════════╣</gray>
      <prefix><gray>╠ Player: <yellow><hover:show_text:'<green>Click to copy player name!</green>'><click:copy_to_clipboard:<player>><player></click></hover></yellow>
      <prefix><gray>╠ Message: <white><message></white>
      <prefix><gray>╚══════════════╝</gray>

    # Alert format sent to console
    console: |
      <prefix><gray>╔═══════════════╗</gray>
      <prefix><red>║ ⚠ <dark_red><bold>SPAM ALERT</bold></dark_red> ⚠ ║</red>
      <prefix><gray>╠═══════════════╣</gray>
      <prefix><gray>╠ Player: <yellow><player></yellow>
      <prefix><gray>╠ Message: <white><message></white>
      <prefix><gray>╚═══════════════╝</gray>

  violation:
    # Message sent to players on spam violation
    cooldown: "<prefix><gray>[<dark_red>✕</dark_red>]</gray> <red>Please wait before sending another message.</red>"
    repeated: "<prefix><gray>[<dark_red>✕</dark_red>]</gray> <red>Repeated messages are not allowed.</red>"
    length: "<prefix><gray>[<dark_red>✕</dark_red>]</gray> <red>Message exceeds maximum length of <length> characters.</red>"
    command: "<prefix><gray>[<dark_red>✕</dark_red>]</gray> <red>Please wait before executing another command.</red>"

📝 Commands

/holaantispam or /has: Displays plugin information and current spam scores.

/holaantispam reload or /has reload: Reloads the configuration (requires holaantispam.admin permission).

🔐 Permissions

holaantispam.admin: Receive in-game spam alerts and reload the configuration.

holaantispam.bypass: Bypass anti-spam restrictions for chat and commands.

🌟 Why Choose HolaAntiSpam?

HolaAntiSpam is the perfect solution for server administrators looking to maintain a spam-free environment without compromising performance. Its lightweight design, single-alert system to prevent notification spam, and extensive configuration options make it suitable for servers of all sizes. Whether you run a small community or a large network, HolaAntiSpam ensures a clean and enjoyable player experience.

Developed by M0_kii, HolaAntiSpam combines robust functionality with a user-friendly configuration, making spam prevention effortless and effective.