FastLogin (logowanie premium)

Ostatnia aktualizacja: lipiec 2026.

FastLogin to plugin, dzięki któremu gracze z kupioną (premium) wersją Minecrafta logują się na Twój serwer automatycznie, bez wpisywania hasła. FastLogin sprawdza po stronie Mojanga, czy gracz faktycznie ma konto premium, i jeśli tak, sam loguje go do pluginu autoryzacji. Pozostali gracze (bez wersji premium) dalej logują się hasłem tak jak wcześniej.

Plugin ma sens tylko na serwerze w trybie non-premium (online-mode=false), na którym działa plugin do logowania, np. AuthMe. Jak ustawić serwer w tryb non-premium opisaliśmy w poradniku Pierwsze uruchomienie serwera.

Wymagania

Aby FastLogin działał, potrzebujesz:

• serwera z silnikiem Paper, Purpur lub Spigot (FastLogin obsługuje wersje Minecraft od 1.8.8 do najnowszych, w tym 1.21.x),
• pluginu ProtocolLib,
• pluginu do logowania, np. AuthMe Reloaded (obsługiwane są też m.in. LoginSecurity, CrazyLogin i UserLogin),
• serwera w trybie non-premium (online-mode=false).

Serwer premium nie potrzebuje FastLogin

Jeśli Twój serwer działa w trybie premium (online-mode=true), gracze i tak logują się kontem Mojanga i FastLogin nie jest potrzebny. FastLogin przydaje się wtedy, gdy chcesz wpuścić zarówno graczy premium, jak i tych bez wersji premium.

Instalacja

1. Pobierz najnowszą wersję FastLogin dla silnika Paper/Purpur/Spigot z zakładki Releases na GitHubie. W najnowszym wydaniu, w sekcji Assets, znajdziesz plik FastLoginBukkit.jar. Plugin dostępny jest też na SpigotMC. Autor udostępnia dodatkowo najnowsze kompilacje rozwojowe na serwerze CodeMC, ale trwa migracja tego serwera, więc dla pewności pobieraj plik z wydań na GitHubie.
2. Pobierz plugin ProtocolLib. Najprościej wziąć stabilną wersję ze SpigotMC (aktualnie 5.4.0, wspiera Minecraft od 1.8 do 1.21.x). Jeśli grasz na najnowszej wersji Minecrafta i stabilna wersja jeszcze jej nie obsługuje, użyj kompilacji rozwojowej: ProtocolLib.jar.
3. Jeśli nie masz jeszcze pluginu do logowania, pobierz AuthMe Reloaded.
4. Wgraj wszystkie pliki .jar do folderu plugins swojego serwera. Jak to zrobić przez panel voxelhost, pokazaliśmy w poradniku Pierwsze uruchomienie serwera. Pluginy możesz też wgrać przez SFTP.
5. Zrestartuj serwer, aby pluginy wygenerowały swoje pliki konfiguracyjne.
6. Otwórz plik config.yml w folderze plugins/FastLogin i sprawdź konfigurację (opis poniżej), a następnie zrestartuj serwer jeszcze raz.

Konfiguracja

Plik konfiguracyjny FastLogin znajdziesz pod ścieżką plugins/FastLogin/config.yml. Dla większości serwerów domyślne ustawienia są dobre. Poniżej opisaliśmy opcje, które warto znać.

useProxyAgnosticResolver

useProxyAgnosticResolver: true

To najważniejsza opcja dla serwerów w voxelhost. Serwery działają za przezroczystym proxy, dlatego FastLogin musi używać trybu logowania, który nie wysyła adresu serwera do Mojanga. W nowszych wersjach pluginu opcja ta jest domyślnie ustawiona na true, ale zawsze warto ją sprawdzić. Jeśli gracze premium mimo instalacji dalej muszą wpisywać hasło, upewnij się, że ta wartość to true.

autoLogin

autoLogin: true

Domyślnie włączona. Odpowiada za to, że gracz premium jest od razu logowany do pluginu autoryzacji (np. AuthMe). Jeśli ustawisz false, plugin nadal rozpozna konto premium, ale gracz i tak będzie musiał wpisać hasło (przydatne jako dodatkowe zabezpieczenie, ale zwykle chcesz zostawić true).

autoRegister

autoRegister: false

Gdy ustawisz true, FastLogin sam zarejestruje nowego gracza premium (z losowym, mocnym hasłem) i zablokuje możliwość podszycia się pod jego nick przez gracza bez wersji premium. Wadą jest to, że nowy gracz bez wersji premium, który użyje nicku istniejącego konta Minecraft, nie wejdzie na serwer. Zostaw false, jeśli nie masz pewności.

Pierwsze logowanie i komenda /premium

Przy domyślnych ustawieniach (autoRegister: false oraz nameChangeCheck: false) FastLogin nie sprawdza z góry, czy nieznany gracz wchodzący pierwszy raz ma konto premium. Taki gracz najpierw zakłada zwykłe konto w pluginie logowania (np. rejestruje się w AuthMe), a następnie raz wpisuje komendę /premium. Od tej chwili FastLogin rozpoznaje go jako gracza premium i przy kolejnych wejściach loguje automatycznie, bez hasła. Komenda /cracked cofa to oznaczenie.

