Gdy FiveM pozostaje na ekranie ładowania, najpierw ustal, czy problem dotyczy jednego klienta, jednego serwera, czy każdego gracza po zmianie zasobu. Zachowaj dokładny tekst ekranu i błąd konsoli, przetestuj jeden znany działający serwer i zmieniaj jedną odwracalną przyczynę naraz. Nie zaczynaj od niedokumentowanych convarsów bezpieczeństwa ani od masowego usuwania danych aplikacji i serwera.
Sklasyfikuj problem przed zmianą plików
| Obserwowany zakres | Zacznij tutaj |
|---|---|
| Jeden gracz, wiele serwerów | Proces klienta, oficjalny problem z klientem, instalacja GTA/FiveM i diagnostyka lokalnej pamięci podręcznej. |
| Jeden gracz, jeden serwer | Błąd F8, ścieżka połączenia i pierwszy zasób lub pobieranie, które zawodzi dla tego klienta. |
| Każdy gracz na jednym serwerze | Konsola FXServer/txAdmin, ostatnie wdrożenie, uruchamianie zasobów i stan bazy danych/zależności. |
| Dopiero po zmianie niestandardowego ekranu ładowania | Manifest ekranu ładowania, konsola przeglądarki i cykl życia ręcznego wyłączania. |
Sprawdzenia po stronie gracza
- Zapisz dokładny serwer, czas, tekst ładowania i wszelkie widoczne błędy.
- Naciśnij F8 i przechwyć pierwszy istotny błąd, a nie powtarzające się linie, które po nim następują. Cfx.re dokumentuje F8 w swoim referencje konsoli klienta.
- Spróbuj innego znanego działającego serwera. Jeśli to również zawiedzie, postępuj zgodnie z dokładnymi bieżącymi wytycznymi dotyczącymi problemów z klientem Cfx.re.
- Uruchom ponownie FiveM i Windows raz, aby zwolnić zablokowane procesy.
- Jeśli dowody wskazują na buforowane zasoby serwera, postępuj zgodnie z odwracalną procedurą w FiveM podręczniku dotyczącym pamięci podręcznej. Nie usuwaj całego katalogu application-data.
Kontrole właściciela serwera
- Zatrzymaj wdrożenia i wyeksportuj odpowiedni log FXServer/txAdmin w okolicach nieudanej próby połączenia.
- Sprawdź, czy problem pojawił się natychmiast po zmianie zasobu, artefaktu, konfiguracji lub bazy danych.
- Użyj konsoli Live Console txAdmin i kontroli zasobów, aby zidentyfikować pierwszą nieudaną zależność. txAdmin jest dołączony do FXServer, a jego aktualne funkcje monitorowania są udokumentowane w oficjalnym podręczniku txAdmin.
- Zweryfikuj wymagane usługi i dostęp do bazy danych bez drukowania poświadczeń.
- Cofnij ostatnią wprowadzoną zmianę lub wyłącz tylko odizolowany zasób na instancji deweloperskiej.
Sprawdź uruchamianie zasobów i zależności
Zasób może utknąć podczas inicjalizacji, gdy czeka w nieskończoność na eksport, wynik bazy danych, obiekt frameworka lub zdarzenie klienta. Przejrzyj log serwera pod kątem komunikatów “nie można znaleźć zależności”, błędów parsowania i przekroczeń limitu czasu. Uczyń kolejność uruchamiania jawną za pomocą dependency w fxmanifest.lua lub poprawnej ensure sekwencji; nie ukrywaj błędu za pomocą arbitralnych pauz.
Na serwerze deweloperskim, refresh ponownie skanuje manifesty i ensure resource-name uruchamia lub restartuje jeden zasób. Te polecenia są zdefiniowane w oficjalnym odniesieniu do poleceń serwera. Unikaj restartowania zależności produkcyjnej bez zrozumienia, które aktywne sesje z niej korzystają.
Błędy niestandardowego ekranu ładowania
Jeśli gra jest gotowa, ale niestandardowy ekran nigdy się nie zamyka, sprawdź, czy zasób używa loadscreen_manual_shutdown 'yes'. Ten tryb wymaga, aby skrypt klienta wywołał ShutdownLoadingScreenNui() po rzeczywistym warunku gotowości. Usuń dyrektywę ręcznego wyłączenia, aby powrócić do automatycznego zachowania podczas debugowania. Obsługiwane zdarzenia cyklu życia i postępu są udokumentowane w przewodniku po ekranach ładowania Cfx.re.
Unikaj niebezpiecznych ogólnych poprawek
- Nie kopiuj niedokumentowanych
sv_*wartości bezpieczeństwa z niepowiązanego przewodnika po błędach. - Nie wyłączaj trwale ochrony antywirusowej ani zapory sieciowej.
- Nie usuwaj aktywnej bazy danych, katalogu danych txAdmin ani kompletnej instalacji FiveM przed zachowaniem kopii zapasowej.
- Nie dodawaj powtarzających się prób klienta, które przyznają przedmioty, pieniądze lub uprawnienia więcej niż raz.
- Nie nazywaj dłuższego czasu ładowania poprawką, gdy podstawowy zasób nadal zawodzi.
Zweryfikuj naprawę
Powtórz to samo połączenie na dotkniętym kliencie, czystym drugim kliencie i po pełnym restarcie serwera. Potwierdź, że pierwszy błąd konsoli zniknął, gracz osiągnął używalny stan, wymagane zasoby uruchomiły się raz i nie wystąpiło żadne zduplikowane przyznanie uprawnień ani akcja w ekwipunku. Zachowaj wycofanie, dopóki wynik nie przetrwa restartu.