Comment ajouter un MLO FiveM à votre serveur

Public: Propriétaires de serveurs et développeurs qui exploitent déjà une instance FiveM fonctionnelle et souhaitent l'étendre avec des ressources cartographiques intérieures/extérieures personnalisées (MLO).

1 · Prérequis

Exigence	Version minimale	Pourquoi c'est important
Artefact du serveur FiveM	6016 (build 7116) ou plus récent	Les artefacts plus anciens ne peuvent pas charger les artefacts modernes `azuré` manifestations fx.
Chargeur de carte (déjà intégré)	Natif par défaut	Aucun plugin supplémentaire n'est nécessaire.FiveM diffuse automatiquement les fichiers cartographiques.
Accès au serveur	SFTP/SSH + autorisations d'écriture	Vous devez télécharger des fichiers et les modifier serveur.cfg.
Licence légale	Preuve d'achat / Conditions d'utilisation gratuite	Le RGPD de l'UE et la politique de Rockstar interdisent la distribution d'actifs sans licence.

2 · Téléchargez et inspectez le package MLO

Intégrité de la source – Privilégiez les fournisseurs avec des zips signés SHA-256 ou des balises Git publiques.
Vérifier la structure – Une ressource conforme ressemble à :

my-mlo\/
 ├─ stream\/
 │ ├─ *.ydr ↰ (modèles)
 │ ├─ *.ytyp ↰ (définitions d'objets)
 │ ├─ *.ybn ↰ (collisions‑―si fournies)
 │ └─ *.ytd ↰ (textures)
 ├─ fxmanifest.lua
 └─ README.md (facultatif)

Créer fxmanifest.lua si manquant – Modèle minimal :

fx_version 'cerulean'
games { 'gta5' }

author 'YourName'
description 'Mon Custom MLO'
version '1.0.0'

this_is_a_map 'yes'

files {
 'stream\/**\/*.ydr',
 'stream\/**\/*.ytyp',
 'stream\/**\/*.ytd',
 'stream\/**\/*.ybn'
}

data_file 'DLC_ITYP_REQUEST' 'stream\/**\/*.ytyp'

ℹ️ Les manifestes de ressources standard suivent le schéma dans Documentation FiveM → « Manifeste de ressources » (commit 20b7b15, 2025‑03‑11)

3 · Télécharger la ressource

Connectez-vous via SFTP à la racine de votre serveur.
Accéder à /ressources/[cartes]/—créer le dossier bracket s’il n’existe pas.
Téléchargez l'intégralité mon-mlo annuaire inchangéÉvitez les espaces et les majuscules dans les noms de dossiers pour éviter les problèmes de chemin Linux.

4 · S'inscrire dans `serveur.cfg`

Ajouter (ou remplacer commencer) après ressources de base essentielles :

assurez-vous que my-mlo # se charge au démarrage ; redémarre automatiquement lors des redémarrages doux de txAdmin

Enregistrez le fichier et redémarrage le serveur ou exécuter rafraîchir ➜ assurer mon-mlo dans la console en direct.

5 · Vider le cache et redémarrer (si nécessaire)

FiveM met en cache les données cartographiques. Pour éviter les oublis d'anciennes versions :

# Linux
rm -rf cache/*
./run.sh +exec server.cfg

# Windows (PowerShell)
Remove-Item -Recurse -Force .cache*
run.cmd +exec server.cfg

Comment vider le cache des serveurs FiveM

6 · Liste de contrôle de vérification en jeu

Vérifier	Commande/outil	Critères de réussite
Téléportation	vMenu → Divers → Téléportation → Entrer les coordonnées	Le joueur apparaît dans le nouvel intérieur/extérieur.
Intégrité de la texture	`cadre_profil` puis se promener	Pas d'espaces réservés rose/blanc ; perte de FPS < 10%.
Collision	Murs de promenade et rampes	Aucune barrière invisible ni chute à travers le sol.
Éclairage	Changement de cycle temporel avec `/heure 23 0`	L'intérieur s'assombrit/s'éclaircit correctement sans artefacts.

Si des échecs surviennent, revisitez la liste des fichiers manquants .cumul à ce jour ou .ybn est le coupable habituel.

7 · Streaming sécurisé de plusieurs MLO

Une ressource par MLOCela évite les collisions de hachage.
Préfixer les noms avec l'étiquette du fournisseur, par exemple bh-bank-lobby, pour une désactivation plus facile.
Utilisez une version de manifeste identique sur toutes les ressources de carte pour éviter les avertissements d'analyse.

8 · Dépannage - Aide-mémoire rapide

Symptôme	Cause probable	Résolution
Console: Impossible d'analyser le manifeste	Mauvaise syntaxe Lua	Courir `lua -p fxmanifest.lua` localement ; corriger les guillemets/virgules.
MLO visible, textures manquantes	`.cumul à ce jour` fichiers non référencés	Ajoutez-les à `fichiers{}` ou placer dans `flux/`.
Les joueurs plantent lors de la connexion	Dupliquer le hachage d'accessoires sur plusieurs cartes	Renommer le doublon `.ydr` ou décharger des ressources conflictuelles.
Temps de téléchargement long	Grand `.cumul à ce jour` textures	Compressez les textures (DXT5 / BC3) ou réduisez-les.

9 · Notes sur la conformité et la protection des données

Réglementation / Politique	Ce que vous devez faire
Politique de modding de Rockstar (2015-09-15)	Ne vendez pas d'actifs contenant la propriété intellectuelle de Rockstar.
RGPD UE Art. 44-49	Stocker les factures des fournisseurs ; divulguer l'origine des actifs à la demande de l'utilisateur.
Conditions d'utilisation de FiveM §3.2	Gardez les crédits intacts ; ne redistribuez pas publiquement les mods payants.

Conclusion

Télécharger → assurer → redémarrer ; si le manifeste est valide, votre nouvel intérieur est opérationnel dans les deux minutes.

Besoin de nouveaux MLO ?

Sources

FiveM Docs – Manifestes de ressources (consulté le 22 mai 2025)
Rockstar Games – Politique de modding, 15 septembre 2015
Règlement (UE) 2016/679 (RGPD), articles 44 à 49

Liste de contrôle pratique

Utilisez ce guide comme liste de vérification avant de modifier un serveur FiveM en production. Assurez-vous de la version actuelle des artefacts serveur, de la version du framework, des dépendances des ressources, des modifications de la base de données et des fichiers côté client avant d'appliquer la modification.

Sauvegardez les fichiers de configuration et les tables de base de données concernés.
Appliquez d'abord la modification sur un serveur de test.
Surveillez la console du serveur et la console F8 du client pour détecter les erreurs.
Vérifiez si la modification affecte les emplois, l'inventaire, les véhicules, les cartes, la voix, les autorisations ou les données des joueurs.
Documentez précisément le fichier, la commande ou le paramètre que vous avez modifié afin de pouvoir le rétablir rapidement.

Tests avant production

Après le premier test, connectez-vous avec un compte joueur standard et répétez le processus du point de vue du joueur. Si le sujet concerne les performances, effectuez des mesures avant et après en conservant le même nombre de joueurs, le même parcours et les mêmes ressources. Si le sujet concerne les outils d'administration ou les permissions, vérifiez les utilisateurs autorisés et ceux qui n'y sont pas autorisés.

Erreurs courantes

La plupart des problèmes rencontrés avec FiveM proviennent de dépendances manquantes, d'un cache obsolète, de noms de dossiers incorrects, d'incompatibilités de frameworks ou d'une configuration copiée depuis un autre serveur. Évitez de modifier plusieurs systèmes simultanément ; effectuez une modification, testez-la, puis poursuivez.

Ressources connexes

Pour les ressources prêtes à la production, comparez les ressources payantes dans le Boutique FiveMX. Pour accéder à des ressources gratuites, consultez Scripts FiveM gratuits et tester chaque ressource avant de l'utiliser publiquement.

Notes de déploiement de la production

Avant d'utiliser ce guide sur un serveur FiveM en production, définissez le résultat exact attendu de la modification. Pour Comment Ajouter un FiveM MLO à Votre Serveur, cela signifie vérifier quelle ressource, paramètre, commande ou workflow est concerné et confirmer que la modification correspond à votre framework actuel, version d'artifact et règles du serveur. Gardez le déploiement suffisamment limité pour pouvoir l'annuler rapidement si les joueurs signalent des erreurs.

Utilisez un serveur de test avec la même infrastructure, le même schéma de base de données, le même ordre de ressources et les mêmes dépendances clés que le serveur de production. Si le sujet abordé modifie le gameplay, les permissions, les graphismes, le doublage, les véhicules, les cartes, l'inventaire ou le comportement économique, effectuez des tests avec au moins un compte administrateur et un compte joueur. Surveillez la sortie de la console du serveur, les journaux F8 du client et le temps d'accès aux ressources tout en reproduisant exactement le parcours de jeu qui se déroulera sur le serveur de production.

Liste de contrôle de restauration

Sauvegardez le fichier de configuration précédent, le dossier de ressources et l'état de la base de données avant toute modification.
Notez la version de la ressource, le commit, la page de téléchargement ou la valeur du paramètre que vous avez testée.
Redémarrez d'abord uniquement la ressource concernée lorsque cela est possible, puis redémarrez le serveur complet si des dépendances l'exigent.
En cas d'erreur, rétablissez la ressource ou le paramètre modifié avant de tester une autre solution.

Conseils d'entretien

Revérifiez cette configuration après chaque mise à jour des artefacts FiveM, du framework ou modification importante des ressources. Une configuration fonctionnelle aujourd'hui peut devenir inutilisable suite à des mises à jour de dépendances, des modifications d'exports, des changements d'événements ou des migrations de base de données. Conservez des notes dans la documentation de votre serveur afin que les futurs administrateurs comprennent les modifications apportées, leurs raisons et comment les reproduire.

Examen en cours

Revérifiez comment ajouter un FiveM MLO à votre serveur après des mises à jour majeures de l'artefact FiveM, des changements de framework ou des migrations de ressources. Confirmez que les conseils correspondent toujours au comportement actuel du serveur, que toute source liée reste disponible et que les étapes d'installation correspondent toujours aux fichiers qu'un propriétaire de serveur téléchargera ou configurera réellement.

Pour les serveurs publics, conservez un bref historique des modifications à côté de la documentation du serveur. Indiquez ce qui a été testé, ce qui a changé, les comptes utilisés pour la vérification et la procédure de retour en arrière. Cela facilitera la maintenance future et évitera que les anciennes notes de configuration ne deviennent obscures ou dangereuses pour les joueurs.