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.

常见问题

Server Webhooks 支持哪些 Minecraft 版本？

Server Webhooks 支持 Minecraft Java 版 1.20.1，可用的加载器：Forge。下载时注意选择和你游戏版本一致的文件。

Server Webhooks 怎么安装？

先用 PCL2 或 HMCL 启动器安装对应版本的 Forge，再把下载的 .jar 文件放进游戏目录的 mods 文件夹，重新启动游戏即可。开启了版本隔离的，mods 文件夹在 versions/版本名下面。运行环境：仅服务端。

介绍