ServerWebhook

ServerWebhook Plugin

A simple plugin for Velocity proxies that sends a notification to a configured webhook when a player connects to a specific server.

Features

• Per-Server Settings: Configure webhooks for specific servers or for all servers ("all").
• HTTP Method Support: Supports GET and POST requests.
• Dynamic Data Transfer: Use placeholders like {player.name}, {player.uuid}, and {server.name} in the webhook's URL, body, and headers to send dynamic information.

Configuration Structure

{
  "webhooks": [
    {
      "server": "ServerName",
      "url": "WebhookURL",
      "method": "HTTPMethod",
      "body": "RequestBody (optional)",
      "headers": {
        "HeaderName": "HeaderValue"
      }
    }
  ]
}

• server: Specify the name of the server to send the webhook for. Set to "all" to receive notifications from all servers.
• url: The URL address to send the webhook request to.
• method: Supports GET or POST.
• body: The body to send with a POST request. (optional)
• headers: Custom headers to include in the request. (optional)

Available Placeholders

You can use the following placeholders in the url, body, and headers values to include dynamic information:

• {player.name}: The player's name
• {player.uuid}: The player's UUID
• {server.name}: The name of the server the player connected to

Configuration Example

{
  "webhooks": [
    {
      "server": "limbo",
      "url": "http://localhost:8080/webhook",
      "method": "POST",
      "body": "{\"username\": \"{player.name}\", \"content\": \"{player.name} has connected to {server.name}.\"}",
      "headers": {
        "X-Auth-Token": "your-secret-token"
      }
    },
    {
      "server": "main",
      "url": "https://discord.com/api/webhooks/your_webhook_id/your_webhook_token",
      "method": "POST",
      "body": "{\"content\": \"Player {player.name} ({player.uuid}) connected to {server.name}\"}"
    },
    {
      "server": "all",
      "url": "http://localhost:8080/player_join?player={player.name}&server={server.name}",
      "method": "GET"
    }
  ]
}