# Plugin AntiVPN i antybot dla Velocity: konfiguracja Kordon

Serwer proxy to najprostsze miejsce na ochronę przed VPN: przechodzi przez niego każdy gracz, a serwery Paper za nim nie wymagają żadnych zmian. Poniżej cała konfiguracja Kordon na Velocity, od pobrania pliku po nadanie uprawnień moderatorom.

Zaktualizowano: 2026-10-27

## W skrócie

- Kordon działa na Velocity 3.4 i nowszym, także na gałęzi 4.x. Wymaga Javy 21 lub nowszej.
- Plugin instalujesz tylko na proxy. Na serwerach za nim nie instalujesz niczego.
- Nie ma pliku konfiguracyjnego: wszystko ustawiasz w panelu, a proxy przechowuje tylko klucz serwera.
- Bez pluginu do uprawnień Velocity nie daje graczom żadnych uprawnień, więc dostęp do komend `/kordon` nadajesz przez LuckPerms.
- Przy kilku serwerach proxy zainstaluj plugin na każdym z nich. Ile z nich sprawdza Kordon, zależy od twojego planu.

## Czego potrzebujesz

[Plugin Kordon AntiVPN do Minecrafta](https://kordonlabs.com/pl) działa z każdą wersją klienta, którą przyjmuje proxy, od 1.8 do najnowszego wydania. Oprócz sprawdzania VPN chroni proxy przed falami botów dzięki trybowi ataku, który jest dostępny w każdym planie.

Velocity 3.4 lub nowsze; gałąź 4.x też działa. Java 21 lub nowsza. Samo Velocity 4 wymaga Javy 25, więc jeśli twoje proxy się uruchamia, Kordon też się uruchomi.

Jeśli po instalacji konsola pokazuje `UnsupportedClassVersionError`, proxy działa na starej wersji Javy i musisz ją zaktualizować.

Kordon sam rozpoznaje graczy Bedrock, którzy wchodzą przez Geyser i Floodgate. Nie musisz niczego dla nich ustawiać.

## Instalacja

1. [Załóż konto](https://panel.kordonlabs.com/register) i dodaj swój serwer w panelu.
2. Otwórz stronę **Plugin** swojego serwera i pobierz `Kordon.jar`. Klucz twojego serwera jest już zapisany w tym pliku.
3. Wrzuć plik do folderu `plugins` obok `velocity.toml`.
4. Zrób pełny restart Velocity i zajrzyj do konsoli.

Gdy plugin się połączy, konsola wypisze linię z nazwą serwera, trybem i tym, co się dzieje, gdy Kordon jest niedostępny. Nowy serwer startuje w trybie obserwacji:

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

Po około minucie panel pokaże „Plugin jest online”.

Jeśli masz uniwersalny `Kordon.jar` pobrany ze SpigotMC lub Hangar, w środku nie ma klucza. Połącz go z serwerem komendą w konsoli proxy. Klucz jest na tej samej stronie **Plugin**, a restart nie jest potrzebny:

```
/kordon link <key>
```

> Nie trzymaj dwóch plików Kordon w folderze `plugins`, na przykład starej i nowej wersji. Wchodzą ze sobą w konflikt, a konsola ostrzega o tym przy starcie.

## Uprawnienia i komendy

Velocity nie daje graczom żadnych uprawnień, dopóki nie zainstalujesz pluginu do uprawnień, zwykle LuckPerms. Żeby moderator mógł używać komend Kordon, nadaj mu `kordon.command` oraz uprawnienia do potrzebnych komend:

```
/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
```

Co robią komendy:

- `/kordon status` pokazuje połączenie z Kordon, tryb ochrony i liczbę graczy online;
- `/kordon lookup <nickname>` pokazuje, co Kordon wie o graczu; żeby widzieć i wyszukiwać adresy IP, moderator potrzebuje też `kordon.command.lookup.ip`;
- `/kordon whitelist add` i `/kordon blacklist add` dodają nick, IP lub zakres do list, opcjonalnie na `1d`, `7d`, `30d` albo `never`;
- uprawnienie `kordon.notify` włącza na czacie powiadomienia Kordon dla administracji.

`kordon.command` nie obejmuje `/kordon link`; zostaw tę komendę właścicielowi. Konsola proxy może wykonać każdą komendę. Na Velocity podpowiedź `/kordon` na czacie widzą wszyscy gracze, ale bez uprawnień komenda się nie wykona. Jeśli w ogóle nie chcesz komend w grze, wyłącz je w panelu w sekcji „Plugin”, w ustawieniu „Komendy w grze”. Ten przełącznik wyłącza też komendy list i lookup w konsoli.

## Kilka serwerów proxy

Duże sieci uruchamiają kilka instancji Velocity za load balancerem. Zainstaluj plugin na każdym proxy z tym samym plikiem i tym samym kluczem. Każde proxy samo pojawi się w panelu, na karcie „Proxy” w sekcji „Plugin”. Proxy, które przez siedem dni nie wysłało sygnału, znika z listy.

Ile serwerów proxy sprawdza Kordon, zależy od twojego [planu](https://kordonlabs.com/pl#pricing): jeden w darmowym planie, więcej w wyższych. Proxy ponad limit jest oznaczone w panelu i Kordon go nie obsługuje: plugin na nim wpuszcza graczy albo nie, zgodnie z ustawieniem „Gdy sprawdzenie jest niedostępne”, a domyślnie ich nie wpuszcza. Ty wybierasz, które proxy się liczą.

## Gdy Kordon jest niedostępny

Plugin czeka na odpowiedź Kordon do trzech sekund. O tym, co się dzieje, gdy odpowiedź nie przyjdzie, decyduje ustawienie „Gdy sprawdzenie jest niedostępne”. Domyślnie gracz, którego nie udało się sprawdzić, nie wchodzi. Możesz zmienić je na „Wpuszczaj wszystkich”. Nie dotyczy to graczy, którzy już są w grze. Jeden wyjątek: zaraz po starcie proxy, dopóki Kordon raz nie odpowie, plugin wpuszcza wszystkich.

## Częste komunikaty w konsoli

- `Kordon is not linked to a server`: nie ma klucza, a gracze wchodzą bez sprawdzenia. Połącz plugin komendą `/kordon link <key>` albo pobierz plik ze swojej strony **Plugin**.
- `The Kordon panel does not accept this server's key`: klucz został wygenerowany od nowa albo serwer usunięto. Pobierz nowy klucz w panelu.
- `Kordon did not answer`: Kordon nie odpowiedział w ciągu trzech sekund. Gracz został obsłużony zgodnie z ustawieniem „Gdy sprawdzenie jest niedostępne”.
- `Kordon.jar was replaced while the proxy was running`: plik podmieniono na działającym proxy. Zrestartuj je.
- `A new Kordon version ... is available`: wyszła nowa wersja. Pobierz ją w panelu.

Następnie wybierz poziom ochrony i sprawdź, kogo Kordon nie wpuściłby w trybie obserwacji. Opisuje to poradnik [jak zablokować VPN i proxy](https://kordonlabs.com/pl/guides/block-vpn-minecraft-server).

## Wypróbuj na swoim serwerze

Zacznij w trybie obserwacji: Kordon pokaże, kogo by nie wpuścił, a ochronę włączysz wtedy, gdy zechcesz. [Załóż konto](https://panel.kordonlabs.com/register)

## Więcej poradników

- [Jak zablokować VPN i proxy na serwerze Minecraft](https://kordonlabs.com/pl/guides/block-vpn-minecraft-server): Dlaczego gracze wchodzą przez VPN i proxy, jakie są sposoby ich blokowania i jak krok po kroku skonfigurować plugin Kordon AntiVPN na BungeeCord lub Velocity.
- [AntiVPN i antybot dla BungeeCord i Waterfall: instalacja Kordon](https://kordonlabs.com/pl/guides/bungeecord-antivpn-plugin): Instalacja pluginu antyVPN i antybot Kordon na BungeeCord, Waterfall i forkach: wymagania, uprawnienia, komendy i przejście na Velocity.
- [Jak ograniczyć wersje Minecrafta na serwerze](https://kordonlabs.com/pl/guides/minecraft-client-version-filter): Jak wpuszczać na serwer Minecraft tylko wybrane wersje klienta: po co to przy ViaVersion, jak ustawić zakresy w Kordon i co dzieje się z graczami Bedrock.
