HolaAlerts

HolaAlerts is a Velocity plugin that filters chat, blocks swears/ads, and helps keep servers safe with real-time alerts.

335

HolaAlerts

<p align="center">HolaAlerts</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 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

/ha or /ha: Displays the plugin information.

/ha 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.

%%MD0%%

ADS