Skip to content

Server Webhooks

Mod sends selected server events to your backend as HTTP POST JSON.

Forge
Loaders
Forge
Downloads on Modrinth
92
Followers on Modrinth
4
version
1
Updated
April 13, 2026Apr 13
Published
in 2026

At a glance

Runs on Forge
For Minecraft 1.20.1
Server only — players don't need to install it
Latest version — 1.1.1 from April 13, 2026
License MIT — free
Where it's needed
In gamenot neededOn serverrequired

Install on the server only; players don't need it

Game versions1.20.1

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.

FAQ

How to install Server Webhooks?

Install Forge for your Minecraft version, download Server Webhooks for the same version and loader, put the file into the mods folder and launch the game with the loader profile.

Which Minecraft versions does Server Webhooks support?

Server Webhooks has builds for Minecraft 1.20.1.

Is Server Webhooks needed on the server?

Server only — players don't need to install it

License and source
MIT Licensefree to use and share with credit to the author
Original — Modrinth↗Files unchanged, verified with SHA-512Is this your mod? For rights holders

The site uses cookies: the necessary ones for sign-in and the theme, plus the Yandex Metrica and LiveInternet visit counters — they show us how the site is used. We have no advertising cookies. More