Comment installer une MLO sur un serveur FiveM : stream, fxmanifest, ensure

Vous avez téléchargé un pack de carte avec des fichiers comme .ymap, .ytyp, .ybn et .ydr, et vous le voulez sur votre serveur. Ce guide montre la disposition des dossiers, le fxmanifest.lua, la ligne server.cfg et un moyen rapide de la tester dans le jeu.

#Qu'y a-t-il dans un pack de carte

Une MLO (un intérieur personnalisé) ou une carte est une resource normale. Les fichiers habituels sont :

• .ymap: où les objets et l'intérieur se trouvent dans le monde.
• .ytyp: la définition de l'intérieur et de ses props personnalisés (leurs « archetypes »).
• .ybn: les collisions. Sans eux, vous tombez à travers le sol ou marchez à travers les murs.
• .ydr et .ydd: les modèles 3D des props et des pièces.
• .ytd: les textures.

Tous ceux-ci vont dans un dossier nommé stream. FiveM envoie tout dans stream aux joueurs tout seul, donc vous ne listez pas ces fichiers dans le manifest.

#La structure des dossiers

resources/[maps]/my_mlo/
  fxmanifest.lua
  stream/
    my_mlo.ymap
    my_mlo.ytyp
    my_mlo.ybn
    my_mlo_props.ydr
    my_mlo.ytd

De nombreux packs ont un autre niveau, comme my_mlo-master/my_mlo/. Déplacez le dossier qui contient fxmanifest.lua dans resources, sinon le serveur ne peut pas trouver la resource.

#Le fxmanifest.lua

Si le pack n'a pas de manifest, créez-en un :

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

this_is_a_map 'yes' dit à FiveM que la resource contient des données de carte. Si le pack a un fichier .ytyp, ajoutez la ligne qui l'enregistre :

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

data_file 'DLC_ITYP_REQUEST' 'stream/my_mlo.ytyp'

Utilisez une ligne data_file par fichier .ytyp. Le chemin est le chemin réel dans le dossier, donc vérifiez le nom et la casse des lettres.

Conseil : si le pack était livré avec un manifest, gardez-le. L'auteur l'a écrit pour ces fichiers exacts, et il liste souvent plusieurs fichiers .ytyp ou des options supplémentaires que vous ne voulez pas deviner.

#Ajoutez-le à server.cfg

ensure my_mlo

Le nom après ensure doit être le nom du dossier. Pour démarrer un groupe entier, mettez les cartes dans un dossier entre crochets et utilisez ensure [maps]. Les cartes ne dépendent pas de votre framework, mais démarrez-les après vos autres resources de base pour qu'une erreur de carte ne puisse pas bloquer les importantes. Plus d'informations à ce sujet dans ordre ensure server.cfg.

Redémarrez le serveur, ou tapez ensure my_mlo dans la console en direct de txAdmin. Un nouveau .ytyp est plus fiable avec un redémarrage complet.

#Exigence de game build

Certaines cartes utilisent des props ou des modèles d'un DLC GTA V plus nouveau. Sur le game build par défaut, ces props manquent : vous voyez des pièces vides, une boîte blanche ou pas d'intérieur du tout. La page du pack dit généralement le build dont il a besoin. Définissez-le dans server.cfg et redémarrez :

set sv_enforceGameBuild 3095

Le nombre ci-dessus n'est qu'un exemple : utilisez celui que le pack demande. La liste complète et les effets secondaires sont dans sv_enforceGameBuild et DLC.

#Testez-le dans le jeu

1. Lisez la console txAdmin au démarrage. Les erreurs comme un fichier manquant dans data_file s'affichent là. Si la resource ne démarre pas, voir couldn't start resource.
2. Rejoignez le serveur. Allez aux coordonnées dans le readme du pack, avec le menu de téléportation de txAdmin ou une commande de coordonnées de votre script admin.
3. Marchez à travers la porte. Un intérieur personnalisé se charge souvent que quand vous êtes proche, donc arrivez à pied et pas de loin à grande vitesse.
4. Vérifiez le sol et les murs. Si vous tombez ou traversez, les fichiers .ybn manquent ou n'ont pas chargé. Voir chute à travers la carte.

#Problèmes courants

• L'intérieur n'apparaît pas. La resource n'est pas démarrée, les coordonnées sont fausses, ou un game build plus nouveau est nécessaire. Vérifiez aussi que les fichiers sont à l'intérieur de stream et pas un niveau plus profond dans un sous-dossier que la resource n'utilise pas.
• Les props manquent, mais les murs sont là. Le .ytyp n'est pas enregistré. Ajoutez la ligne DLC_ITYP_REQUEST, avec le bon nom de fichier.
• Partie de la pièce scintille ou les murs ont disparu. Une autre carte couvre la même zone. Voir conflits de carte.
• Les textures semblent fausses ou lourdes. Les grandes textures coûtent la mémoire de streaming. Voir assets surdimensionnés.
• Cela a fonctionné, puis a cassé après une mise à jour. Effacez le cache client et réessayez : effacez le cache FiveM.

#De nombreuses cartes sur un serveur

Chaque carte ajoute des fichiers en streaming que chaque joueur télécharge et garde en mémoire. N'installez que les cartes que vous utilisez, mettez chacune dans sa propre resource et nommez-la clairement. Quand quelque chose casse, vous pouvez arrêter une resource à la fois et trouver la cause.

#Liste de contrôle