Comment installer un MLO sur un serveur FiveM

Qu'est-ce qu'un FiveM MLO

MLO est le nom donné par la communauté à un intérieur personnalisé ajouté à la map de GTA V, construit de la même manière que les intérieurs accessibles de Rockstar. Les joueurs y entrent directement depuis la rue, sans téléportation ni écran de chargement.

Les MLO sont créés par des mappeurs, gratuits sur le forum Cfx.re ou payants, généralement vendus via Tebex. Pour FiveM, un MLO est simplement une ressource qui streame des fichiers de map : il s'installe donc comme n'importe quelle autre map.

À quoi ressemble une ressource MLO

Une ressource de map est un dossier contenant un manifeste et un dossier stream qui regroupe les fichiers du jeu :

my_mlo/
├── fxmanifest.lua
└── stream/
    ├── my_mlo.ymap
    ├── my_mlo.ytyp
    ├── my_mlo.ybn
    ├── my_mlo.ydr
    └── my_mlo.ytd

La documentation de FiveM donne ce manifeste pour une map :

fx_version 'cerulean'
game 'gta5'
lua54 'yes'
this_is_a_map 'yes'

La plupart des MLO téléchargés contiennent déjà les deux. Si le manifeste du créateur comporte des lignes supplémentaires, comme des entrées data_file, laissez-les telles quelles.

Installer le MLO

1. Décompressez le téléchargement et repérez le dossier qui contient fxmanifest.lua. Ce dossier est la ressource ; certains téléchargements l'enveloppent dans un dossier supplémentaire.
2. Envoyez-le dans le dossier resources de votre serveur, avec un nom de dossier simple : sans espaces.
3. Ajoutez-le à server.cfg :

   ensure my_mlo

4. Chargez-le. Redémarrez le serveur, ou exécutez refresh dans la console du serveur pour détecter le nouveau dossier, puis ensure my_mlo.
5. Rendez-vous sur place en jeu et entrez. Si les murs manquent ou si vous passez à travers le sol, cherchez dans la console les erreurs liées à cette ressource.

Un redémarrage complet du serveur reste le moyen le plus sûr de charger une nouvelle ressource de map.

MLO en escrow achetés sur Tebex

De nombreux MLO payants utilisent l'asset escrow de Cfx.re : les fichiers sont chiffrés et ne fonctionnent que sur les serveurs dont la clé de licence appartient au compte qui les a achetés.

• Achetez avec le bon compte. Le compte Cfx.re associé lors de l'achat doit être celui qui possède la clé de licence de votre serveur.
• Envoyez tous les fichiers, y compris le fichier caché .fxap. Certains logiciels FTP ignorent les fichiers cachés, et sans lui la ressource échoue avec l'erreur "Failed to verify protected resource".
• "You lack the required entitlement" dans la console signifie que la clé de licence et l'achat sont sur des comptes différents. Vérifiez la clé, ou transférez l'achat vers le bon compte sur le portail Cfx.re ; un achat peut être transféré une seule fois.
• Les fichiers en escrow sont chiffrés, vous ne pouvez donc pas les modifier ; les créateurs laissent généralement les fichiers de configuration en clair pour les réglages que vous êtes censé changer.

MLO nécessitant un game build plus récent

Certains MLO utilisent des props ou des intérieurs issus d'une mise à jour plus récente de GTA Online. Ils exigent que le serveur tourne sur ce game build ; sur un build plus ancien, des éléments manquent ou la ressource refuse de démarrer. La page du créateur indique généralement le build.

Définissez-le dans server.cfg, par exemple :

sv_enforceGameBuild 3407

Il ne s'applique qu'au démarrage du serveur, et chaque build inclut le contenu des précédents : utilisez donc le build le plus élevé dont vos MLO ont besoin. FiveM bascule les joueurs sur ce build lorsqu'ils se connectent.

Conflits et performances

• Un seul MLO par emplacement. Deux MLO qui remplacent le même bâtiment entrent généralement en conflit : murs qui clignotent, sols invisibles, portes mal placées. N'en gardez qu'un, ou demandez aux créateurs des versions compatibles.
• Surveillez la console pour repérer les assets trop lourds. FiveM avertit pour les fichiers streamés qui utilisent plus de 16 Mo de mémoire et, au-delà de 48 Mo, indique qu'ils entraîneront des problèmes de streaming, comme des modèles qui ne se chargent pas. Privilégiez les MLO optimisés.
• N'installez pas tout d'un coup. Ajoutez quelques MLO, testez, puis ajoutez-en d'autres. Si quelque chose casse, vous savez lequel est en cause.

N'utilisez que des MLO dont vous avez les droits

La licence de la plateforme FiveM interdit de l'utiliser d'une manière qui porte atteinte aux droits d'autrui, et le forum Cfx.re n'autorise pas les publications qui enfreignent la propriété intellectuelle de tiers, comme de vraies marques ou des modèles 3D repris d'autres jeux. En pratique :

• utilisez les MLO gratuits depuis leur page de publication officielle, et les payants achetés auprès du créateur ;
• n'utilisez jamais de copies leakées ou "crackées" de MLO payants : elles violent la licence du créateur, et celles en escrow ne fonctionneront de toute façon pas ;
• conservez les crédits et le fichier de licence du créateur dans la ressource.

Les MLO sur les serveurs FiveM HytHost

Sur l'hébergement FiveM HytHost, c'est txAdmin qui fait tourner votre serveur, et votre server.cfg ainsi que le dossier resources se trouvent dans le dossier de données de txAdmin, txData. Envoyez-y vos MLO avec le gestionnaire de fichiers du panel ou en SFTP, et modifiez server.cfg dans l'éditeur CFG de txAdmin.

• Ne touchez pas au server.cfg du dossier racine : le panel le réécrit à chaque démarrage, et ce n'est pas celui qu'utilise txAdmin.
• Ajoutez vous-même sv_enforceGameBuild au server.cfg de txAdmin quand un MLO en a besoin.
• Par défaut, le serveur se met à jour vers les derniers artifacts FiveM à chaque démarrage.

Vous débutez avec FiveM ? Commencez par comment créer un serveur FiveM.