Dokumentacja
Wszystko, co trzeba wiedzieć, żeby podłączyć serwer lub sieć Minecraft do Kordona.
Jak działa Kordon
Gracze łączą się z adresem Kordona, np. mojserwer.kordon.gg. Węzeł Kordona sprawdza każde połączenie – odrzuca boty, złe pakiety i zalewy połączeń – a prawidłowych graczy przekazuje na Twój serwer. Twój serwer dostaje prawdziwe IP gracza, więc bany na IP i pluginy działają jak dotąd.
Są dwa rodzaje usług:
- Pojedynczy serwer – Kordon przekazuje ruch do jednego serwera bez zaglądania w grę. Działa z każdą wersją Minecraft Java i każdym silnikiem.
- Sieć serwerów – Kordon sam loguje graczy i rozdziela ich na kilka serwerów Paper. Zastępuje BungeeCorda lub Velocity: lobby,
/server, powrót do lobby po wyrzuceniu. Obsługuje klientów 1.20.2 – 26.3.
Pierwsza usługa
- Załóż konto i kliknij Nowa usługa.
- Wybierz rodzaj i adres dla graczy (subdomenę).
- W zakładce Połączenie (albo Serwery sieci) wpisz adres swojego serwera i skonfiguruj go według instrukcji poniżej.
- Połącz się z grą przez nowy adres. Jeśli wejdziesz – podaj go graczom.
Pojedynczy serwer: PROXY protocol
To zalecany sposób. Paper obsługuje PROXY protocol bez wtyczek. W config/paper-global.yml:
proxies:
proxy-protocol: true
Na Spigot lub starszych wersjach użyj wtyczki obsługującej PROXY protocol albo trybu z wtyczką Kordon. Na serwerach z BungeeCordem lub Velocity włącz PROXY protocol w ich konfiguracji (proxy_protocol: true w BungeeCordzie, haproxy-protocol = true w Velocity).
Uwaga: po włączeniu serwer odrzuca połączenia bez nagłówka PROXY, więc wejście bezpośrednio na IP przestanie działać – i o to chodzi.
Pojedynczy serwer: wtyczka Kordon
Gdy nie możesz zamknąć portu zaporą (np. na hostingu współdzielonym), wybierz tryb Wtyczka Kordon. Węzeł podpisuje każde połączenie sekretem, a wtyczka sprawdza podpis i przywraca IP gracza.
- Pobierz Kordon-Paper-1.0.0.jar (Paper 1.20.6 – 26.x, Java 21+) i wrzuć do
plugins/. - Uruchom serwer. W
plugins/Kordon/config.ymlwpisz sekret z panelu. - Wpisz
/kordon przeladuj. Od tej chwili wejście bezpośrednio na IP kończy się komunikatem.
sekret: "skopiuj-z-panelu"
wymagaj-kordona: true
okno-czasu-s: 30
obejscie: []
Podpis jest ważny 30 sekund i jednorazowy, dlatego zegar serwera musi być zsynchronizowany (NTP).
Zamknięcie portu dla wszystkich poza Kordonem
Najlepszą ochronę daje zapora, która wpuszcza na port serwera tylko węzły Kordona. Przykład dla ufw (adresy węzłów znajdziesz w panelu):
ufw deny 25565/tcp
ufw allow from ADRES_WĘZŁA to any port 25565 proto tcp
Konfiguracja sieci
W zakładce Serwery sieci dodaj wszystkie serwery (np. lobby, survival, skyblock) z ich adresami. Zaznacz, który jest lobby – tam trafi gracz po wyrzuceniu z innego serwera.
Na każdym serwerze sieci ustaw przekazywanie Velocity z sekretem z panelu. W config/paper-global.yml:
proxies:
velocity:
enabled: true
online-mode: true # false, jeśli sieć wpuszcza non-premium
secret: "sekret-z-panelu"
W server.properties ustaw online-mode=false – logowanie premium wykonuje Kordon. Serwery bez włączonego przekazywania Velocity zostaną odrzucone (gracz zobaczy komunikat o błędnej konfiguracji), bo inaczej każdy mógłby podszyć się pod dowolny nick.
Serwery w sieci mogą mieć różne wersje – zainstaluj na nich ViaVersion, a gracze z nowszych klientów też wejdą.
Komendy graczy
/server– lista serwerów sieci z liczbą graczy./server <nazwa>– przejście na inny serwer./lobby,/hub– powrót do lobby.
Nazwy komend zmienisz w panelu. Komendy obsługuje Kordon, więc serwery ich nie widzą.
Pluginy i kanał BungeeCord
Kordon rozumie kanał wtyczek BungeeCord, więc selektory serwerów, kompasy w lobby i pluginy portali działają bez zmian. Obsługiwane polecenia: Connect, ConnectOther, IP, IPOther, PlayerCount, PlayerList, GetServers, GetServer, GetPlayerServer, UUID, UUIDOther, Message, KickPlayer.
Serwery non-premium
Wyłącz w panelu opcję Tylko konta premium. Kordon wpuści wtedy każdego gracza z UUID trybu offline, takim samym jak na zwykłym serwerze non-premium, a logowanie hasłem zrób pluginem (np. AuthMe) na serwerze lobby. Ustaw też online-mode: false w sekcji velocity i enforce-secure-profile=false w server.properties.
Dwóch graczy o tym samym nicku nie może grać naraz – drugi zobaczy komunikat, że nick jest zajęty.
Własna domena
W zakładce Domeny dodaj domenę, np. graj.mojserwer.pl. U swojego dostawcy DNS ustaw dwa rekordy, które pokaże panel:
- CNAME z Twojej domeny na adres węzłów Kordona,
- TXT
_kordon.graj.mojserwer.plz kodem weryfikacji.
Kliknij Sprawdź. Po weryfikacji domena zacznie działać w ciągu kilku sekund. Dla domeny głównej, która nie może mieć CNAME, ustaw rekord SRV _minecraft._tcp.
Ochrona i tryb ataku
Kordon zawsze ogranicza liczbę połączeń z jednego IP, odrzuca uszkodzone pakiety i niepoprawne nicki oraz odpowiada na pingi listy serwerów z pamięci, bez pytania Twojego serwera częściej niż co kilka sekund.
Gdy liczba wejść na sekundę przekroczy próg ataku, usługa przechodzi w tryb ataku na minutę od ostatniego przekroczenia. W tym czasie:
- gracze, którzy grali już na Twoim serwerze co najmniej 30 sekund, wchodzą normalnie,
- nowi gracze dostają prośbę o ponowne połączenie po 3 sekundach – prawdziwy gracz klika „Połącz ponownie”, bot zwykle odpada.
Możesz też blokować adresy IP, zakresy CIDR, wzorce nicków i wersje gry.
Rozwiązywanie problemów
„Nie udało się połączyć z serwerem”
Sprawdź, czy adres i port w panelu są poprawne i czy serwer działa. Adresy prywatne (192.168.x.x, 10.x.x.x, localhost) są niedozwolone – podaj publiczny adres.
„Błędna konfiguracja serwera” w sieci
Serwer ma online-mode=true albo wyłączone przekazywanie Velocity, albo inny sekret niż w panelu.
Gracze mają IP węzła zamiast swojego
Włącz PROXY protocol w Paperze albo wybierz tryb z wtyczką. W trybie „Bez przekazywania” serwer zawsze widzi adres węzła.
„Podpis wygasł”
Zegar serwera różni się od prawdziwego czasu o ponad 30 sekund. Włącz synchronizację czasu (NTP).