Server Webhooks

Minecraft Forge mod for Minecraft 1.20.1: sends selected server events to your backend as HTTP POST JSON, with optional HMAC-SHA256 (X-Webhook-Signature), retries on 5xx / network failures, and bounded concurrency.

Installation

Place the built JAR in the dedicated server’s mods folder. The mod is intended for the server.

Configuration

On first run, Forge creates:

config/serverwebhooks-server.toml

Key options (see comments in the file):

• webhookUrl — http or https only
• secret — shared secret for HMAC (empty = no signature header)
• timeoutMillis, maxConcurrentRequests, retryExtraAttempts, retryInitialBackoffMillis
• serverId — included in JSON payloads
• events.* — toggles per event type (playerJoin, playerLeave, playerDeath, chatMessage, serverStarted, serverStopping)

Reload from disk without restart (operator, permission level 2):

/serverwebhooks reload

Payload

JSON includes event_id, event_type, occurred_at, server_id, optional player (uuid, name), and optional details depending on the event.