Comment ajouter un mapping sur votre serveur FiveM : le guide complet
Un mapping FiveM ajoute à la carte de GTA V des bâtiments, des intérieurs, des décors ou des zones entières. Ce guide explique ce qu'est un mapping, comment il est structuré et comment l'installer sur votre serveur FiveM avec OuiPanel, le panel de jeu de OuiHeberg. Il couvre aussi les intérieurs MLO et les erreurs courantes.
C'est quoi un mapping exactement ?
Un mapping (ou map) modifie l'environnement de GTA V pour ajouter des éléments au monde du jeu. Il peut s'agir de plusieurs choses.
Des bâtiments et des structures extérieures.
Des intérieurs accessibles, appelés MLO.
Du mobilier et des objets de décoration.
Des modifications du terrain.
Des zones entièrement nouvelles.
Un mapping fonctionne comme n'importe quelle ressource FiveM. Vous le placez dans le dossier resources, vous le déclarez dans server.cfg, et le serveur le charge au démarrage.
Structure d'un mapping
Un mapping bien organisé suit toujours la même arborescence.
nom-du-mapping/
├── fxmanifest.lua
├── stream/
│ ├── fichier1.ymap
│ ├── fichier2.ytyp
│ └── fichier3.ybn
└── data/ (facultatif)
└── fichier.meta
Les fichiers principaux
Le fichier fxmanifest.lua est obligatoire. Il indique à FiveM comment charger la ressource.
Le dossier stream/ contient les fichiers du mapping lui-même.
.ymapdonne la position et le placement des objets..ytypdéfinit les types d'objets..ybngère les collisions, pour que les joueurs ne passent pas à travers..ytdcontient les textures, si le mapping en utilise des personnalisées.
Le dossier data/, facultatif, contient des fichiers .meta pour des réglages supplémentaires.
Créer un fxmanifest.lua si le mapping n'en a pas
Certains mappings téléchargés n'ont pas de manifest. Sans lui, FiveM ne peut pas charger la ressource. Voici comment en créer un.
Manifest simple
Si le mapping contient seulement un dossier stream/ avec des fichiers .ymap, .ytyp et .ybn, utilisez ce manifest.
fx_version 'cerulean'
game 'gta5'
author 'VotreNom'
description 'Description du mapping'
version '1.0.0'
this_is_a_map 'yes'
La ligne this_is_a_map 'yes' est indispensable. Elle indique à FiveM que la ressource est un mapping, et qu'il doit charger tout seul les fichiers du dossier stream/.
Manifest avec des fichiers data
Si le mapping contient aussi un dossier data/ avec des fichiers .meta ou .ytyp, ajoutez les déclarations correspondantes.
fx_version 'cerulean'
game 'gta5'
author 'VotreNom'
description 'Description du mapping'
version '1.0.0'
this_is_a_map 'yes'
files {
'data/*.meta'
}
data_file 'DLC_ITYP_REQUEST' 'data/*.ytyp'
Manifest pour un MLO (intérieur)
Les MLO sont des mappings d'intérieur plus complexes. Leur structure ressemble à ceci.
mlo-interieur/
├── fxmanifest.lua
└── stream/
├── interieur.ymap
├── interieur.ytyp
├── interieur_shell.ybn
└── textures.ytd
Et voici le manifest qui va avec.
fx_version 'cerulean'
game 'gta5'
this_is_a_map 'yes'
files {
'stream/*.ytyp'
}
data_file 'DLC_ITYP_REQUEST' 'stream/*.ytyp'
Certains MLO demandent des scripts en plus pour définir les points d'entrée et de sortie. Lisez la documentation du mapping que vous installez.
Installer le mapping sur votre serveur
Envoyer le dossier du mapping
Dans OuiPanel, ouvrez votre serveur FiveM, puis cliquez sur Gestionnaire de fichiers dans le menu latéral.
Ouvrez le dossier
resources.Si vous avez plusieurs mappings, cliquez sur Créer un dossier et nommez-le
[mappings]. Ouvrez-le.Sur votre ordinateur, compressez le dossier du mapping en
.zip. Glissez le fichier sur la page. Le calque « Déposez vos fichiers ici » apparaît, relâchez.Cliquez sur les trois points de la ligne du fichier, puis sur Décompresser. Supprimez ensuite le
.zip.
Vérifiez que le dossier obtenu contient directement fxmanifest.lua et stream/, sans dossier intermédiaire. Le dépôt est limité à 100 Mo par fichier. Au-delà, passez par le SFTP, comme le montre le guide Se connecter en SFTP avec FileZilla.

