Server Webhooks

Server Webhooks

Мод Forge для Minecraft 1.20.1: отправляет выбранные события сервера на ваш бэкенд в виде 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 в зависимости от события.