So aktivierst du Cayo Perico in FiveM

Um den Cayo-Perico-Inhalt auf einem FiveM-Server verfügbar zu machen, setze die erzwungene Spielversion beim Start auf Build 2189 oder eine spätere unterstützte Version. Build 2189 ist das Cayo Perico Heist Build und kann auch mit dem Alias ausgewählt werden h4. Jede spätere Spielversion enthält Inhalte aus früheren Versionen.

Aktiviere den Cayo-Perico-Spielbuild

1. Stoppe den Server.
2. Öffne die Konfigurationsdatei, die beim Start ausgeführt wird.
3. Füge eine dieser Zeilen hinzu:

   sv_enforceGameBuild 2189

   oder

   sv_enforceGameBuild h4

4. Starte den Server erneut und bestätige den ausgewählten Build in der Serverkonsole.

sv_enforceGameBuild kann nur beim Serverstart festgelegt werden. Das Eingeben danach, nachdem der Server gestartet wurde, wechselt nicht die aktive Spielversion.

Solltest du Build 2189 oder einen neueren Build verwenden?

Verwende 2189, wenn du den ältesten Build benötigst, der Cayo Perico enthält. Verwende einen späteren unterstützten Build, wenn andere Ressourcen neueren GTA Online-Inhalt benötigen. Teste deinen gesamten Ressourcenstapel nach dem Ändern der Builds, da Fahrzeuge, Karten und Skripte von einem bestimmten Build abhängen können.

Spielversion versus Insel-Ladevorgang

Die Spielversion macht Cayo Perico-Assets verfügbar. Sie garantiert nicht, dass jede Server-Ressource die Insel lädt, Spieler dorthin bringt oder Kollisionen korrekt konfiguriert. Einige Server-Stacks verwenden eine dedizierte Insel-/IPL-Ressource oder ein benutzerdefiniertes Reiseskript. Befolge die Dokumentation für die genaue gewartete Ressource, die du installierst; lade kein altes ZIP einfach herunter, weil ein Tutorial es nennt.

Überprüfe Cayo Perico

• Starte den Server vollständig neu, anstatt nur eine Ressource neu zu starten.
• Tritt mit einer sauberen Client-Sitzung bei und reise zur Insel, indem du die unterstützte Route deines Servers nutzt.
• Überprüfe das Gelände, die Kollisionen, die Vegetation, die Türen und die Innenräume.
• Überprüfe den Server und die F8-Konsolen auf fehlende Ressourcen oder Kartenfehler.
• Teste mit dem gleichen OneSync- und Routing-Bucket-Verhalten, das in der Produktion verwendet wird.

Fehlerbehebung

Die Insel ist unsichtbar oder unvollständig

Bestätige zuerst die Startversion. Überprüfe dann, ob die Insel-/IPL-Ressource erfolgreich startet und nicht mit einer anderen Kartenressource kollidiert.

Spieler fallen durch die Karte

Überprüfe Kollisionen und die Startreihenfolge der Ressourcen. Deaktiviere temporär konfliktierende Cayo Perico-Kartenressourcen und teste eine Implementierung nach der anderen.

Der Server startet nach der Änderung nicht

Stelle die vorherige Build-Linie wieder her, überprüfe den Konsolenfehler und bestätige, dass die Build-Nummer oder der Alias in der aktuellen Cfx-Dokumentation aufgeführt ist.

Produktions-Checkliste

1. Sichern server.cfg und die betroffene Ressourcenkonfiguration.
2. Teste die gewählte Build- und Insel-Ressource auf einer Staging-Kopie.
3. Überprüfe Jobs, Fahrzeuge, Inventare und Karten – nicht nur die Insel.
4. Setze es während eines Wartungsfensters mit einem dokumentierten Rollback ein.

Offizielle Referenz

Die aktuelle Build-Liste und das Startverhalten nur für den Start sind in den Offizielle Cfx-Server-Befehle-Referenz. Für zusätzliche Serverressourcen durchstöbere kostenlose FiveM-Skripte oder die FiveMX Shop.