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'éléments) │ ├─ *.ybn ↰ (collisions‑―si fourni) │ └─ *.ytd ↰ (textures) ├─ fxmanifest.lua └─ README.md (facultatif)

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

fx_version 'cerulean' jeux { 'gta5' } auteur 'VotreNom' description 'Mon MLO personnalisé' version '1.0.0' this_is_a_map 'oui' fichiers { 'stream/**/*.ydr', 'stream/**/*.ytyp', 'stream/**/*.ytd', 'stream/**/*.ybn' } fichier_de_données '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 progressifs 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.