FAQ и решение проблем

Сервер в дашборде offline, хотя прокси запущен

• Проверьте licenseKey в plugins/winshield/settings.yml — он должен совпадать с secret_key карточки сервера.
• Посмотрите консоль прокси: handshake failed с причиной. invalid_key — ключ неверен или был ротирован.
• Статус становится offline, если плагин не синхронизировался дольше 3 минут.

Оранжевый алерт «key mismatch»

Ключ был привязан к одному серверу, а теперь приходит с другого IP/адреса. Это нормально при переезде на новый VPS — ротируйте ключи и вставьте новый ключ. Если вы ничего не меняли — ключ утёк: Rotate keys немедленно.

Игроков кикает со ссылкой вместо limbo

• Сервер в режиме redirect — переключите на Limbo в Connection.
• На Velocity не установлен LimboAPI — без него limbo недоступен, плагин честно пишет об этом при старте.
• BungeeCord поддерживает только redirect.

Игрок прошёл капчу, но его не пускает

Проверьте «Redirect website» в Verification → After passing: страница после успеха уводит игрока на сайт, а в игру он должен перезайти (redirect-режим) или войдёт автоматически (limbo). Также убедитесь, что у прокси корректное время — TOTP-подобные проверки чувствительны к рассинхрону часов.

Капча включена, но проверок нет

• Тумблер капчи на карточке сервера выключен (а адаптивная защита не активна).
• Игрок в кеше прошедших — он не проверяется повторно passCacheHours часов. Кеш сбрасывается рестартом прокси.

Как полностью отключить проверку на время

Тумблер «captcha» на карточке сервера → off. Плагин применит за несколько секунд. Адаптивная защита (если включена) всё равно включит капчу при атаке — её можно выключить отдельно.

Сколько игроков может проверяться одновременно

Ограничение — лимит проверок вашего тарифа в месяц (виден в Profile → Plan & usage). Технических лимитов на параллельность нет.

Не пришло письмо подтверждения / сброса пароля

Проверьте «Спам». Письма приходят с noreply@winshield.fun. Повторную отправку можно запросить через форму входа.

Куда писать, если ничего не помогло

support@winshield.fun — приложите ник, имя сервера и фрагмент консоли прокси с момента старта плагина.