Ein FiveM Game Build wählt die GTA V Content Baseline aus, die ein Server von Clients erwartet. Serverbetreiber verwenden sv_enforceGameBuild wenn eine Ressource Assets oder Natives von einem bestimmten DLC-Build benötigt. Der neueste verfügbare Build ist nicht automatisch die sicherste Wahl für einen etablierten Server.
Die hier gezeigten Konfigurations- und Codebeispiele beziehen sich auf FiveM für GTA V Legacy. Enhanced hat andere Laufzeit- und Kompatibilitätsregeln; überprüfe die Legacy-zu-Enhanced-Änderungen von Cfx.re bevor du sie auf einen Enhanced-Server anwendest.
Was sv_enforceGameBuild ändert
Die Servervariable fordert verbindende Clients auf, den konfigurierten Game Build zu verwenden. Das kann DLC-Fahrzeuge, Karten, Kleidung, Waffen und verwandte Natives, die von Ressourcen benötigt werden, zugänglich machen. Es aktualisiert deine Skripte nicht, repariert inkompatible Assets nicht und beweist nicht, dass jede Client-Ressource den ausgewählten Build unterstützt.
# server.cfg — example only; choose a tested supported build
set sv_enforceGameBuild 2189
Das Beispiel wählt die Cayo Perico Baseline, keine universelle Empfehlung. Setze diesen Wert beim Start und starte FXServer vollständig neu. Verwende die unterstützten Werte in der aktuellen Cfx-Dokumentation. Füge keine Build-Nummer aus einem undatierten Artikel in die Produktion ein.
Wann du den Build ändern solltest
- Eine dokumentierte Ressource erfordert Inhalte oder Natives, die in einem neueren Build eingeführt wurden.
- Dein aktueller Build wird von der Plattform oder einer kritischen Abhängigkeit nicht mehr unterstützt.
- Du hast ein definiertes Release-Fenster, Staging-Nachweise und einen Rollback-Plan.
Ändere es nicht nur, weil eine größere Zahl existiert. Jede erzwungene Build-Änderung kann Karten, Kleidung, Fahrzeuge, Skripte und Client-Downloads gleichzeitig beeinflussen.
Checkliste für Build-Änderungen
- Sichere die Datenbank, die Serverkonfiguration und den vollständigen Ressourcensatz.
- Notiere die aktuellen Build- und Artefaktversionen.
- Aktualisiere zuerst das Staging und lösche nur die Caches, die das offizielle Verfahren erfordert.
- Teste Beitritt, Charakterauswahl, Kleidung, Innenräume, Fahrzeuge, Waffen und Sprachchat.
- Teste Ressourcen, die Build-spezifische Natives oder Assets verwenden.
- Teste mit einem normalen Spielerkonto, einem Administrator und mehr als einem Client.
- Überprüfe Server- und F8-Konsolenfehler und vergleiche die Leistung mit der Baseline.
- Halte die vorherige Konfiguration und Artefakte für ein Rollback bereit.
Game Build versus Server-Artefakte
Beide lösen unterschiedliche Probleme. Der Game Build steuert die GTA-Inhalts-Baseline; FXServer-Artefakte liefern die Server-Laufzeitumgebung. Die Aktualisierung des einen bedeutet nicht, dass sich das andere in derselben Version ändern muss. Trenne die Änderungen, wenn möglich, damit eine Regression eine klare Ursache hat.
Häufige Fehler
Fehlende Modelle oder Innenräume deuten normalerweise auf eine Asset-/Build-Diskrepanz hin. Skriptfehler können auf eine native oder Abhängigkeitsannahme hinweisen. Ein massiver Client-Fehler unmittelbar nach der Änderung ist ein Release-Vorfall: Führe zuerst ein Rollback durch, reproduziere ihn dann auf der Staging-Umgebung. Halte den genauen Fehler, die betroffene Ressource und alte/neue Versionen mit dem Vorfallsdatensatz fest.
Fahre für die Wartung der Laufzeitumgebung mit dieser Anleitung fort: Aktualisierung der FiveM-Server-Artefakte.