Guide d'Ajout de Mappings sur Serveur FiveM

Accès à votre panel Wisp : https://panel.verycloud.fr/

Documentation complète : https://verycloud.fr/docs

Qu'est-ce qu'un Mapping ?

Un mapping (ou map) est une modification de l'environnement du jeu qui permet d'ajouter :

• Des bâtiments personnalisés
• Des modifications de lieux existants
• De nouveaux intérieurs
• Des objets et décors
• Des zones personnalisées

Prérequis

Avant de commencer, assurez-vous d'avoir :

• Accès à votre panel Wisp VeryCloud
• Vos identifiants de connexion
• Le mapping que vous souhaitez installer (format .zip ou dossier)
• Un client FTP (FileZilla recommandé) ou utilisation du gestionnaire de fichiers Wisp
• Votre serveur FiveM arrêté pendant l'installation

Étape 1 : Connexion au Panel Wisp

1. Rendez-vous sur https://panel.verycloud.fr/
2. Connectez-vous avec vos identifiants VeryCloud
3. Sélectionnez votre serveur FiveM dans la liste
4. Vous arrivez sur le tableau de bord de votre serveur

Étape 2 : Types de Mappings FiveM

Il existe plusieurs types de mappings :

Mappings Standalone (recommandé)

Fichiers nécessaires :

• __resource.lua ou fxmanifest.lua
• Dossier stream/ contenant les fichiers .ymap, .ytyp, .ybn
• Parfois un dossier data/ avec des fichiers .meta

Mappings MLO (Interior)

Pour les intérieurs :

• Fichiers .ymap pour la structure
• Fichiers .ytyp pour les objets
• Fichiers .ybn pour les collisions
• Dossier stream/

Mappings Add-On

Plus complexes :

• Nécessitent parfois des modifications de server.cfg
• Peuvent inclure des scripts
• Fichiers dans stream/ et configurations spécifiques

Étape 3 : Préparation du Mapping

Vérification du contenu

Avant l'installation, vérifiez que votre mapping contient :

1. Fichier manifest (obligatoire) :
   • __resource.lua (ancienne version)
   • OU fxmanifest.lua (nouvelle version recommandée)
2. Dossier stream (obligatoire) :
   • Contient les fichiers .ymap, .ytyp, .ybn, .ytd, .ydr
3. Structure recommandée :

nom-du-mapping/
├── fxmanifest.lua
├── stream/
│   ├── fichier1.ymap
│   ├── fichier2.ytyp
│   └── fichier3.ybn
└── data/ (optionnel)
    └── fichier.meta

Exemple de fxmanifest.lua

Si votre mapping n'a pas de manifest, créez-en un :

fx_version 'cerulean'
game 'gta5'

author 'Votre Nom'
description 'Description du mapping'
version '1.0.0'

this_is_a_map 'yes'

files {
    'data/*.meta'
}

data_file 'DLC_ITYP_REQUEST' 'data/*.ytyp'

Pour un mapping simple sans fichiers data :

fx_version 'cerulean'
game 'gta5'

author 'Votre Nom'
description 'Description du mapping'
version '1.0.0'

this_is_a_map 'yes'

Étape 4 : Méthode 1 - Upload via Gestionnaire de Fichiers Wisp

Accès au gestionnaire de fichiers

1. Dans votre panel Wisp, cliquez sur Files (Fichiers) dans le menu de gauche
2. Vous verrez l'arborescence de votre serveur FiveM
3. Naviguez vers le dossier resources

Upload du mapping

1. Dans le dossier resources, cliquez sur Upload (en haut à droite)
2. Deux options s'offrent à vous :

Option A : Upload d'un fichier ZIP

• Sélectionnez votre fichier .zip du mapping
• Cliquez sur Upload
• Attendez la fin de l'upload (barre de progression)
• Une fois uploadé, faites un clic droit sur le fichier .zip
• Sélectionnez Unarchive (Décompresser)
• Le dossier sera extrait automatiquement
• Supprimez le fichier .zip après extraction

Option B : Upload dossier par dossier

