Плагин для серверов Майнкрафт, который связывает сервер с сайтами, магазинами, Discord-ботами и другими плагинами через контролируемый HTTP API, Java API и подписанные вебхуки. Он позволяет точно ограничить действия каждой интеграции: например, выдавать привилегии за заказ или передавать события входа игрока на сайт.
Возможности
- Именованные ключи API со сроком действия, правами и доступом только к заданным действиям.
- Проверка JSON-запросов и типов данных: имён игроков, UUID, строк, чисел, логических значений, перечислений и регулярных выражений.
- Белые списки IP и CIDR, ограничения размера запроса, времени ожидания и частоты запросов.
- Асинхронные операции с идентификаторами запросов, проверкой статуса и защитой от повторной выдачи награды при повторной отправке заказа.
- Подписанные вебхуки с фильтрами событий, отдельными адресами доставки и повторными попытками.
- Живая перезагрузка действий, ключей и маршрутов событий.
- Возможность подключать Skript через дополнение с HTTP.
Команды
/webconnector reload— перезагрузить действия, ключи и маршруты событий после изменения настроек.
Настройка
После первого запуска основной файл настроек находится в plugins/WebConnector/config.yml; секрет API создаётся автоматически. В нём задают действия интеграций и ключи с ограниченным доступом.
По умолчанию API доступен только на localhost и содержит безопасное действие проверки связи. Для доступа извне нужен дополнительный открытый порт или обратный прокси; при передаче через сеть используйте HTTPS. При повторе награды или заказа передавайте тот же Idempotency-Key: для этого ключа завершённая либо прерванная операция повторно не запускается автоматически.
Есть русская документация.
Требования
Плагин работает на Paper и не требует установки у игроков. Нужна Java 17, Java 21 или Java 25 — в зависимости от используемой версии сервера. Folia и прокси-серверы не поддерживаются. Skript и HTTP-дополнения необязательны и имеют собственные требования.
