FiveMPublié le 6 février 2026Lecture 5 min

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.

  • .ymap donne la position et le placement des objets.

  • .ytyp définit les types d'objets.

  • .ybn gère les collisions, pour que les joueurs ne passent pas à travers.

  • .ytd contient 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

  1. Dans OuiPanel, ouvrez votre serveur FiveM, puis cliquez sur Gestionnaire de fichiers dans le menu latéral.

  2. Ouvrez le dossier resources.

  3. Si vous avez plusieurs mappings, cliquez sur Créer un dossier et nommez-le [mappings]. Ouvrez-le.

  4. 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.

  5. 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.

Dossier resources dans le Gestionnaire de fichiers avec le bouton Créer un dossier

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

Fenêtre Édition de server.cfg avec les lignes ensure des ressources

Pour les mappings, utilisez toujours ensure plutôt que start. 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.lua existe et contient bien this_is_a_map 'yes'.

  • Vérifiez que la ligne ensure est présente dans server.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.

Page Sauvegardes avec le bouton Créer une sauvegarde et une sauvegarde réussie


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.

Cet article vous a-t-il aidé ?

2 290 vues
Partager cet article
FiveM
Besoin d'un serveur GTA/FiveM ?

Découvrez nos offres d'hébergement GTA V / FiveM dès 2,99 €/mois, serveur prêt en 60 secondes.

Voir les offres →
FiveM
Besoin d'un serveur GTA/FiveM ?

Découvrez nos offres d'hébergement GTA V / FiveM dès 2,99 €/mois, serveur prêt en 60 secondes.

Voir les offres →

Articles connexes