HolaAntiSpam

HolaAntiSpam is a velocity plugin to manage chat spam and command spam

101

HolaAntiSpam

<p align="center">HolaAntiSpam</p>

<div align="center"> <!-- Discord Button --> <a href="https://discord.gg/JY5HchybGz" target="_blank"> <img src="https://img.shields.io/badge/Discord-7289DA?style=for-the-badge&logo=discord&logoColor=white&labelColor=5865F2" alt="Discord"> </a>

<!-- GitHub Button --> <a href="https://github.com/M0-kii" target="_blank"> <img src="https://img.shields.io/badge/GitHub-181717?style=for-the-badge&logo=github&logoColor=white&labelColor=000000" alt="GitHub"> </a> </div>

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:

Configuration settings

```yaml 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 configuration

```yaml 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

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

/has 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.*

ADS