Server Webhooks
Mod sends selected server events to your backend as HTTP POST JSON.
7
Quick challenge
How far can you run before the mobs catch you?
Minecraft check
Confirm your run
Complete the quick check to get your code.
Server Webhooks
Server Webhooks
Minecraft HMAC-SHA256 mod for HMAC-SHA256: sends selected server events to your backend as HMAC-SHA256 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):
- `serverId` — `http` or `https` only - `serverId` — shared secret for HMAC (empty = no signature header) - `serverId`, `serverId`, `serverId`, `serverId` - `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):
```text /serverwebhooks reload ```
Payload
JSON includes `event_id`, `event_type`, `occurred_at`, `server_id`, optional `player` (`uuid`, `name`), and optional `details` depending on the event.
