AntiAFK - The Performance AFK Solution

AntiAFK 1.0.2-b9 - Discord Integration Update!

This update introduces a highly requested feature: Discord Webhook Integration. You can now receive instant notifications in your Discord server for important actions taken by the plugin, such as kicking or banning a player for AFK-related offenses.

This feature is designed to be lightweight, flexible, and does not require DiscordSRV to be installed.

✨ New Feature: Discord Webhook Notifications

Stay informed about server punishments in real-time, directly in your Discord channels.

(Example of a notification in Discord)

How It Works

I've added a new, special action type: DISCORD_WEBHOOK. You can add this action to any punishment list in your config.yml (actions, progressive_punishment, or turing_test.on_failure_actions). When a player triggers that punishment, the plugin will send a custom message to your configured Discord webhook URL.

Key Features:

• Easy Setup: Simply enable the feature and paste your webhook URL into the config.yml.
• Fully Customizable: You can define different messages for different punishments. All standard placeholders like %player_displayname% are supported.
• No Dependencies: This system works by sending a direct HTTP request to Discord, so you do not need to have DiscordSRV installed on your server.
• Asynchronous: All webhook messages are sent asynchronously, ensuring zero impact on your server's performance.

⚙️ How to Configure

1. Create a Webhook in Discord: Go to your Discord channel's settings -> Integrations -> Webhooks -> New Webhook. Copy the "Webhook URL".

2. Enable in config.yml: Open your config.yml and find the new discord_webhook section. Enable it and paste your URL:

   # config.yml
   
   discord_webhook:
     enabled: true
     webhook_url: "PASTE_YOUR_WEBHOOK_URL_HERE"
     bot_name: "AntiAFK Guard"
     avatar_url: "" # Optional: URL to an image for the bot's avatar
   

3. Add the Action to a Punishment: Add the DISCORD_WEBHOOK action type to any action list. For example, to send a notification when a player fails a captcha test:

   # config.yml
   
   turing_test:
     on_failure_actions:
       # This action kicks the player
       - type: "CONSOLE"
         command: "kick %player% &cBot test failed!"
       
       # AND this action sends a Discord notification
       - type: "DISCORD_WEBHOOK"
         message: ":shield: **%player_displayname%** was kicked for failing the bot captcha test."
   

That's it! You will now receive detailed notifications whenever the plugin takes action.