Pour rendre le contenu de Cayo Perico disponible sur un serveur FiveM, définissez la version du jeu imposée au démarrage sur la version 2189 ou toute version ultérieure prise en charge. La version 2189 est la version du braquage de Cayo Perico et peut également être sélectionnée avec l'alias h4. Chaque version ultérieure du jeu inclut le contenu des versions précédentes.
Confirmez l’édition GTA visée avant d’installer ou d’exporter des éléments. Les paquets Legacy ne sont pas automatiquement compatibles avec Enhanced ; suivez les directives officielles de conversion d'assets Enhanced si c'est votre cible.
Les exemples de configuration et de code ici ciblent FiveM pour GTA V Legacy. Enhanced a des règles d'exécution et de compatibilité différentes ; vérifiez les changements Legacy-to-Enhanced de Cfx.re avant de les appliquer à un serveur Enhanced.
Activer la version du jeu Cayo Perico
- Arrêtez le serveur.
- Ouvrez le fichier de configuration qui est exécuté au démarrage.
- Ajoutez une de ces lignes :
sv_enforceGameBuild 2189ou
sv_enforceGameBuild h4 - Redémarrez le serveur et confirmez la version sélectionnée dans la console du serveur.
sv_enforceGameBuild peut uniquement être définie au démarrage du serveur. L'entrer après le démarrage du serveur ne changera pas la version active du jeu.
Dois-je utiliser la version 2189 ou une version plus récente ?
Utilisez 2189 lorsque vous avez besoin de la version la plus ancienne qui contient Cayo Perico. Utilisez une version ultérieure prise en charge lorsque d'autres ressources nécessitent un contenu plus récent de GTA Online. Testez votre pile de ressources complète après avoir changé de version car les véhicules, les cartes et les scripts peuvent dépendre d'une version particulière.
Version du jeu versus chargement de l'île
La version du jeu rend les actifs de Cayo Perico disponibles. Elle ne garantit pas que chaque ressource du serveur chargera l'île, y enverra les joueurs ou configurera les collisions correctement. Certaines piles de serveurs utilisent une ressource dédiée à l'île/IPL ou un script de voyage personnalisé. Suivez la documentation pour la ressource exacte que vous installez ; ne téléchargez pas un ancien ZIP simplement parce qu'un tutoriel le nomme.
Vérifiez Cayo Perico
- Redémarrez le serveur complètement plutôt que de redémarrer une seule ressource.
- Connectez-vous avec une session client propre et rendez-vous sur l'île en utilisant l'itinéraire pris en charge par votre serveur.
- Vérifiez le terrain, les collisions, la végétation, les portes et les intérieurs.
- Examinez les consoles du serveur et F8 pour les ressources manquantes ou les erreurs de carte.
- Testez avec le même fonctionnement de OneSync et des buckets de routage qu’en production.
Dépannage
L'île est invisible ou incomplète
Confirmez d'abord la version de démarrage. Ensuite, vérifiez que la ressource de l'île/IPL démarre avec succès et n'entre pas en conflit avec une autre ressource de carte.
Les joueurs tombent à travers la carte
Vérifiez les collisions et l'ordre de démarrage des ressources. Désactivez temporairement les ressources de la carte Cayo Perico en conflit et retestez une implémentation à la fois.
Le serveur ne démarrera pas après le changement.
Restaurez la ligne définissant la version précédente du jeu, vérifiez l’erreur dans la console et confirmez que le numéro ou l’alias figure dans la documentation Cfx actuelle.
Liste de contrôle de production
- Sauvegardez
server.cfget la configuration de la ressource affectée. - Testez la version du jeu choisie et la ressource de l’île sur une copie de préproduction.
- Vérifiez les emplois, les véhicules, les inventaires et les cartes, pas seulement l'île.
- Déployez pendant une fenêtre de maintenance avec un retour en arrière documenté.
Référence officielle
La liste actuelle des compilations et le fait que le réglage n’est pris en compte qu’au démarrage sont documentés dans la référence officielle des commandes de serveur Cfx. Pour d’autres ressources de serveur, parcourez les ressources FiveM ou la boutique RPCrate.