Comment installer des cartes et des véhicules FiveM en toute sécurité
Par Luke
Installez chaque carte ou véhicule en tant que ressource indépendante, conservez sa structure d'origine, déclarez uniquement les fichiers de données dont il a besoin et testez-le en staging avant la production. Les cartes et les véhicules partagent le même cycle de vie des ressources, mais leurs actifs et leurs étapes de validation diffèrent.
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.
Choisissez le bon chemin
| Ressource | Contenu typique | Guide approfondi |
|---|---|---|
| Carte/MLO | .ymap, .ytyp, modèles, textures et collision | Ajouter un MLO FiveM à un serveur |
| Véhicule | .yft, .ytd et des fichiers méta de véhicule documentés | Suivez les notes d'installation actuelles du package. |
Vérifications préalables communes
- Vérifiez le créateur, la source, la licence, la version et la version/le framework de jeu pris en charge.
- Scannez l'archive et conservez le package original comme preuve de restauration.
- Sauvegardez la configuration et toute ressource que le package remplace.
- Extrayez dans un dossier de ressource dédié avec
fxmanifest.luaà sa racine. - Lisez les dépendances et les notes d'installation avant de modifier le manifeste.
Installer une ressource de carte
Conservez les fichiers fournis .ymap, .ytyp, de modèle, de texture et de collision ensemble. Préservez le manifeste du créateur. Utilisez la déclaration this_is_a_map ou un DLC_ITYP_REQUEST uniquement lorsque le paquet et la documentation Cfx.re actuelle l'exigent ; l'ajout aveugle de directives peut masquer le véritable défaut d'empaquetage.
Démarrez la ressource en préproduction, parcourez toute la zone, inspectez les intérieurs et les collisions, et recherchez les éléments de carte en double ou les autres ressources qui modifient le même endroit. Testez à distance et après reconnexion, pas uniquement au point d’apparition.
Installer une ressource de véhicule
Conservez les modèles et les textures avec les fichiers de métadonnées documentés. Les paquets courants utilisent des entrées telles que vehicles, handling, car variations et car colours, mais les types data_file corrects proviennent du paquet et de la référence officielle du fichier de données. Ne collez pas toutes les déclarations connues dans chaque manifeste de véhicule.
Un nom de modèle ne garantit pas une commande d'apparition. L'apparition appartient au framework installé, au menu d'administration ou à la ressource de véhicule. Vérifiez le nom de modèle configuré et utilisez la commande documentée ou le flux de travail du garage.
Activer dans l'ordre des dépendances
Ajoutez une ensure resource-name ligne après les bibliothèques requises et avant les ressources qui en dépendent. Redémarrez la mise en scène et inspectez la console du serveur ainsi que la console F8 du client. Résolvez les fichiers manquants, les mauvais manifestes et les noms en double plutôt que de redémarrer à plusieurs reprises.
Tester la ressource complète
- Carte : placement, portails, collision, occlusion, éclairage, portes et modifications IPL/carte conflictuelles.
- Véhicule : apparition, textures, sièges, portes, lumières, audio, maniabilité, dégâts et persistance du garage.
- Les deux : téléchargement client propre, reconnexion, redémarrage du serveur, redémarrage de la ressource et sortie du journal.
Isoler les conflits
Désactivez les autres ressources qui modifient la même zone de carte, le même nom de modèle ou la même entrée de métadonnées, puis réactivez-les une par une. Ne modifiez qu'une seule variable par test. Le renommage d'un dossier de ressources ne résout pas les identifiants d'actifs conflictuels qu'il contient.
Restauration
Supprimer la nouvelle ensure entrée, restaurez les fichiers/configurations précédents et annulez les modifications documentées de la base de données. Redémarrez et répétez l'itinéraire de base ou le flux de véhicules. Gardez la ressource désactivée jusqu'à ce que le défaut soit reproduit et corrigé sur la mise en scène.