• Créez un nouveau dossier avec le nom de votre mapping
• Entrez dans ce dossier
• Uploadez les fichiers un par un (manifest, puis dossier stream)

Vérification de la structure

Assurez-vous que la structure finale est :

resources/
└── [votre-mapping]/
    ├── fxmanifest.lua
    └── stream/
        ├── fichiers.ymap
        └── autres fichiers...

Étape 5 : Méthode 2 - Upload via FTP

Configuration du client FTP

1. Téléchargez FileZilla : https://filezilla-project.org/
2. Dans le panel Wisp, allez dans Settings > SFTP Details
3. Notez les informations :
   • Adresse : L'URL du serveur SFTP
   • Port : Généralement 2022
   • Nom d'utilisateur : Votre identifiant SFTP
   • Mot de passe : Votre mot de passe SFTP

Connexion FTP

1. Ouvrez FileZilla
2. Remplissez les champs en haut :
   • Hôte : L'adresse SFTP (ex: sftp://panel.verycloud.fr)
   • Identifiant : Votre nom d'utilisateur
   • Mot de passe : Votre mot de passe
   • Port : 2022
3. Cliquez sur Connexion rapide
4. Si une alerte de certificat apparaît, cochez "Toujours faire confiance" et validez

Upload du mapping via FTP

1. Dans FileZilla, côté serveur (droite), naviguez vers le dossier resources
2. Côté local (gauche), localisez votre dossier de mapping
3. Faites glisser le dossier complet du mapping depuis la gauche vers la droite
4. Attendez la fin du transfert (barre de progression en bas)
5. Vérifiez que tous les fichiers sont présents côté serveur

Étape 6 : Activation du Mapping dans server.cfg

Accès au fichier server.cfg

Via le panel Wisp :

1. Dans le menu de gauche, cliquez sur Files
2. Localisez et cliquez sur le fichier server.cfg
3. Le fichier s'ouvre dans l'éditeur intégré

Ajout de la ressource

1. Scrollez jusqu'à la section des ressources (généralement en bas du fichier)
2. Ajoutez la ligne suivante :

ensure nom-du-mapping

Exemple :

# Mappings
ensure mon-garage-custom
ensure villa-luxe
ensure commissariat-lspd

Note : Remplacez nom-du-mapping par le nom exact du dossier dans resources/

Différence entre ensure et start

• ensure : Démarre la ressource et la redémarre automatiquement si elle crash (recommandé)
• start : Démarre la ressource une seule fois

Pour les mappings, utilisez toujours ensure.

Ordre de chargement

Important : L'ordre des ressources dans server.cfg peut être important.

Recommandations :

1. Chargez d'abord les ressources de base (framework, scripts)
2. Ensuite les mappings
3. Puis les scripts qui dépendent des mappings

Exemple d'ordre correct :

# Framework
ensure es_extended
ensure esx_skin

# Mappings
ensure mapping-commissariat
ensure mapping-hopital

# Scripts
ensure esx_policejob
ensure esx_ambulancejob

Étape 7 : Démarrage du Serveur

Via le panel Wisp

1. Retournez sur le Console dans le menu de gauche
2. Cliquez sur le bouton Start (Démarrer)
3. Attendez que le serveur démarre complètement
4. Surveillez la console pour vérifier le chargement des ressources

Vérification du chargement

Dans la console, vous devriez voir :

Started resource nom-du-mapping

Si vous voyez une erreur, lisez attentivement le message pour identifier le problème.

Étape 8 : Vérification In-Game

Connexion au serveur

1. Lancez FiveM
2. Connectez-vous à votre serveur
3. Rendez-vous aux coordonnées du mapping

Utilisation de téléportation

Si vous êtes admin, utilisez la commande de téléportation :

/tp X Y Z

Remplacez X, Y, Z par les coordonnées du mapping (généralement indiquées dans la description).

Vérification visuelle

Vérifiez que :

• Les bâtiments apparaissent correctement
• Les textures sont chargées
• Les collisions fonctionnent (vous ne traversez pas les murs)
• Les portes s'ouvrent si applicable
• L'intérieur est accessible

