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 der Cayo-Perico-Heist-Build und lässt sich auch über folgenden Alias auswählen: h4. Jede spätere Spielversion enthält Inhalte aus früheren Versionen.

Bestätige die Ziel-GTA-Edition, bevor du Assets installierst oder exportierst. Legacy-Pakete sind nicht automatisch Enhanced-ready; befolge die offizielle Anleitung zur Enhanced-Asset-Konvertierung wenn dies dein Ziel ist.

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.

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

Der Game Build macht die Cayo Perico-Assets verfügbar. Er 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 eigenes Reiseskript. Befolge die Dokumentation der genauen, gepflegten Ressource, die du installierst; lade kein altes ZIP herunter, nur 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 über die vom Server unterstützte Route zur Insel.
• Ü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 Konfigurationszeile für den Spiel-Build wieder her, prüfe den Konsolenfehler und bestätige, dass Buildnummer oder Alias in der aktuellen Cfx-Dokumentation aufgeführt sind.

Produktions-Checkliste

1. Sichere server.cfg und die betroffene Ressourcenkonfiguration.
2. Teste den gewählten Build und die Inselressource 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 Buildliste und die Beschränkung auf den Serverstart sind hier dokumentiert: offiziellen Cfx-Server-Befehle-Referenz. Für zusätzliche Serverressourcen durchstöbere FiveM-Ressourcen oder dem RPScripts Shop.