Server Webhooks

Minecraft 版本： 1.20.1

平台： forge

标签： utility

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.