Плагин для серверов Майнкрафт на Paper, который безопасно связывает сервер с доверенными веб-бэкендами и другими плагинами. Вместо удалённой консоли он предоставляет ограниченные действия и события с отдельными правами для каждого клиента.
Возможности
- Для каждого клиента задаются собственные учётные данные, разрешённые действия и события, лимиты запросов, одновременных операций и WebSocket-подключений.
- Бэкенд может через REST API находить и запускать только разрешённые действия.
- Поддерживаются события входа и выхода игроков с UUID, а также получение ограниченной информации о статусе игроков.
- Можно включить телепортацию игроков, отдельно указав разрешённые миры.
- WebSocket передаёт события в реальном времени с порядковыми номерами, повторной отправкой в заданных пределах, проверкой активности и защитой от перегрузки.
- Есть поддержка JWT/JWKS, исходящего relay-подключения для серверов без входящих соединений и метрик Prometheus.
- Другие плагины Paper могут регистрировать собственные типизированные действия и события.
- Повторные запросы с одним идентификатором безопасно объединяются; повтор с другими данными отклоняется.
Настройка
После обычного запуска сервера создаётся файл plugins/Bridge/config.yml. Для каждого доверенного бэкенда создайте отдельный файл токена длиной не менее 32 байт в UTF-8 и настройте клиент только на нужные ему действия и события.
По умолчанию HTTP доступен только с самого сервера, а WebSocket, JWT, relay, метрики и действия, меняющие мир, выключены. Для удалённого доступа используйте HTTPS-прокси, VPN или защищённую служебную сеть. Не применяйте горячую перезагрузку плагинов: загружайте Bridge обычным запуском сервера.
Требования
Нужны Paper и Java 25. Совместимость с Folia, Bukkit, Spigot и другими реализациями сервера не заявлена.
