?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings

Server Webhooks

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

6
0
6
0

Compatibility

Minecraft: Java Edition

1.20.1

Platforms

Supported environments

Dedicated servers only

Tags

Creators

Details

Licensed MIT
Published 6 days ago

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.