Étape 9 : Gestion des Problèmes Courants

Le mapping n'apparaît pas

Solutions :

1. Vérifiez le manifest :
   • Assurez-vous que fxmanifest.lua ou __resource.lua existe
   • Vérifiez la ligne this_is_a_map 'yes'
2. Vérifiez le dossier stream :
   • Le dossier doit s'appeler exactement stream
   • Les fichiers doivent être directement dans stream/, pas dans un sous-dossier
3. Vérifiez server.cfg :
   • La ligne ensure nom-mapping est présente
   • Le nom correspond exactement au nom du dossier
   • Pas d'erreur de syntaxe (# pour les commentaires)
4. Vérifiez les permissions :
   • Dans le panel Wisp, vérifiez que les fichiers ont les bonnes permissions
5. Redémarrez le serveur :
   • Arrêtez complètement le serveur
   • Attendez 10 secondes
   • Redémarrez

Le mapping apparaît mais avec des textures manquantes

Solutions :

1. Vérifiez les fichiers .ytd :
   • Ces fichiers contiennent les textures
   • Doivent être dans le dossier stream/
2. Cache FiveM :
   • Fermez FiveM complètement
   • Allez dans %localappdata%\FiveM\FiveM Application Data
   • Supprimez le dossier cache
   • Relancez FiveM
3. Fichiers corrompus :
   • Re-téléchargez le mapping
   • Re-uploadez tous les fichiers

Le serveur ne démarre pas après ajout du mapping

Solutions :

1. Vérifiez la console :
   • Lisez attentivement les messages d'erreur
   • Recherchez le nom du mapping dans les erreurs
2. Erreur de manifest :
   • Vérifiez la syntaxe du fxmanifest.lua
   • Pas de caractères spéciaux
   • Guillemets corrects
3. Conflit avec d'autres ressources :
   • Désactivez temporairement d'autres mappings
   • Testez un par un pour identifier le conflit
4. Espace disque :
   • Vérifiez que vous avez assez d'espace
   • Panel Wisp > Settings > Storage

Collisions ne fonctionnent pas

Solutions :

1. Fichiers .ybn manquants :
   • Ces fichiers définissent les collisions
   • Doivent être dans stream/
2. Cache client :
   • Videz le cache FiveM (voir ci-dessus)
3. Mapping incompatible :
   • Certains vieux mappings n'ont pas de collisions
   • Recherchez une version mise à jour

Erreur "Failed to start resource"

Solutions :

1. Nom de dossier incorrect :
   • Pas d'espaces dans le nom
   • Pas de caractères spéciaux
   • Utilisez des tirets - ou underscores _
2. Structure incorrecte :
   • Vérifiez que le manifest est à la racine du dossier
   • Le dossier stream/ est au bon endroit
3. Permissions de fichiers :
   • Via Wisp, vérifiez les permissions
   • Elles doivent être en lecture/écriture

Étape 10 : Optimisation des Mappings

Limiter le nombre de mappings

• Trop de mappings = performances réduites
• Maximum recommandé : 20-30 mappings moyens
• Privilégiez la qualité à la quantité

Compression des textures

Certains mappings ont des textures très lourdes :

• Utilisez des outils comme OpenIV pour optimiser
• Réduisez la résolution si possible

Ordre de priorité

Dans server.cfg, chargez en priorité :

1. Les mappings essentiels (commissariat, hôpital)
2. Les mappings RP importants
3. Les mappings décoratifs en dernier

Streaming Distance

Dans certains manifests, vous pouvez définir la distance de chargement :

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

distance 500.0  -- Distance en mètres

Réduisez cette valeur pour améliorer les performances.

Étape 11 : Suppression d'un Mapping

Via le panel Wisp

1. Allez dans Files > resources
2. Localisez le dossier du mapping à supprimer
3. Faites un clic droit sur le dossier
4. Sélectionnez Delete (Supprimer)
5. Confirmez la suppression

Retrait du server.cfg

1. Ouvrez le fichier server.cfg
2. Trouvez la ligne ensure nom-du-mapping
3. Supprimez cette ligne ou commentez-la avec # :

