# **

HolaAlerts

## What is HolaAlerts? **HolaAlerts** is a robust chat monitoring plugin designed for Velocity-powered Minecraft servers. It provides advanced chat filtering and alert functionalities to maintain a safe and professional server environment. With HolaAlerts, server administrators can effectively monitor and moderate player chat, ensuring compliance with community standards by detecting and censoring inappropriate language and advertisements. ## **Features** - 🛡️ **Chat Filtering**: Automatically censors predefined swear words and advertisement patterns in player chat, with customizable replacement characters. - ✅ **Advertisement Whitelisting**: Allows specific domains or patterns (e.g., example.com) to bypass advertisement filtering, ensuring flexibility for server promotion. - ⏲️ **Real-Time Alerts**: Sends in-game and console alerts to staff with configurable permissions (holaalerts.notify) when inappropriate content is detected, with distinct formatting for swear words and advertisements. - 📘 **Discord Webhook Integration**: Delivers detailed alerts to a Discord server via customizable webhooks, including options for titles, colors, field names, footers, and timestamps for both bad word and advertisement alerts. - ❓ **Permission-Based Controls**: Supports bypass permissions (holaalerts.bypass) for exempting certain players from chat filtering and reload permissions (holaalerts.reload) for configuration management. - ⚒️ **Reloadable Configuration**: Easily reload the plugin’s configuration using /holaalerts reload or /ha reload commands, enabling dynamic updates without server restarts. - ⛏️ **Customizable Alerts**: Offers highly configurable alert formats with MiniMessage support, allowing for rich text formatting, hover events, and click-to-copy functionality for player names. ## 🫙 Requirements - Velocity 3.3.0+ - Java 17+ ## ⚙️ Configuration HolaAlerts provides a comprehensive `config.yml` for full customization. **Word Filtering:**

Words configuration

``` filters: # List of words that will be censored in chat # You can add/remove words as needed swear-words: - example - test - badword # List of advertisement patterns to censor # These patterns will trigger advertisement alerts unless whitelisted ads: - .com - .net - example.org # List of advertisement patterns to exclude from censorship # Messages containing these patterns will not be censored for advertisements # Example: Add allowed domains like 'myserver.com' to prevent censorship ads-whitelist: - exmaple.com - example.net ```

**Discord webhook settings:**

Discord webhook configuration

``` discord: # Discord webhook URL for sending alerts # Obtain this from your Discord server: Server Settings > Integrations > Create Webhook webhook-url: "" # Enable or disable Discord webhook notifications enabled: false # Title for bad word alerts in Discord embeds bad-word-title: "⚠️ BAD WORD ALERT ⚠️" # Title for advertisement alerts in Discord embeds advertise-title: "🛡️ ADVERTISEMENT ALERT 🛡️" # Color for bad word alerts in Discord embeds (hex or decimal, e.g., "FF0000" or "16711680" for red) bad-word-color: "FF0000" # Color for advertisement alerts in Discord embeds (hex or decimal, e.g., "AA00FF" or "11141120" for purple) advertise-color: "FFF700" # Field name for the player in Discord embeds player-field-name: "Player" # Field name for the message in Discord embeds message-field-name: "Message" # Footer text for Discord embeds (e.g., server name or branding) footer: "" # Show timestamp in Discord embeds show-timestamp: true ```

## 📝 Commands **/holaalerts** or **/ha**: Displays the plugin information. **/holaalerts reload** or **/ha reload**: Reloads the configuration (requires holaalerts.reload permission). ## 🔐 Permissions **holaalerts.notify**: Receive in-game alerts for detected content. **holaalerts.bypass**: Bypass chat filtering. **holaalerts.reload**: Reload the plugin configuration. ## 🌟 Why Choose HolaAlerts? HolaAlerts is ideal for server administrators seeking a lightweight yet powerful solution for chat moderation. Its seamless integration with Discord, flexible configuration, and robust permission system make it suitable for servers of all sizes, from small communities to large networks. _**Developed by [M0_kii](https://github.com/M0-ki), HolaAlerts combines functionality with a polished user experience, ensuring your server remains a welcoming and controlled environment.**_

HolaAlerts

1.4.1

1.4

1.3

1.2

1.1

1.0