Wanneer FiveM op een laadscherm blijft hangen, bepaal dan eerst of de storing één client, één server of elke speler treft na een wijziging van een resource. Bewaar de exacte schermtekst en consolefout, test één bekend werkende server en wijzig één omkeerbare oorzaak tegelijk. Begin niet met ongedocumenteerde beveiligingsconvars of een algehele verwijdering van applicatie- en servergegevens.
Classificeer de storing voordat je bestanden wijzigt
| Geobserveerde scope | Start hier |
|---|---|
| Eén speler, meerdere servers | Clientproces, officiële clientprobleem, GTA/FiveM-installatie en diagnose van de lokale cache. |
| Eén speler, één server | F8-fout, verbindingspad en de eerste resource of download die mislukt voor die client. |
| Elke speler op één server | FXServer/txAdmin console, recente implementatie, opstarten van resources en database/afhankelijkheidsstatus. |
| Alleen na een aangepaste laadschermwijziging | Manifest van het laadscherm, browserconsole en levenscyclus van handmatig afsluiten. |
Controles aan de spelerzijde
- Noteer de exacte server, tijd, laadtekst en eventuele zichtbare fout.
- Druk op F8 en leg de eerste relevante fout vast in plaats van de herhaalde regels die erop volgen. Cfx.re documenteert F8 in zijn clientconsole referentie.
- Probeer een andere bekende werkende server. Als dat ook mislukt, volg dan de exacte huidige Cfx.re client-issues richtlijnen.
- Herstart FiveM en Windows eenmaal om vergrendelde processen vrij te geven.
- Als bewijs wijst op gecachte serverassets, gebruik dan de omkeerbare procedure in de FiveM cachegids. Verwijder niet de hele application-data map.
Server-eigenaar controles
- Bevries implementaties en exporteer het relevante FXServer/txAdmin log rond één mislukte verbinding.
- Controleer of het probleem direct begon na een wijziging in een resource, artifact, configuratie of database.
- Gebruik txAdmin's Live Console en resourcecontroles om de eerste mislukte afhankelijkheid te identificeren. txAdmin wordt gebundeld met FXServer en de huidige monitoringfuncties ervan zijn gedocumenteerd in de officiële txAdmin gids.
- Verifieer vereiste services en database-toegang zonder referenties af te drukken.
- Rol de laatste eigen wijziging terug of schakel alleen de geïsoleerde resource uit op een ontwikkelinstantie.
Controleer resource-opstart en afhankelijkheden
Een resource kan de onboarding vertragen wanneer deze oneindig wacht op een export, database-resultaat, framework-object of client-event. Controleer het serverlogboek op “could not find dependency”, parseerfouten en time-outs. Maak de opstartvolgorde expliciet met dependency in fxmanifest.lua of een correcte ensure volgorde; verberg de fout niet met willekeurige sleeps.
Op een ontwikkelserver, refresh scant opnieuw manifesten en ensure resource-name start één resource op of herstart deze. Deze commando's zijn gedefinieerd in de officiële server-command referentie. Vermijd het herstarten van een productiedependency zonder te begrijpen welke actieve sessies deze gebruiken.
Fouten met aangepaste laadschermen
Als de game klaar is, maar een aangepast scherm sluit nooit, inspecteer dan of de resource gebruikt loadscreen_manual_shutdown 'yes'. Die modus vereist een client-script om aan te roepen ShutdownLoadingScreenNui() na een echte gereedheidsconditie. Verwijder de 'manual-shutdown'-richtlijn om terug te keren naar automatisch gedrag tijdens het debuggen. De ondersteunde levenscyclus- en voortgangsevenementen zijn gedocumenteerd in de Cfx.re loading-screen guide.
Vermijd onveilige algemene oplossingen
- Kopieer geen ongedocumenteerde
sv_*beveiligingswaarden uit een ongerelateerde foutengids. - Schakel antivirus- of firewallbescherming niet permanent uit.
- Verwijder geen live database, txAdmin data directory of volledige FiveM installatie voordat je een back-up hebt bewaard.
- Voeg geen herhaalde client-retries toe die items, geld of permissies meer dan eens verlenen.
- Roep een langere laadtijdtimeout geen oplossing aan wanneer de onderliggende bron nog steeds faalt.
Controleer de reparatie
Herhaal dezelfde verbinding op de betreffende client, een schone tweede client en na een volledige serverherstart. Bevestig dat de eerste consolefout verdwenen is, de speler een bruikbare staat bereikt, vereiste bronnen eenmaal gestart zijn en er geen dubbele entitlement- of inventarisactie heeft plaatsgevonden. Houd de rollback totdat het resultaat de herstart overleeft.