Guide d'Ajout de Mappings sur Serveur FiveM
Published on November 11, 2025 at 03:10 PM
Ce guide vous accompagne dans l'ajout et la gestion de mappings (cartes personnalisées) sur votre serveur FiveM
# Guide d'Ajout de Mappings sur Serveur FiveM
**Accès à votre panel Wisp** : [https://panel.verycloud.fr/](https://panel.verycloud.fr/)
**Documentation complète** : [https://verycloud.fr/docs](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/](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 :
```lua
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 :
```lua
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/](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 :
```bash
ensure nom-du-mapping
```
**Exemple** :
```bash
# 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 :
```bash
# 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 :
```lua
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 `#` :
```bash
# 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 :
```lua
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` :
```lua
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
```lua
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 :
```lua
-- 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
```bash
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](https://verycloud.fr/docs)
**Panel Wisp** : [https://panel.verycloud.fr/](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 !**