Анти-VPN плагін для Velocity: встановлення й налаштування Kordon

Що потрібно

Velocity 3.4 або новіший, гілка 4.x теж підходить. Java 21 або новіша. Сам Velocity 4 вимагає Java 25, тож якщо проксі запускається, Kordon теж запуститься.

Якщо після встановлення в консолі з’явилася помилка UnsupportedClassVersionError, проксі працює на старій Java, і її треба оновити.

Гравців Bedrock, які заходять через Geyser і Floodgate, Kordon розпізнає сам. Окремо налаштовувати для них нічого не потрібно.

Встановлення

1. Створіть акаунт і додайте сервер у панелі.
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 <ключ>

Права й команди

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, залежить від тарифу: на безкоштовному один, на старших тарифах більше. Проксі понад ліміт позначено в панелі, і 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 і проксі.