# ensure mapping-a-supprimer

4. Sauvegardez le fichier
5. Redémarrez le serveur

Étape 12 : Création d'un Manifest Personnalisé

Si votre mapping n'a pas de manifest, créez-en un :

Pour un mapping simple

1. Dans le dossier du mapping, créez un nouveau fichier
2. Nommez-le fxmanifest.lua
3. Ajoutez ce contenu :

fx_version 'cerulean'
game 'gta5'

author 'VotreNom'
description 'Description du mapping'
version '1.0.0'

this_is_a_map 'yes'

Pour un mapping avec fichiers .meta

Si votre mapping a un dossier data/ avec des fichiers .meta :

fx_version 'cerulean'
game 'gta5'

author 'VotreNom'
description 'Description du mapping'
version '1.0.0'

this_is_a_map 'yes'

files {
    'data/*.meta'
}

-- Pour les fichiers ytyp
data_file 'DLC_ITYP_REQUEST' 'data/*.ytyp'

-- Pour les fichiers ymf (si présents)
data_file 'TIMECYCLEMOD_FILE' 'data/*.ymf'

Sauvegarde du manifest

1. Sauvegardez le fichier
2. Uploadez-le via le panel Wisp ou FTP
3. Redémarrez le serveur

Étape 13 : Mappings MLO (Intérieurs)

Les MLO sont des mappings d'intérieur spéciaux.

Structure typique d'un MLO

mlo-interieur/
├── fxmanifest.lua
└── stream/
    ├── interieur.ymap
    ├── interieur.ytyp
    ├── interieur_shell.ybn
    └── textures.ytd

Manifest pour MLO

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

files {
    'stream/*.ytyp'
}

data_file 'DLC_ITYP_REQUEST' 'stream/*.ytyp'

Points d'entrée

Certains MLO nécessitent des scripts pour définir les points d'entrée :

• Vérifiez la documentation du MLO
• Installez les scripts fournis si nécessaire

Étape 14 : Coordination avec d'Autres Ressources

Scripts dépendants de mappings

Certains scripts nécessitent des mappings spécifiques :

• esx_policejob → Commissariat LSPD
• esx_ambulancejob → Hôpital Pillbox
• esx_mechanicjob → Garage Bennys

Configuration des coordonnées

Après installation d'un mapping, mettez à jour les coordonnées dans vos scripts :

Exemple pour un garage :

-- Config du script
Config.Zones = {
    GarageVehicle = {
        Pos   = {x = 215.124, y = -810.057, z = 30.731},
        Size  = {x = 1.5, y = 1.5, z = 1.0},
        Type  = 27
    }
}

Ordre de chargement

Dans server.cfg, assurez-vous de :

1. Charger le mapping en premier
2. Charger le script qui l'utilise ensuite

ensure mapping-commissariat
ensure esx_policejob

Étape 15 : Sources de Mappings

Sites recommandés

Gratuits :

• GTA5-Mods : https://www.gta5-mods.com/maps
• FiveM Forums : https://forum.cfx.re/
• Discord GTA Modding : Recherchez des serveurs dédiés

Payants :

• Tebex : https://www.tebex.io/
• GTA5mods Premium : Mappings de qualité supérieure

Vérification de la qualité

Avant d'installer un mapping :

• Lisez les commentaires et avis
• Vérifiez la date de mise à jour
• Assurez-vous qu'il est compatible FiveM
• Regardez les vidéos/captures d'écran

Droits et licences

• Respectez les licences des créateurs
• Ne redistribuez pas sans permission
• Créditez les auteurs dans votre serveur

Étape 16 : Sauvegarde de Vos Mappings

Sauvegarde via panel Wisp

1. Allez dans Files > resources
2. Sélectionnez le dossier du mapping
3. Cliquez sur Archive (Archiver)
4. Le fichier .tar.gz sera créé
5. Téléchargez-le sur votre PC

Sauvegarde via FTP

1. Connectez-vous avec FileZilla
2. Naviguez vers resources
3. Faites glisser le dossier du mapping vers votre PC (côté gauche)
4. Conservez une copie en sécurité

