Ajouter des mappings sur un serveur FiveM

Les mappings FiveM (bâtiments, routes, intérieurs MLO, objets) se présentent en ressources avec des fichiers .ymap, .ytyp, .ybn, .ytd, .ydr dans stream/ ou data/. Ce guide décrit la structure fxmanifest, l’upload, l’ensure dans server.cfg, l’ordre de chargement et le dépannage.

Prérequis

• Serveur FiveM opérationnel (fivem-windows-vps)
• Accès FTP/SFTP ou au gestionnaire de fichiers de votre panel
• Fichiers du mapping (.ymap, .ytyp, .ybn, .ytd, .ydr, etc.)

Types de mappings

• Standalone : map seule, indépendante.
• MLO (Map Level Object) : intérieurs avec portes, étages, pièces (volumes, .ybn).
• Add-on : ajout de véhicules, props, parfois fournis avec data_file pour .ytyp/.ymf.

Structure d’une ressource mapping

Dossier type dans resources/ :

resources/
  mon-mapping/
    fxmanifest.lua
    stream/
      building.ymap
      building.ytyp
      interiors.ybn
      textures.ytd
      model.ydr
    data/
      building.ytyp   # si nécessaire pour data_file

fxmanifest.lua (exemple)

fx_version 'cerulean'
game 'gta5'

author 'Votre nom'
description 'Mapping custom'
version '1.0.0'

this_is_a_map 'yes'

-- Fichiers stream (chargés automatiquement)
-- Les .ymap, .ytyp, .ybn, .ytd, .ydr dans stream/ sont chargés par défaut

-- Si data_file pour .ytyp / .ymf (add-ons, etc.) :
-- data_file 'DLC_ITYP_REQUEST' 'data/building.ytyp'

• this_is_a_map 'yes' : indique que la ressource est une map (ordre de chargement, optimisations).
• data_file : pour déclarer des .ytyp ou .ymf utilisés par d’autres ressources ou par le mapping lui‑même. Ex. :

data_file 'DLC_ITYP_REQUEST' 'data/entourage.ytyp'

Upload et emplacement

• Upload : placer le dossier mon-mapping dans resources/ (FTP, panel, ou déploiement).
• Chemin : resources/mon-mapping/ — pas d’espaces ni de caractères spéciaux dans le nom du dossier.

server.cfg : ensure et ordre

• Ordre : framework (ESX, QBCore) et bases d’abord, puis mappings, puis les scripts qui en dépendent.

ensure oxmysql
ensure es_extended
# ... bases ESX/QBCore

ensure mon-mapping
ensure autre-mapping

ensure esx_policejob
# ...

• ensure nom-mapping : le nom = le dossier de la ressource (sans chemin).

Vérification in-game

• /tp vers les coordonnées du mapping (fournies par l’auteur) ou exploration.
• Si rien n’apparaît : manifest, stream/, data_file, ordre d’ensure, cache client (supprimer le cache FiveM, redémarrer le client).

Dépannage

Optimisation

• Nombre : trop de mappings = impact FPS et chargement. Supprimer les inutilisés.
• Distance : certains .ymap définissent une distance de stream ; à ajuster si fourni en source.
• Compression : les .ymap peuvent être optimisés avec les outils des mappers ; pas de manipulation générique simple.

Bonnes pratiques

• Sauvegarder resources/ avant d’ajouter ou mettre à jour un mapping.
• Sources : GTA5-Mods, FiveM (forums, Tebex), packs MLO. Vérifier les licences (usage commercial, attribution).
• Pour le serveur et les scripts : fivem-windows-vps, esx-qbcore-setup.

Ressources

• FiveM – Documentation (Native Reference, etc.)
• FiveM – Streaming (ymap, etc.)

Cet article s’inscrit dans notre série de guides hébergement et gaming. Pour un serveur sur-mesure, contact.