Dokumentacja

Jak podłączyć serwer Minecraft Java do Yolo Proxy. Adres proxy: …

Szybki start

1. Załóż konto w panelu klienta.
2. Kliknij „Dodaj domenę”. Wpisz domenę, pod którą gracze mają wchodzić (np. gra.twojserwer.pl), oraz adres i port Twojego serwera.
3. Ustaw rekord DNS (poniżej).
4. Wejdź w Minecraft pod nową domeną i sprawdź, czy się łączysz.

Weryfikacja domeny (rekord TXT)

Po dodaniu domeny w panelu (przycisk „Dodaj domenę”) musisz potwierdzić, że do niej należysz. Dodaj u rejestratora rekord TXT o nazwie _yoloproxy.TWOJA_DOMENA i wartości pokazanej w oknie, a potem kliknij „Zweryfikuj”. Rekord TXT służy tylko do weryfikacji – żeby gracze mogli wchodzić, dodaj też rekord A (następna sekcja). Propagacja DNS może potrwać kilka minut.

Ustawienie DNS

U rejestratora Twojej domeny dodaj rekord:

Typ:  A
Nazwa: gra            (czyli gra.twojserwer.pl)
Wartość: IP_PROXY

Zamiast rekordu A możesz użyć CNAME na …, jeśli Twoja domena to subdomena. Po zmianie w panelu kliknij „Sprawdź DNS”. Propagacja trwa od kilku minut do kilku godzin.

PROXY protocol (prawdziwe IP graczy)

Bez niego Twój serwer widzi wszystkich graczy pod adresem proxy, co psuje bany po IP. Włącz opcję „Przekazuj IP graczy” w panelu i jednocześnie w serwerze. Jeśli włączysz tylko jedną stronę, gracze nie wejdą.

Paper (1.19+)

W pliku config/paper-global.yml:

proxies:
  proxy-protocol: true

Velocity

W velocity.toml:

haproxy-protocol = true

BungeeCord

W config.yml, w sekcji listeners:

proxy_protocol: true

Dodatkowo: zapora (nieobowiązkowe)

Proxy działa bez żadnych zmian w zaporze – także na hostingu, gdzie nie masz do niej dostępu. Jeśli sam administrujesz serwerem i chcesz, żeby nikt nie wchodził z pominięciem proxy, możesz przepuścić tylko adres proxy (sudo ufw allow from IP_PROXY to any port 25565 proto tcp). Na hostingu zamiast tego użyj opcji „Wpuszczaj tylko przez proxy” z pluginu.

Inny port proxy (rekord SRV)

Jeśli proxy działa na innym porcie niż 25565, dodaj w DNS rekord SRV, żeby gracze nie musieli wpisywać portu:

Nazwa:  _minecraft._tcp.gra
Priorytet: 0   Waga: 5
Port:   25565
Cel:    proxy

Plugin na serwer (klucz)

Plugin łączy serwer z panelem: pokazuje w panelu graczy, TPS i status, ostrzega, gdy serwer przestanie odpowiadać, i może wpuszczać graczy tylko przez proxy. Działa na Spigot i Paper 1.8 – 1.21 (bez Folia).

1. W panelu wejdź w Plugin i pobierz YoloProxy.jar.
2. Wrzuć plik do folderu plugins na serwerze i uruchom serwer raz.
3. W panelu: Domeny → Zarządzaj → Plugin – skopiuj klucz domeny (zaczyna się od ypk_).
4. Wklej go w plugins/YoloProxy/config.yml w pole key i wpisz /yoloproxy reload.
5. Po chwili przy domenie pojawi się „plugin połączony”. Status sprawdzisz też komendą /yoloproxy.

Opcja „Wpuszczaj tylko przez proxy” odrzuca graczy łączących się bezpośrednio z serwerem. Opcja nie jest wymagana.

Rozwiązywanie problemów

„Can't connect to server”

• Sprawdź w panelu „Sprawdź DNS”.
• Domena w panelu musi być dokładnie taka, jaką wpisują gracze.
• Czy serwer w ogóle działa i jest dostępny z internetu? Sprawdź go testem pingu na stronie głównej.

Gracze wchodzą, ale wszyscy mają to samo IP

Włącz PROXY protocol po obu stronach (patrz wyżej).

Gracze nie mogą wejść po włączeniu PROXY protocol

Włączyłeś tylko jedną stronę. Włącz opcję w panelu i w serwerze jednocześnie albo wyłącz ją w panelu.

Zbyt wiele połączeń z jednego adresu

Proxy ogranicza liczbę równoczesnych połączeń z jednego IP i blokuje na kilka minut adresy, które łączą się zbyt często. Gracze za jedną siecią (np. LAN party) mogą to odczuć. Napisz do nas, jeśli tak jest.