服务器 Webhook

服务器 Webhook

模组将选定的服务器事件以HTTP POST JSON形式发送到你的后端。

工具

Server Webhooks

适用于 Minecraft 1.20.1 的 Minecraft Forge 模组:将选定的服务器事件以 HTTP POST JSON 形式发送到你的后端,支持可选的 HMAC-SHA256(X-Webhook-Signature)、在 5xx / 网络故障时重试,以及有界并发。

安装

将构建好的 JAR 放入专用服务器的 mods 文件夹。该模组面向服务器端使用。

配置

首次运行时,Forge 会创建:

config/serverwebhooks-server.toml

主要选项(见文件中的注释):

  • webhookUrl — 仅支持 http 或 https
  • secret — 用于 HMAC 的共享密钥(为空 = 不发送签名头)
  • timeoutMillis、maxConcurrentRequests、retryExtraAttempts、retryInitialBackoffMillis
  • serverId — 包含在 JSON 负载中
  • events.* — 按事件类型分别开关(playerJoin、playerLeave、playerDeath、chatMessage、serverStarted、serverStopping)

无需重启即可从磁盘重新加载(操作员,权限等级 2):

/serverwebhooks reload

负载

JSON 包含 event_id、event_type、occurred_at、server_id,以及可选的 player(uuid、name),并根据事件类型包含可选的 details。