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

- Dynamic Data Transfer: Configure webhooks for specific servers or for all servers ("all"). - Dynamic Data Transfer: 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

```json { "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

```json { "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" } ] } ```