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:**
[HolaAntiSpam] "
# 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:**
[✓ ] Configuration reloaded successfully! "
# Message displayed when the player lacks permission
no-permission: "[✕ ] You do not have permission to use this command!"
spam:
# Alert format sent to players with notify permission
player: |
╔══════════════╗
║ ⚠ SPAM ALERT
╠══════════════╣
╠ Player: Click to copy player name!'>> ╠ Message: ╚══════════════╝
# Alert format sent to console
console: |
╔═══════════════╗
║ ⚠ SPAM ALERT
╠═══════════════╣
╠ Player: ╠ Message: ╚═══════════════╝
violation:
# Message sent to players on spam violation
cooldown: "[✕ ] Please wait before sending another message. "
repeated: "[✕ ] Repeated messages are not allowed. "
length: "[✕ ] Message exceeds maximum length of characters. "
command: "[✕ ] Please wait before executing another command. "
```