Ten przewodnik obejmuje rozwiązania najczęstszych problemów z serwerem FiveM — problemy z dostępem do TXAdmin, błędy klucza licencyjnego CFX, błędy połączenia z bazą danych, awarie serwera, problemy z połączeniem graczy oraz nieładujące się zasoby. Aby uzyskać informacje na temat początkowej konfiguracji serwera, zobacz Przewodnik konfiguracji serwera FiveM.

TXAdmin nie ładuje się lub jest niedostępny

• Sprawdź, czy serwer działa w GPanel — TXAdmin uruchamia się tylko wtedy, gdy proces serwera FiveM jest aktywny.
• Sprawdź w konsoli GPanel adres URL i port TXAdmin. Port TXAdmin różni się od portu gry.
• Upewnij się, że używasz http://, a nie https:// — TXAdmin domyślnie nie korzysta z SSL.
• Jeśli TXAdmin działał wcześniej, ale przestał się ładować, spróbuj zrestartować serwer z poziomu GPanel.
• Wyczyść pamięć podręczną przeglądarki lub spróbuj otworzyć okno incognito/prywatne.

Błędy klucza licencyjnego CFX

Błędy połączenia z bazą danych

Dodatkowe kroki rozwiązywania problemów z bazą danych:

• Jeśli używasz oxmysql, upewnij się, że masz zasób oxmysql w folderze resources/ oraz że ensure oxmysql występuje w server.cfg przed jakimikolwiek zasobami wymagającymi bazy danych.
• Jeśli Twoje hasło zawiera znaki specjalne, takie jak @, # lub %, zakoduj je w formacie URL w ciągu połączenia (np. @ staje się %40).
• Sprawdź swój ciąg połączenia pod kątem brakujących lub nadmiarowych znaków — nawet jeden źle umieszczony znak spowoduje błąd.

Awarie serwera przy uruchamianiu

• Sprawdź konsolę GPanel pod kątem komunikatów o błędach. Częste przyczyny to brakujący lub źle skonfigurowany server.cfg, nieprawidłowy klucz licencyjny CFX lub uszkodzony zasób.
• Spróbuj wyłączyć niestandardowe zasoby, komentując je w server.cfg (dodaj # przed każdą linią ensure) i zrestartuj. Dodawaj je z powrotem pojedynczo, aby zidentyfikować problematyczny zasób.
• Upewnij się, że porty w endpoint_add_tcp i endpoint_add_udp odpowiadają portowi przypisanemu w GPanel.

# Comment out resources to isolate the problem
#ensure suspicious-resource
#ensure another-resource

# Keep core resources enabled
ensure mapmanager
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure chat

Gracze nie mogą się połączyć

• Potwierdź, że serwer wyświetla status Running w GPanel.
• Sprawdź IP i port — gracze powinni używać portu gry, a nie portu TXAdmin.
• Sprawdź, czy sv_maxclients nie jest ustawione na 0 lub nieracjonalnie niską liczbę.
• Jeśli używasz hasła serwera (sv_password w server.cfg), upewnij się, że gracze je znają.
• Gracze muszą mieć zainstalowanego klienta FiveM — nie mogą połączyć się za pomocą zwykłego launchera GTA V.
• Sprawdź zakładkę Network w GPanel i potwierdź, że porty w endpoint_add_tcp i endpoint_add_udp się zgadzają. Niezgodność uniemożliwi połączenia.

Zasoby nie ładują się

• Sprawdź, czy folder zasobu znajduje się w katalogu resources/ (lub odpowiednim podfolderze).
• Sprawdź, czy nazwa folderu dokładnie odpowiada linii ensure w server.cfg (z uwzględnieniem wielkości liter).
• Każdy zasób musi zawierać prawidłowy plik fxmanifest.lua (lub starszy __resource.lua). Jeśli ten plik brakuje, zasób się nie załaduje.
• Sprawdź konsolę TXAdmin lub GPanel pod kątem komunikatów o błędach związanych z zasobem. Częste błędy obejmują brakujące zależności lub błędy składni Lua.
• Jeśli zasób wymaga frameworka (ESX, QBCore), upewnij się, że framework jest ładowany przed zasobem w server.cfg.
• Jeśli zasób wymaga bazy danych, upewnij się, że Twój zasób MySQL (oxmysql, mysql-async) jest załadowany, a połączenie z bazą danych działa.

Problemy z wydajnością serwera

• Otwórz TXAdmin i sprawdź Dashboard pod kątem wskaźników wydajności (czas ticka, liczba graczy, zużycie pamięci).
• Zdrowy serwer FiveM powinien utrzymywać czas ticka serwera (zwany również „hitch") poniżej 20 ms. Stałe skoki powyżej tej wartości wskazują, że zasób zużywa zbyt dużo czasu przetwarzania.
• Użyj strony Resources w TXAdmin, aby zidentyfikować, które zasoby zużywają najwięcej czasu serwera.
• Usuń lub zastąp źle zoptymalizowane zasoby. Darmowe zasoby z nieznanych źródeł są często przyczyną problemów z wydajnością.
• Zmniejsz liczbę załadowanych zasobów, jeśli osiągane są limity pamięci lub procesora Twojego planu serwera.

Uzyskiwanie pomocy

Jeśli wypróbowałeś powyższe rozwiązania i nadal masz problemy:

1. Skopiuj pełny komunikat błędu z konsoli GPanel lub logu TXAdmin.
2. Zanotuj, które kroki rozwiązywania problemów już wypróbowałeś.
3. Otwórz zgłoszenie do pomocy technicznej pod adresem https://legionhosting.net/submitticket.php wraz z tymi informacjami. Nasz zespół pomoże Ci tak szybko, jak to możliwe.

Powiązane artykuły

• Przewodnik konfiguracji serwera FiveM
• Zasoby, skrypty i konfiguracja bazy danych FiveM
• Jak znaleźć adres IP i port serwera
• Przewodnik uruchamiania serwera