# Анти-VPN плагин для Velocity: установка и настройка Kordon

Защиту от VPN удобнее всего ставить на прокси: через него проходит каждый игрок, а серверы Paper за ним трогать не нужно. Ниже установка Kordon на Velocity от скачивания файла до прав для модераторов.

Обновлено: 2026-10-27

## Коротко

- Kordon работает на Velocity 3.4 и новее, включая ветку 4.x. Нужна Java 21 или новее.
- Плагин ставится только на прокси, на серверы за ним ничего ставить не нужно.
- Файла настроек нет: всё настраивается в панели, а на прокси хранится только ключ сервера.
- Без плагина прав Velocity не даёт игрокам никаких прав, поэтому доступ к командам `/kordon` настраивают через LuckPerms.
- Если прокси несколько, плагин ставится на каждый. Сколько из них Kordon проверяет, зависит от тарифа.

## Что нужно

Velocity 3.4 или новее, ветка 4.x тоже подходит. Java 21 или новее. Сам Velocity 4 требует Java 25, так что если прокси запускается, Kordon тоже запустится.

Если после установки в консоли появилась ошибка `UnsupportedClassVersionError`, прокси работает на старой Java и её нужно обновить.

Игроков Bedrock, которые заходят через Geyser и Floodgate, Kordon распознаёт сам. Отдельно настраивать для них ничего не нужно.

## Установка

1. [Создайте аккаунт](https://panel.kordonlabs.com/register) и добавьте сервер в панели.
2. Откройте страницу сервера **Плагин** и скачайте `Kordon.jar`. В этот файл уже вписан ключ вашего сервера.
3. Положите файл в папку `plugins` рядом с `velocity.toml`.
4. Полностью перезапустите Velocity и посмотрите в консоль.

Когда плагин подключился, в консоли появится строка с названием сервера, режимом и тем, что делать при недоступности Kordon. Новый сервер начинает в режиме наблюдения:

```
Kordon connected to server "My Server". Mode: monitoring only. If Kordon is unavailable: let nobody in.
```

Примерно через минуту панель покажет «Плагин на связи».

Если вы скачали общий `Kordon.jar` со SpigotMC или Hangar, ключа в нём нет. Привяжите его командой в консоли прокси. Ключ лежит на той же странице **Плагин**, перезапуск не нужен:

```
/kordon link <ключ>
```

> Не держите в папке `plugins` два файла Kordon, например старую и новую версию. Они конфликтуют, и консоль предупредит об этом при запуске.

## Права и команды

Velocity не выдаёт игрокам никаких прав, пока не установлен плагин прав. Обычно это LuckPerms. Чтобы модератор мог пользоваться командами Kordon, выдайте ему `kordon.command` и права на нужные команды:

```
/lpv user Steve permission set kordon.command true
/lpv user Steve permission set kordon.command.whitelist true
/lpv user Steve permission set kordon.command.lookup true
/lpv user Steve permission set kordon.notify true
```

Что умеют команды:

- `/kordon status` показывает связь с Kordon, режим защиты и онлайн;
- `/kordon lookup <ник>` показывает, что Kordon знает об игроке; чтобы видеть и искать IP, нужно ещё право `kordon.command.lookup.ip`;
- `/kordon whitelist add` и `/kordon blacklist add` добавляют ник, IP или диапазон в списки, можно со сроком `1d`, `7d`, `30d` или `never`;
- право `kordon.notify` включает сообщения Kordon для персонала в чате.

Право на `/kordon link` в `kordon.command` не входит, его стоит оставить владельцу. В консоли прокси доступны все команды. На Velocity подсказка `/kordon` в чате видна всем игрокам, но без прав команда не выполнится. Если команды в игре не нужны совсем, выключите их в панели: «Плагин», затем «Команды в игре». Этот переключатель выключает списки и поиск игроков и в консоли тоже.

## Несколько прокси

Большие сети держат несколько Velocity за балансировщиком. Плагин ставится на каждый прокси тем же файлом с тем же ключом. Все прокси сами появляются в панели в разделе «Плагин», на вкладке «Прокси». Прокси, от которого семь дней нет сигнала, пропадает из списка.

Сколько прокси Kordon проверяет, зависит от [тарифа](https://kordonlabs.com/ru#pricing): на бесплатном один, на старших тарифах больше. Прокси сверх лимита помечен в панели, и Kordon его не обслуживает: игроков через него плагин пускает или не пускает по настройке «Если проверка недоступна», а по умолчанию не пускает. Какие прокси учитывать, вы выбираете сами.

## Если Kordon недоступен

Плагин ждёт ответа Kordon до трёх секунд. Что делать, если ответа нет, решает настройка «Если проверка недоступна». По умолчанию игрок, которого не удалось проверить, не заходит. Можно переключить на «Пускать всех». Игроков, которые уже в игре, это не касается. Одно исключение: сразу после запуска прокси, пока Kordon ещё ни разу не ответил, плагин пускает всех.

## Частые сообщения в консоли

- `Kordon is not linked to a server`: ключа нет, игроки заходят без проверки. Привяжите плагин командой `/kordon link <ключ>` или скачайте файл со своей страницы **Плагин**.
- `The Kordon panel does not accept this server's key`: ключ перевыпустили или сервер удалили. Возьмите новый ключ в панели.
- `Kordon did not answer`: Kordon не ответил за три секунды. С игроком поступили по настройке «Если проверка недоступна».
- `Kordon.jar was replaced while the proxy was running`: файл заменили на работающем прокси, перезапустите его.
- `A new Kordon version ... is available`: вышла новая версия, скачайте её в панели.

Дальше выберите уровень защиты и посмотрите, кого Kordon не пустил бы в режиме наблюдения. Об этом в статье [как заблокировать VPN и прокси](https://kordonlabs.com/ru/guides/block-vpn-minecraft-server).

## Попробуйте на своём сервере

Начните в режиме наблюдения: Kordon покажет, кого бы не пустил, а защиту вы включите, когда будете готовы. [Создать аккаунт](https://panel.kordonlabs.com/register)

## Другие статьи

- [Как заблокировать VPN и прокси на Minecraft-сервере](https://kordonlabs.com/ru/guides/block-vpn-minecraft-server): Зачем игроки заходят через VPN и прокси, какие есть способы их блокировать и как по шагам подключить анти-VPN плагин Kordon на BungeeCord или Velocity.
- [Анти-VPN для BungeeCord и Waterfall: установка Kordon](https://kordonlabs.com/ru/guides/bungeecord-antivpn-plugin): Как поставить анти-VPN плагин Kordon на BungeeCord, Waterfall и их форки: требования, права в config.yml или LuckPerms, команды и переезд на Velocity.
- [Как ограничить версии Minecraft на сервере](https://kordonlabs.com/ru/guides/minecraft-client-version-filter): Как пустить на Minecraft-сервер только нужные версии клиента: зачем это при ViaVersion, как задать диапазоны в Kordon и что будет с игроками Bedrock.
