Serwery Minecraft (Paper, Velocity i Bungee)

Blokuj połączenia przez VPN i proxy, zanim gracze dołączą do Twojego świata gry.

Podgląd

Ekran wyrzucenia z gry (Kick)	Alert ostrzegawczy w konsoli

Dlaczego ProxyTracer?

• Wykrywanie w czasie rzeczywistym: Precyzyjne sprawdzanie w stale aktualizowanej bazie domowych (residential) i publicznych sieci VPN ProxyTracer.
• Natywne wsparcie dla wielu platform: Dedykowane integracje dla pojedynczych serwerów (Paper/Spigot) oraz sieci wieloserwerowych (Velocity lub BungeeCord/Waterfall).
• Wysoka wydajność: Wbudowana pamięć podręczna w RAM pozwala oszczędzać kredyty API i gwarantuje, że powracający gracze łączą się natychmiast.
• Inteligentna biała lista: Polecenia omijania weryfikacji dla zaufanych nicków graczy oraz adresów IP sieci.
• Powiadomienia na Discordzie: Logowanie zablokowanych prób wejścia przez VPN bezpośrednio na kanałach administracji.
• Profesjonalny ekran wyrzucenia: Wyświetla graczom elegancki komunikat o blokadzie powołujący się na proxytracer.com.

Który plik .jar należy zainstalować?

Szybka konfiguracja (60 sekund)

1. Odbierz darmowy klucz API na stronie: ProxyTracer.com/dashboard
2. Pobierz odpowiedni plik .jar dla swojej konfiguracji z sekcji Releases.
3. Umieść plik .jar w katalogu plugins/ swojego serwera i uruchom go jeden raz.
4. Ustaw swój klucz API bezpośrednio w grze lub w konsoli serwera:

   /proxytracer set your_api_key_here

   (Spowoduje to automatyczne zapisanie klucza w pliku konfiguracyjnym i przeładowanie wtyczki).
5. Zweryfikuj połączenie, wpisując polecenie: /proxytracer status

Przegląd konfiguracji

mode: "block"          # Akcja po wykryciu proxy: block | warn | log
 
api:
  base-url: "https://api.proxytracer.com/v1"
  key: "proxy_your_key_here"
  on-error: "allow"    # Polityka fail-open, jeśli API jest niedostępne: allow | block | warn
  timeout-ms: 2000
 
notifications:
  in-game: false       # Wysyłaj kolorowe wiadomości na czacie w grze do administracji (proxytracer.notify)
 
cache:
  enabled: true
  ttl-minutes: 1440    # Przechowuj wynik weryfikacji IP w pamięci podręcznej przez 24 godziny
  max-entries: 10000
 
discord:
  enabled: false
  webhook-url: ""
  notify-blocked: true

Polecenia i uprawnienia

Wszystkie polecenia zaczynają się od prefiksu /proxytracer:

• /proxytracer notify <on|off|toggle> — Włącz, wyłącz lub przełącz kolorowe powiadomienia na czacie w grze dla administracji.
• /proxytracer notify add|remove|list [player] — Dodaj, usuń lub wyświetl listę nicków administracji uprawnionych do otrzymywania powiadomień w grze (automatycznie zapisywane w config.yml).
• /proxytracer set <api_key> — Ustawia klucz API bezpośrednio, zapisując go w pliku config.yml i przeładowując wtyczkę.
• /proxytracer status — Sprawdza status konfiguracji, poświadczenia API oraz stan powiadomień w grze.
• /proxytracer check <ip> — Ręcznie odpytuje i weryfikuje podany adres IP.
• /proxytracer cache clear — Czyści lokalną pamięć podręczną adresów IP.
• /proxytracer reload — Przeładowuje plik konfiguracyjny.
• /proxytracer whitelist name add|remove|list [player] — Zwalnia wskazanych graczy z procedury sprawdzania.
• /proxytracer whitelist ip add|remove|list [ip] — Zwalnia wskazane adresy IP sieci z procedury sprawdzania.

Uprawnienia:

• proxytracer.admin — Dostęp do poleceń przeładowania, sprawdzania statusu i funkcji administracyjnych.
• proxytracer.bypass — Gracze z tym uprawnieniem omijają procedurę weryfikacji podczas logowania.
• proxytracer.notify — Uprawnieni członkowie administracji otrzymują ostrzeżenia w grze, gdy wykryty zostanie użytkownik łączący się przez VPN.

(Uwaga: Domyślnie te uprawnienia są przypisane wyłącznie operatorom serwera (OP). Aby nadać je innym graczom lub grupom administracyjnym, użyj wtyczki do zarządzania uprawnieniami, np. LuckPerms).

Zgodność i wymagania

• Wersja Java: Java 17 lub nowsza (w pełni przetestowane na wersjach Java 17, 21 i 22). Wtyczka jest kompilowana z myślą o środowisku Java 17.
• Wspierane oprogramowanie serwera: Paper / Spigot / Purpur (od 1.13 do 1.21.x), Velocity (3.x) oraz BungeeCord / Waterfall (nowoczesne wydania).
• Dostęp do API: Darmowy lub płatny klucz API zarejestrowany na stronie proxytracer.com.

Rozwiązywanie problemów: Prawdziwy adres IP (127.0.0.1)

Jeśli w Twoich logach każdy dołączający gracz łączy się z adresu 127.0.0.1, API ProxyTracer nie może dokonać prawidłowej weryfikacji. Oznacza to, że układ sieci hostingowej lub front-end proxy maskuje przychodzące adresy IP graczy.

Jak naprawić:

1. Dla sieci proxy (Velocity / Bungee): Zainstaluj ProxyTracer wyłącznie na bramie proxy (Velocity/Bungee). Upewnij się, że przekazywanie informacji o graczu jest włączone (player-info-forwarding-mode = "modern" w velocity.toml lub ip_forward: true w config.yml Bungee), aby węzły serwerów gier otrzymywały prawdziwe adresy IP.
2. W przypadku hostingu współdzielonego (np. panele proxy TickHosting): Jeśli Twój hosting przekazuje nagłówki połączenia przez Proxy Protocol, włącz tę opcję w konfiguracji Paper (proxies.proxy-protocol: true w config/paper-global.yml) i zrestartuj serwer. Ostrzeżenie: Nie włączaj tej opcji, chyba że Twój hosting wyraźnie to obsługuje; błędna konfiguracja zablokuje dołączanie wszystkim graczom.

Cennik i limity API

Wtyczki ProxyTracer dla Minecrafta są w 100% darmowe. Wykrywanie zagrożeń wymaga połączenia z API ProxyTracer:

- Plan bezpłatny: 100 zapytań / miesiąc dla małych serwerów SMP i środowisk testowych.
- Starter (3 € / mies.): Doskonały dla rozwijających się serwerów publicznych.
- Pro (9 € / mies.) / Scale (39 € / mies.): Przeznaczone dla dużych sieci serwerów.

Wygeneruj klucz i wybierz plan: ProxyTracer