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, HolaAlerts combines functionality with a polished user experience, ensuring your server remains a welcoming and controlled environment.