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 ensemble les fichiers .ymap, .ytyp, les modèles, les textures et les fichiers de collision fournis. Préservez le manifeste du créateur. Utilisez this_is_a_map ou une déclaration DLC_ITYP_REQUEST uniquement lorsque le paquet et la documentation Cfx.re actuelle l’exigent ; ajouter des directives à l’aveugle peut masquer le véritable défaut de conditionnement du paquet.
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 exacts indiqués dans la documentation. Les paquets courants utilisent des entrées telles que les véhicules, leur comportement, leurs variantes et leurs couleurs, mais les types data_file corrects proviennent du paquet et de la référence officielle des fichiers 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 ligne ensure resource-name après les bibliothèques nécessaires et avant les ressources qui en dépendent. Redémarrez l’environnement de test et examinez la console du serveur ainsi que la console F8 du client. Corrigez les fichiers manquants, les manifestes invalides et les noms en double plutôt que de multiplier les redémarrages.
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
Supprimez la nouvelle entrée ensure, restaurez les fichiers et la configuration précédents, puis annulez les modifications documentées de la base de données. Redémarrez et refaites le parcours ou la séquence d’utilisation du véhicule servant de référence. Gardez la ressource désactivée jusqu’à ce que le défaut soit reproduit et corrigé dans l’environnement de test.