Server Webhooks

Quick rating

Community listing page, reviews here may not be monitored by the author.

How listings work Are you the author?

Server Webhooks

By pheo-devOwner

No reviews yet

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

Mod Loaders
Minecraft
Hosting Partner

Want to reach Minecraft players?

We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!

Get in touch

About

Description

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.