Fréquence des sauvegardes

Recommandations :

• Avant chaque modification importante
• Après chaque ajout de mapping
• Au minimum une fois par semaine

Étape 17 : Mise à Jour d'un Mapping

Processus de mise à jour

1. Sauvegardez l'ancienne version :
   • Téléchargez le dossier actuel
   • Conservez une copie
2. Arrêtez le serveur :
   • Via le panel Wisp, cliquez sur Stop
3. Supprimez l'ancienne version :
   • Dans Files, supprimez le dossier du mapping
4. Uploadez la nouvelle version :
   • Suivez les étapes d'installation (Étape 4 ou 5)
5. Vérifiez le server.cfg :
   • Assurez-vous que la ligne ensure est toujours présente
   • Vérifiez que le nom du dossier n'a pas changé
6. Redémarrez le serveur :
   • Cliquez sur Start
7. Testez in-game :
   • Vérifiez que tout fonctionne

En cas de problème

Si la nouvelle version ne fonctionne pas :

1. Arrêtez le serveur
2. Supprimez la nouvelle version
3. Ré-uploadez votre sauvegarde
4. Redémarrez le serveur

Support VeryCloud

Si vous rencontrez des difficultés :

Documentation : https://verycloud.fr/docs

Panel Wisp : https://panel.verycloud.fr/

Support technique :

• Ouvrez un ticket depuis votre espace client VeryCloud
• Contactez le support par Discord ou email
• Consultez la base de connaissances

Lorsque vous contactez le support, fournissez :

• Votre nom de serveur
• Le nom du mapping concerné
• Une description détaillée du problème
• Les captures d'écran des erreurs
• Les logs de la console (si applicable)

Bonnes Pratiques

Organisation

• Nommage cohérent : Utilisez des noms clairs (ex: mapping-lspd-v2)
• Documentation : Gardez une liste de vos mappings avec leurs sources
• Catégorisation : Organisez vos mappings par type (jobs, maisons, commerces)

Performance

• Testez un par un : Ajoutez les mappings progressivement
• Surveillez les FPS : Vérifiez l'impact sur les performances
• Nettoyage régulier : Supprimez les mappings inutilisés

Compatibilité

• Framework : Assurez-vous que les mappings sont compatibles avec votre framework (ESX, QBCore, etc.)
• Versions : Vérifiez la compatibilité avec votre version de FiveM
• Conflits : Testez les interactions entre mappings

Sécurité

• Sources fiables : Téléchargez uniquement depuis des sites reconnus
• Scan antivirus : Vérifiez les fichiers avant upload
• Sauvegarde : Gardez toujours des copies de vos configurations

Ressources Complémentaires

Outils utiles

• OpenIV : Pour visualiser et éditer les fichiers .ymap/.ytyp
• CodeWalker : Pour trouver les coordonnées et explorer les mappings
• FiveM Native Reference : Documentation des fonctions FiveM

Communauté FiveM

• Forum officiel : https://forum.cfx.re/
• Discord FiveM France : Recherchez des serveurs francophones
• YouTube : Tutoriels vidéo sur les mappings

Apprentissage

Si vous souhaitez créer vos propres mappings :

• Apprenez à utiliser OpenIV
• Suivez des tutoriels de modding GTA V
• Pratiquez avec des mappings simples

Conclusion

Vous savez maintenant comment ajouter, gérer et optimiser les mappings sur votre serveur FiveM hébergé chez VeryCloud via le panel Wisp !

Récapitulatif des étapes clés :

1. Téléchargez votre mapping
2. Uploadez-le dans resources/ via Wisp ou FTP
3. Ajoutez ensure nom-mapping dans server.cfg
4. Redémarrez le serveur
5. Testez in-game

Points à retenir :

• Vérifiez toujours la structure du mapping (manifest + stream)
• Sauvegardez avant toute modification
• Testez les performances après chaque ajout
• Consultez la documentation du mapping

Bienvenue dans l'univers du mapping FiveM et profitez de votre serveur personnalisé avec VeryCloud !