Плагин WinShield
Тонкий клиент для Velocity и BungeeCord: вся конфигурация — в дашборде, в файле только ключ и интервалы.
settings.yml
| Ключ | По умолчанию | Описание |
|---|---|---|
licenseKey | — | Секретный ключ сервера из дашборда. Без него защита не работает. |
mod | auto | auto — режим из дашборда; redirect / limbo — принудительно. |
backend | auto | Куда отправлять игрока после прохождения в режиме limbo. |
connectTimeoutSeconds | 5 | Таймаут запросов к WinShield (1–60). |
syncIntervalSeconds | 5 | Как часто синхронизировать настройки из дашборда (1–30). Проверка ключа идёт каждую секунду независимо. |
Режимы работы
Redirect
Игрок получает кик с персональной ссылкой. Прошёл проверку в браузере — перезашёл и попал на сервер. Работает на Velocity и BungeeCord, ничего дополнительно не требует.
Limbo (только Velocity + LimboAPI)
Игрок попадает в виртуальный мир ожидания: кликабельная ссылка в чате (с напоминаниями), боссбары «готовим ссылку» и обратный отсчёт, таймер в полосе опыта. Прошёл — автоматически продолжает вход. Мир полностью настраивается в дашборде: измерение, точка спавна, платформа из блоков, время суток.
Стадия проверки (trigger stage)
| Режим | Когда срабатывает |
|---|---|
PRE_PROXY | Раньше всех плагинов — до auth-плагинов и LimboFilter. |
BEFORE_AUTH | Перед плагинами авторизации (рекомендуется, по умолчанию). |
POST_LOGIN | После полного входа на прокси. |
Выбирается в дашборде: Verification → Trigger stage. Применимо к режиму limbo на Velocity.
Команды
| Команда | Права | Действие |
|---|---|---|
/captcha status | winshield.admin | Состояние подключения, сервер, режим, возраст последней синхронизации. |
/captcha reload | winshield.admin | Перечитать settings.yml и переподключиться. |
Что плагин пишет в консоль
- Изменения настроек — каждое применённое изменение:
WinShield setting changed — limbo.worldTime: 6000 -> 18000. - Оранжевый WARN — key mismatch: ключ привязан к другому серверу (повторяется раз в минуту, пока активен).
- Красный ERROR — ключ не существует или отозван ротацией.
- Адаптивная защита — начало и конец атаки с причиной срабатывания.
Плагин «fail-closed»: при недоступности WinShield защита отключается и игроки проходят свободно. Сервер не пострадает, даже если капча-сервис целиком ляжет.
WinShield — защита Minecraft-серверов от ботов. Вопросы: support@winshield.fun