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:

Pierwsza usługa

  1. Załóż konto i kliknij Nowa usługa.
  2. Wybierz rodzaj i adres dla graczy (subdomenę).
  3. W zakładce Połączenie (albo Serwery sieci) wpisz adres swojego serwera i skonfiguruj go według instrukcji poniżej.
  4. 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.

  1. Pobierz Kordon-Paper-1.0.0.jar (Paper 1.20.6 – 26.x, Java 21+) i wrzuć do plugins/.
  2. Uruchom serwer. W plugins/Kordon/config.yml wpisz sekret z panelu.
  3. 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

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:

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:

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).