Comment installer des MLO et des maps personnalisées sur mon serveur FiveM ?

Vous voulez donner à votre serveur FiveM une identité unique avec des intérieurs personnalisés et des modifications de map ? Vous tomberez vite sur les MLO et les fichiers ymap. Dans ce guide, vous installez pas à pas un MLO ou une map personnalisée sur votre serveur MC-Node : vous mettez en place la bonne structure de dossiers avec un dossier stream, créez un fxmanifest.lua correct, uploadez la ressource via SFTP et activez le tout avec ensure dans votre server.cfg. Vous découvrirez aussi comment résoudre les problèmes les plus connus, comme des intérieurs qui ne se chargent pas ou des joueurs qui passent à travers le sol.

Quelle est la différence entre un MLO et un ymap ?

Les deux modifient le monde du jeu, mais de manière différente :

• Ymap — un fichier de placement qui ajoute ou déplace des objets existants (props) dans le monde : clôtures, décorations, barrages routiers ou un bâtiment supplémentaire vu de l'extérieur. Léger et simple ; un seul fichier .ymap suffit souvent.
• MLO (Multi-Level Object) — un intérieur complet et accessible avec ses propres pièces, portails, collisions et éclairage. Un MLO se compose généralement de plusieurs fichiers : .ydr (modèles), .ybn (collision), .ytd (textures), un .ytyp (définition de l'intérieur) et un .ymap (placement).

En bref : un ymap place quelque chose, un MLO construit quelque chose dans lequel vous pouvez entrer. L'installation est quasiment identique, mais un MLO est plus sensible aux erreurs car le .ytyp doit être chargé correctement.

Étape 1 : Mettez en place la bonne structure de dossiers

1. Décompressez le MLO ou la map personnalisée téléchargée sur votre ordinateur et regardez quels fichiers s'y trouvent.
2. Créez un seul dossier de ressource avec un nom court, sans espaces ni majuscules, par exemple vanilla_hotel.
3. Placez tous les fichiers de streaming (.ydr, .ybn, .ytd, .ytyp et .ymap) dans un sous-dossier nommé stream.
4. Placez un fichier fxmanifest.lua à la racine de la ressource.

La structure ressemble alors à ceci :

vanilla_hotel/
├── fxmanifest.lua
└── stream/
    ├── hotel_interior.ydr
    ├── hotel_interior.ybn
    ├── hotel_textures.ytd
    ├── hotel.ytyp
    └── hotel.ymap

Un fxmanifest.lua minimal et correct pour une ressource de map :

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

La ligne this_is_a_map 'yes' indique à FiveM que cette ressource contient des données du monde, afin que la map soit proprement rechargée au redémarrage de la ressource. Si le créateur fournit des lignes supplémentaires, comme data_file 'DLC_ITYP_REQUEST' 'stream/hotel.ytyp', laissez-les simplement en place.

Étape 2 : Uploadez la ressource via SFTP

1. Connectez-vous à votre serveur via SFTP. La configuration est expliquée dans SFTP avec WinSCP ou FileZilla.
2. Naviguez vers le dossier resources de votre serveur FiveM.
3. Uploadez le dossier de ressource complet, y compris le sous-dossier stream. Vous pouvez aussi placer la ressource dans un dossier de catégorie comme [maps].
4. Vous utilisez FileZilla ? Avant l'upload, réglez Transfert → Type de transfert → Binaire. En mode ASCII ou Auto, FileZilla peut corrompre les fichiers binaires comme .ydr et .ybn, et votre intérieur ne se chargera jamais.

Les petites ressources peuvent aussi être uploadées via l'onglet Files du panel, mais pour les MLO avec de gros fichiers de streaming, le SFTP est plus fiable. La méthode générale est décrite dans Comment uploader un script ?

Étape 3 : Ajoutez ensure dans server.cfg

1. Ouvrez server.cfg via l'onglet Files du panel (ou via SFTP).
2. Ajoutez la ligne ensure vanilla_hotel, avec exactement le même nom que votre dossier de ressource.
3. Attention à l'ordre : placez les ressources de map au-dessus des scripts qui ont besoin de l'intérieur, comme les scripts de housing, de garage ou de téléportation. Avec un mauvais ordre d'ensure, un tel script démarre alors que l'intérieur n'existe pas encore.
4. Enregistrez le fichier et redémarrez votre serveur via l'onglet Console.
5. Vérifiez dans la console que Started resource vanilla_hotel apparaît, puis rendez-vous sur place en jeu.

Problèmes fréquents

• L'intérieur est invisible ou ne se charge pas — Vérifiez d'abord dans la console que la ressource a bien démarré. Si c'est le cas, les fichiers ont souvent été corrompus pendant l'upload ou le .ytyp n'est pas chargé : ré-uploadez tout le dossier stream en mode binaire et vérifiez que this_is_a_map 'yes' figure bien dans le fxmanifest.lua.
• Vous passez à travers le sol — Le fichier de collision (.ybn) est manquant ou endommagé. Comparez les tailles des fichiers sur le serveur avec celles sur votre PC ; si elles diffèrent, l'upload a échoué.
• Deux MLO au même endroit — Des murs qui clignotent, des portes en double ou un intérieur tout noir indiquent généralement deux ressources qui modifient le même bâtiment. Supprimez la ligne ensure de l'une des deux et redémarrez le serveur.
• Erreur d'assets trop volumineux — Un message console indiquant qu'un asset dépasse la limite de taille vient presque toujours de fichiers de textures .ytd trop lourds. Utilisez une version optimisée ou réduisez les textures (par exemple de 4K à 2K) ; des maps trop lourdes provoquent en outre de longs temps de chargement et des crashs client.
• Erreurs de script après l'ajout de la map — Vérifiez l'ordre dans server.cfg : la ressource de map doit être chargée avant les scripts qui y font référence.

Terminé !

Votre serveur streame désormais vos propres MLO et maps personnalisées. Vous bloquez encore ? Ouvrez un ticket via notre page de support en indiquant le nom de la ressource et le message d'erreur exact de la console.