Déclarer le mapping dans server.cfg
Ouvrez server.cfg à la racine du serveur, ajoutez une ligne ensure pour le mapping, puis cliquez sur Sauvegarder.
ensure nom-du-mapping
Avec plusieurs mappings, ajoutez une ligne par mapping.
# Mappings
ensure mapping-commissariat
ensure mapping-hopital
ensure mapping-garage

Pour les mappings, utilisez toujours
ensureplutôt questart. C'est la commande la plus fiable pour ce type de ressource.
Respecter l'ordre de chargement
L'ordre des ressources dans server.cfg peut compter. En général, chargez les mappings après le framework et avant les scripts métiers qui les utilisent.
# Framework
ensure es_extended
ensure esx_skin
# Mappings
ensure mapping-commissariat
ensure mapping-hopital
# Scripts métiers
ensure esx_policejob
ensure esx_ambulancejob
Redémarrer le serveur
Dans la Console, cliquez sur Redémarrer pour charger les mappings. Lisez ensuite les lignes du démarrage. Si tout va bien, aucune erreur ne concerne vos mappings.
Vérifier que le mapping fonctionne
Connectez-vous en jeu et rendez-vous aux coordonnées du mapping. La plupart des créateurs les indiquent dans la description ou dans un fichier readme.
Sans coordonnées, cherchez-les dans les fichiers .ymap du mapping, ou utilisez une commande de téléportation si vous avez un menu admin.
Résoudre les problèmes courants
Le mapping ne s'affiche pas
Vérifiez que
fxmanifest.luaexiste et contient bienthis_is_a_map 'yes'.Vérifiez que la ligne
ensureest présente dansserver.cfg.Cherchez des erreurs de chargement dans la Console.
Assurez-vous d'être aux bonnes coordonnées en jeu.
Les collisions ne fonctionnent pas
Si les joueurs passent à travers les objets, le fichier .ybn manque probablement ou porte un mauvais nom. Vérifiez qu'il correspond bien au mapping.
Erreur au démarrage du serveur
Lisez le message d'erreur dans la Console.
Vérifiez la syntaxe de
fxmanifest.lua.Assurez-vous que tous les fichiers cités existent.
Un mapping mis à jour garde son ancienne version
Le serveur garde en cache les fichiers envoyés aux joueurs. Dans Configuration FiveM, cliquez sur Supprimer le cache, confirmez, puis redémarrez le serveur.
Le mapping provoque des lags
Les mappings très détaillés peuvent peser sur les performances. Quelques pistes.
Réduisez la distance d'affichage dans les réglages du mapping, si c'est possible.
N'empilez pas trop de mappings dans une même zone.
Préférez des mappings optimisés et testés par la communauté.
Bonnes pratiques
Organiser vos mappings
Regroupez vos mappings dans un dossier [mappings] de resources. La gestion et l'entretien en sont plus faciles.
resources/
├── [mappings]/
│ ├── mapping-commissariat/
│ ├── mapping-hopital/
│ └── mapping-garage/
├── [esx]/
└── ...
Tester avant de mettre en ligne
Testez chaque nouveau mapping sur un serveur de test avant de l'ajouter au serveur principal. Vous évitez ainsi les mauvaises surprises devant vos joueurs.
Sauvegarder avant chaque ajout
Avant d'ajouter ou de modifier un mapping, créez une sauvegarde. Dans le menu latéral, cliquez sur Sauvegardes, puis sur Créer une sauvegarde.

Besoin d'aide ?
Ouvrez un ticket depuis Tickets › Ouvrir un ticket, ou depuis la tuile Contacter le support en bas de la fiche de votre serveur dans l'espace client. Vous pouvez aussi poser votre question sur le Discord de OuiHeberg.
Découvrez nos offres d'hébergement GTA V / FiveM dès 2,99 €/mois, serveur prêt en 60 secondes.
Voir les offres →