Jeśli chcesz, żeby gracze premium byli wykrywani automatycznie już przy pierwszym wejściu (bez komendy /premium), włącz autoRegister: true (opisane wyżej) lub nameChangeCheck: true. Pamiętaj wtedy o kompromisach opisanych przy autoRegister oraz o limicie zapytań do Mojanga (patrz sekcja o częstych problemach).

premiumUuid

premiumUuid: false

Po włączeniu FastLogin nada graczowi premium jego prawdziwe (premium) UUID zamiast UUID trybu offline. Dzięki temu po zmianie nicku gracz zachowa swoje dane (ekwipunek, uprawnienia).

Uwaga na UUID i utratę danych

Włączenie premiumUuid zmienia UUID gracza. Jeśli włączysz je na serwerze, na którym gracze mają już postęp zapisany na starym UUID, mogą stracić dostęp do ekwipunku, rang czy uprawnień. Nie zmieniaj tej opcji ani trybu online-mode w trakcie życia serwera bez kopii zapasowej. Ta sama uwaga dotyczy przełączania serwera między trybem premium a non-premium.

secondAttemptCracked

secondAttemptCracked: false

Jeśli gracz bez wersji premium próbuje wejść na nick, który wygląda jak konto premium, zobaczy komunikat bad login lub invalid session. Po ustawieniu true FastLogin zapamięta takiego gracza i przy kolejnej próbie wpuści go jako gracza non-premium.

Sieć z proxy (BungeeCord / Velocity)

FastLogin działa też z proxy BungeeCord/Waterfall i Velocity.

Sekcja proxies w config.yml to nie to

Sekcja proxies w config.yml nie służy do spięcia serwera z BungeeCord ani Velocity. To lista serwerów pośredniczących (HTTP proxy) używanych tylko do zapytań o konta premium, gdy trafisz na limit zapytań Mojanga.

Prawidłowa konfiguracja pod proxy wygląda tak: plugin instalujesz zarówno na proxy, jak i na serwerach docelowych, włączasz w proxy przekazywanie IP (IP forwarding), a serwery autoryzujesz przez plik allowed-proxies.txt (BungeeCord) lub proxyId.txt, który plugin generuje na Velocity. Proxy i serwery docelowe muszą działać w trybie offline. Dokładne kroki znajdziesz w dokumentacji FastLogin. Jeśli spinasz serwer z voxelhost pod własne proxy, zobacz też poradnik Podpinanie serwera pod BungeeCord.

Gracze Bedrock (Geyser / Floodgate)

FastLogin potrafi obsłużyć graczy z Minecraft Bedrock łączących się przez Geyser i Floodgate. Odpowiadają za to opcje autoLoginFloodgate i autoRegisterFloodgate. Autor pluginu oznacza tę funkcję jako eksperymentalną, a jej błędna konfiguracja może pozwolić na nieautoryzowany dostęp do cudzych kont, dlatego włączaj ją tylko ze zrozumieniem i po lekturze komentarzy w config.yml.

Częste problemy

Plugin nie działa

Upewnij się, że w folderze plugins masz zarówno ProtocolLib, jak i plugin do logowania (np. AuthMe). Bez nich FastLogin nie zadziała. Sprawdź też w konsoli serwera przy starcie, czy ProtocolLib nie zgłasza, że nie obsługuje Twojej wersji Minecrafta. W razie potrzeby pobierz nowszą (rozwojową) wersję ProtocolLib.

Gracze premium nadal muszą wpisywać hasło

Sprawdź kolejno: czy serwer jest w trybie non-premium (online-mode=false), czy useProxyAgnosticResolver jest ustawione na true, czy autoLogin jest true oraz czy używasz obsługiwanego pluginu do logowania. Pamiętaj też, że przy domyślnych ustawieniach gracz premium musi raz wpisać komendę /premium (patrz sekcja o pierwszym logowaniu). Po każdej zmianie w config.yml zrestartuj serwer.

Gracz dostaje komunikat "bad login" lub "invalid session"

Tak zwykle wygląda konflikt nicków. Gdy gracz bez wersji premium próbuje wejść na nick, który jest zajętym kontem premium, Mojang odrzuca logowanie i pojawia się ten komunikat. Tej wiadomości nie da się zmienić. Jeśli chcesz, żeby taki gracz mógł wejść jako non-premium, ustaw secondAttemptCracked: true.

Po instalacji graczom zresetował się ekwipunek lub rangi

To efekt zmiany UUID (najczęściej po włączeniu premiumUuid albo po przełączeniu online-mode). Dane graczy są przypisane do konkretnego UUID, więc jego zmiana odcina je od dotychczasowego postępu. Przywróć poprzednie ustawienie lub odtwórz dane z kopii zapasowej i nie zmieniaj tych opcji na działającym serwerze bez backupu.

Nowi gracze logują się jako non-premium mimo konta premium

Jeśli masz włączone autoRegister lub nameChangeCheck, FastLogin odpytuje serwery Mojanga. Limit to 600 zapytań na 10 minut z jednego adresu IP. Po jego przekroczeniu nowi gracze są przez chwilę logowani jako non-premium, aż limit się odnowi. Na dużym serwerze rozłóż to w czasie lub ogranicz zbędne zapytania innych pluginów.

Potrzebujesz pomocy?

Jeśli coś nie działa, napisz do nas na Discordzie. Chętnie pomożemy skonfigurować plugin.