>
Tutoriel 2026-02-01

Développement de cartes YMAP pour FiveM

TDYSKY

TDYSKY

Fondateur et développeur principal chez Agency Scripts

Que sont les fichiers YMAP ?

Les fichiers YMAP sont le format de placement de carte utilisé par GTA V et FiveM pour définir l'emplacement des objets, des bâtiments et des accessoires dans le monde du jeu. Lorsque tu crées un intérieur personnalisé ou une modification de carte pour FiveM, tu crées essentiellement un fichier YMAP qui indique au moteur quels modèles 3D placer, où les positionner et comment les orienter. Contrairement aux simples scripts de placement d'accessoires qui génèrent des objets au moment de l'exécution, les fichiers YMAP sont chargés dans le cadre du monde du jeu pendant la diffusion, ce qui signifie qu'ils bénéficient du système de niveau de détail intégré au moteur, de l'élimination des occlusions et de la gestion de la mémoire. Cela fait de YMAP la méthode privilégiée pour créer des ajouts de cartes permanents qui doivent fonctionner correctement sur des serveurs comptant de nombreux joueurs.

Outils pour le développement de cartes

Le principal outil de création de cartes FiveM est CodeWalker, une application gratuite développée par la communauté qui tu permet de parcourir, de modifier et d'exporter les données cartographiques GTA V. Avec CodeWalker, tu peux placer des accessoires à partir de la bibliothèque intégrée du jeu, les positionner avec précision à l'aide de coordonnées et de valeurs de rotation, et exporter ton création sous forme de fichier YMAP prêt à être diffusé en streaming. Pour un travail plus avancé, Blender avec l'addon Sollumz tu permet de créer des modèles 3D entièrement personnalisés et de les exporter dans les formats requis par FiveM. De nombreux développeurs de cartes utilisent également des outils de jeu tels que Spooner ou des scripts de placement d'accessoires personnalisés pour le travail de mise en page initial avant l'exportation au format YMAP. Le flux de travail implique généralement un placement approximatif dans le jeu, un affinement dans CodeWalker et une exportation finale pour une utilisation en production.

Créer des intérieurs personnalisés

Les intérieurs personnalisés sont des espaces clos comme des appartements, des bureaux, des magasins ou des installations souterraines dans lesquels les joueurs peuvent entrer et avec lesquels interagir. Créer un intérieur convaincant nécessite une attention particulière à la géométrie des collisions, à l’éclairage et à la densité des accessoires. Commencez par définir l'enveloppe de ton intérieur à l'aide de modèles de murs, de sols et de plafonds appropriés, puis ajoutez des meubles, des décorations et des éléments fonctionnels. Les fichiers de collision (YBNF) doivent correspondre à ton géométrie visuelle afin que les joueurs ne puissent pas traverser les murs ou tomber à travers les sols. L'éclairage intérieur est géré par une combinaison de sondes lumineuses cuites et de sources lumineuses dynamiques définies dans ton YMAP. Testez minutieusement ton intérieur en parcourant chaque recoin, en vérifiant les coutures visuelles, les espaces de collision et les zones où la caméra coupe la géométrie.

Diffusion et performances

Des cartes personnalisées sont diffusées aux joueurs à mesure qu'ils s'approchent de l'emplacement, ce qui signifie que la taille et la complexité des fichiers ont un impact direct sur les temps de chargement et les performances du client. Gardez tes fichiers YMAP concentrés sur une zone raisonnable plutôt que de répartir les accessoires sur l'ensemble de la carte dans une seule ressource. Les grands intérieurs doivent être divisés en plusieurs fichiers YMAP qui se chargent indépendamment, et tu dois utiliser des distances LOD appropriées pour empêcher les accessoires distants de consommer les ressources de rendu. Le fxmanifest.lua pour une ressource cartographique, tu dois inclure tes fichiers YMAP et YTYP comme data_file entrées avec les déclarations de type correctes. Surveillez les performances côté client à l'aide du profileur intégré du FiveM pour garantir que tes cartes personnalisées ne provoquent pas de baisse de fréquence d'images, en particulier dans les zones où de nombreux joueurs se rassemblent simultanément.

Bibliothèques d'accessoires et meilleures pratiques

Le GTA V est livré avec des milliers d'accessoires intégrés que tu peux utiliser dans tes cartes sans ajouter de contenu en streaming supplémentaire. L'apprentissage des conventions de dénomination des accessoires tu aide à trouver rapidement les bons objets. Accessoires préfixés par prop_ sont des articles à usage général, v_ les éléments préfixés sont des meubles d'intérieur, et hei_ les objets proviennent de contenu lié au braquage. Lorsque tu places des accessoires, alignez-les sur une grille cohérente pour éviter les objets flottants et les géométries qui se chevauchent. Regroupez logiquement les accessoires associés et utilisez des noms descriptifs pour tes fichiers YMAP afin que les autres développeurs puissent comprendre la structure de la carte. Testez toujours tes cartes avec l'éclairage et les conditions météorologiques par défaut du jeu, car les accessoires peuvent être très différents selon les scénarios d'éclairage.

Partager cet article

Prêt à améliorer votre serveur ?

Découvrez nos scripts FiveM premium dans la boutique Agency Scripts ou rejoignez notre communauté Discord pour le support et les mises à jour.