Comment ajouter un mapping sur votre serveur FiveM : le guide complet

Personnaliser la carte de votre serveur FiveM, c'est ce qui fait toute la différence entre un serveur générique et un univers vraiment immersif. Les mappings vous permettent d'ajouter des bâtiments, des intérieurs, des décors et des zones entières qui n'existent pas dans GTA V de base.

Dans ce guide, on va voir ce qu'est exactement un mapping, comment il est structuré, comment l'installer correctement sur votre serveur et comment éviter les erreurs classiques. Que vous ajoutiez un commissariat custom, un hôpital ou un intérieur MLO complet, vous aurez toutes les clés en main.

---

C'est quoi un mapping exactement ?

Un mapping (ou map) est une modification de l'environnement de GTA V qui permet d'ajouter des éléments au monde du jeu. Concrètement, ça peut être :

• Des bâtiments et structures extérieures
• Des intérieurs accessibles (MLO)
• Du mobilier et des objets de décoration
• Des modifications de terrain
• Des zones entièrement nouvelles

Les mappings fonctionnent comme n'importe quelle ressource FiveM : vous les placez dans votre dossier resources, vous les déclarez dans le server.cfg, et le serveur les charge au démarrage.

---

Structure d'un mapping

Un mapping bien organisé suit toujours la même structure de dossiers. Voici à quoi ça ressemble :

nom-du-mapping/
├── fxmanifest.lua
├── stream/
│   ├── fichier1.ymap
│   ├── fichier2.ytyp
│   └── fichier3.ybn
└── data/ (optionnel)
    └── fichier.meta

Les fichiers principaux

fxmanifest.lua — Le fichier de configuration obligatoire qui indique à FiveM comment charger la ressource.

Dossier stream/ — Contient les fichiers du mapping proprement dit :

• .ymap : positions et placements des objets
• .ytyp : définitions des types d'objets
• .ybn : collisions (pour que les joueurs ne passent pas à travers)
• .ytd : textures (si le mapping en utilise des custom)

Dossier data/ (optionnel) — Contient des fichiers .meta pour des configurations supplémentaires.

---

Créer un fxmanifest.lua si le mapping n'en a pas

Certains mappings téléchargés n'ont pas de fichier manifest. Sans lui, FiveM ne peut pas charger la ressource. Voici comment en créer un.

Manifest basique (mapping simple)

Si votre mapping contient uniquement 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 essentielle : elle indique à FiveM que cette ressource est un mapping et qu'il doit charger automatiquement les fichiers du dossier stream/.

Manifest avec fichiers data

Si votre 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 à ça :

mlo-interieur/
├── fxmanifest.lua
└── stream/
    ├── interieur.ymap
    ├── interieur.ytyp
    ├── interieur_shell.ybn
    └── textures.ytd

Et le manifest correspondant :

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

files {
    'stream/*.ytyp'
}

data_file 'DLC_ITYP_REQUEST' 'stream/*.ytyp'

À noter : Certains MLO nécessitent des scripts supplémentaires pour définir les points d'entrée et de sortie. Vérifiez la documentation du mapping que vous installez.

---

Installer le mapping sur votre serveur

Une fois votre mapping prêt avec son fxmanifest.lua, l'installation est simple.

Étape 1 : Uploader le dossier

Connectez-vous au gestionnaire de fichiers de votre serveur OuiHeberg / OuiPanel et naviguez jusqu'au dossier resources. Créez un sous-dossier pour organiser vos mappings si vous en avez plusieurs, par exemple [mappings].

Uploadez le dossier complet de votre mapping dans resources/[mappings]/.

[IMAGE : Screenshot du gestionnaire de fichiers montrant l'arborescence resources avec un dossier mappings contenant plusieurs maps]

Étape 2 : Déclarer dans server.cfg

Ouvrez votre fichier server.cfg et ajoutez une ligne ensure pour charger le mapping :

ensure nom-du-mapping

Si vous avez plusieurs mappings, ajoutez une ligne par mapping :

# Mappings
ensure mapping-commissariat
ensure mapping-hopital
ensure mapping-garage

Important : Pour les mappings, utilisez toujours ensure plutôt que start. La commande ensure est plus fiable pour ce type de ressource.

Étape 3 : Respecter l'ordre de chargement

L'ordre des ressources dans server.cfg peut avoir de l'importance. En général, chargez vos mappings après le framework mais 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

Étape 4 : Redémarrer le serveur

Redémarrez votre serveur pour que les mappings soient chargés. Vérifiez les logs au démarrage : si tout va bien, vous ne devriez voir aucune erreur liée à vos mappings.

---

Vérifier que le mapping fonctionne

Une fois le serveur redémarré, connectez-vous en jeu et rendez-vous aux coordonnées du mapping. La plupart des créateurs indiquent les coordonnées dans la description ou dans un fichier readme.

Si vous ne connaissez pas les coordonnées, vous pouvez les chercher dans les fichiers .ymap du mapping ou utiliser 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 le fxmanifest.lua existe et contient bien this_is_a_map 'yes'
• Vérifiez que la ligne ensure est bien présente dans server.cfg
• Vérifiez les logs du serveur pour des erreurs de chargement
• Assurez-vous d'être aux bonnes coordonnées en jeu

Les collisions ne fonctionnent pas (on passe à travers)

• Le fichier .ybn est probablement manquant ou mal nommé
• Vérifiez que le fichier de collision correspond bien au mapping

Erreur au démarrage du serveur

• Lisez attentivement le message d'erreur dans les logs
• Vérifiez la syntaxe du fxmanifest.lua
• Assurez-vous que tous les fichiers référencés existent bien

Le mapping provoque des lags

Certains mappings très détaillés peuvent impacter les performances. Quelques pistes :

• Réduisez la distance de rendu dans les paramètres du mapping si c'est configurable
• Évitez d'empiler 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

Créez un dossier [mappings] dans vos resources pour regrouper tous vos mappings. Ça facilite la gestion et la maintenance :

resources/
├── [mappings]/
│   ├── mapping-commissariat/
│   ├── mapping-hopital/
│   └── mapping-garage/
├── [esx]/
└── ...

Tester avant de déployer

Testez toujours un nouveau mapping sur un serveur de test avant de l'ajouter à votre serveur principal. Ça évite les mauvaises surprises en production.

Sauvegarder régulièrement

Avant d'ajouter ou de modifier des mappings, faites une sauvegarde de votre serveur. Chez OuiHeberg, vous pouvez créer des backups directement depuis le panel.

---

En résumé

Ajouter des mappings sur votre serveur FiveM, c'est assez simple une fois qu'on a compris la logique : un dossier avec les fichiers du mapping, un fxmanifest.lua bien configuré, et une ligne ensure dans le server.cfg. Les MLO (intérieurs) demandent parfois un peu plus de configuration, mais le principe reste le même.

Envie de personnaliser votre serveur FiveM avec des mappings custom ? OuiHeberg propose des offres d'hébergement FiveM avec un accès simple à vos fichiers pour installer et gérer vos ressources facilement.