Installer et configurer vMenu sur votre serveur FiveM

Qu’est-ce que vMenu et à qui s’adresse-t-il ?

Installer vMenu FiveM permet d’ajouter un menu complet pour les joueurs et les administrateurs : apparition de véhicules, personnalisation du personnage, téléportation, gestion de la météo, réglage de l’heure et outils de modération.

vMenu est particulièrement adapté aux serveurs :

• freeroam ;
• fun ou sandbox ;
• de conduite et de présentation de véhicules ;
• privés entre amis ;
• consacrés aux événements ;
• sans économie ni progression RP complexe.

vMenu n’est pas un framework RP. Il ne fournit pas, à lui seul, de système complet de personnages, d’argent, de métiers, d’inventaire ou de véhicules possédés.

Pour construire un serveur RP structuré autour d’une économie et de métiers persistants, utilisez plutôt ESX ou QBCore. Consultez le guide ESX ou QBCore : quel framework choisir ? avant de commencer.

Besoin	Solution adaptée
Véhicules, apparence et téléportation libres	vMenu
Serveur freeroam entre amis	vMenu
Économie, métiers et inventaire persistants	ESX ou QBCore
Personnages enregistrés dans MySQL	ESX ou QBCore
Outils d’administration simples	vMenu ou txAdmin

Il est techniquement possible de faire fonctionner vMenu avec d’autres ressources, mais ses fonctions peuvent entrer en conflit avec un framework RP, un menu administrateur ou un système de personnages.

Télécharger vMenu depuis une source fiable

Téléchargez vMenu depuis le dépôt GitHub officiel de son développeur, dans la section consacrée aux versions publiées. Utilisez une release prête à l’emploi plutôt que l’archive du code source téléchargée avec le bouton générique de GitHub.

Une archive correcte doit contenir la ressource compilée et ses fichiers de configuration. Après extraction, vous devez retrouver une structure proche de celle-ci :

vMenu/
├── config/
│   ├── permissions.cfg
│   └── addons.json
├── vMenuClient.net.dll
├── vMenuServer.net.dll
└── fxmanifest.lua

Le contenu exact peut évoluer selon la version. Le point essentiel est que le dossier final contienne directement le manifeste et les fichiers nécessaires au fonctionnement de la ressource.

Évitez :

• les versions republiées sur des sites inconnus ;
• les forks modifiés sans documentation ;
• les packs « optimisés » dont le code a été altéré ;
• les archives qui contiennent plusieurs versions mélangées ;
• les fichiers présentés comme crackés ou leakés.

Une version modifiée peut ajouter des fonctions non documentées, créer des incompatibilités ou contenir du code malveillant.

Installer vMenu FiveM dans resources/

Arrêtez complètement votre serveur avant de modifier les ressources.

Des sauvegardes automatiques sont incluses pour vous aider à restaurer. Conservez aussi vos propres exports réguliers : vous restez responsable de vos données.

Décompressez l’archive sur votre ordinateur, puis envoyez le dossier vMenu dans le répertoire resources/ de votre serveur.

Vous pouvez le placer directement à la racine :

resources/
└── vMenu/
    ├── config/
    ├── fxmanifest.lua
    ├── vMenuClient.net.dll
    └── vMenuServer.net.dll

Vous pouvez également utiliser une catégorie :

resources/
└── [menus]/
    └── vMenu/
        ├── config/
        ├── fxmanifest.lua
        ├── vMenuClient.net.dll
        └── vMenuServer.net.dll

Vérifiez que fxmanifest.lua se trouve directement dans le dossier vMenu.

Cette structure est incorrecte :

resources/vMenu/vMenu/fxmanifest.lua

Cette structure est correcte :

resources/vMenu/fxmanifest.lua

Conservez le nom officiel vMenu. Sur un environnement Linux, la casse peut être importante : vmenu, VMenu et vMenu ne sont pas nécessairement interprétés comme le même dossier.

Pour revoir la procédure générale d’ajout d’une ressource, consultez le guide pour installer des scripts FiveM.

Ajouter vMenu dans server.cfg

Ouvrez votre fichier :

server.cfg

Vous devez d’abord exécuter le fichier de permissions, puis démarrer la ressource.

Si vMenu est placé directement dans resources/, utilisez :

exec resources/vMenu/config/permissions.cfg
ensure vMenu

Si vous avez déplacé permissions.cfg à côté de server.cfg, vous pouvez utiliser :

exec permissions.cfg
ensure vMenu

La ligne exec doit être placée avant ensure vMenu, afin que les variables de configuration et permissions ACE soient chargées avant le démarrage de la ressource.

Exemple :

# Configuration et permissions de vMenu
exec resources/vMenu/config/permissions.cfg

# Démarrage de vMenu
ensure vMenu

Enregistrez le fichier, puis redémarrez complètement FXServer depuis txAdmin.

Dans la console, recherchez un message confirmant le démarrage de la ressource :

Started resource vMenu

Pour surveiller le lancement, les erreurs et les ressources actives, consultez le guide pour démarrer avec txAdmin.

Comprendre les permissions ACE de vMenu

vMenu utilise les permissions ACE natives de FiveM. Elles déterminent qui peut ouvrir les sous-menus et utiliser chaque fonction.

Dans permissions.cfg, cette ligne active le système de permissions :

setr vmenu_use_permissions true

Ne la remplacez pas par false sans comprendre les conséquences. Lorsque les permissions sont ignorées, la majorité des fonctions non administratives peut devenir accessible à tous.

Deux directives sont essentielles :

add_ace
add_principal

add_ace accorde une permission à un groupe :

add_ace group.admin "vMenu.Everything" allow

add_principal ajoute un joueur à un groupe :

add_principal identifier.license:VOTRE_IDENTIFIANT group.admin

Exemple de configuration simple :

# Les joueurs peuvent ouvrir les options de personnage
add_ace builtin.everyone "vMenu.PlayerOptions.Menu" allow

# Les joueurs peuvent accéder aux options de véhicules
add_ace builtin.everyone "vMenu.VehicleOptions.Menu" allow

# Les joueurs peuvent utiliser le menu d'apparence
add_ace builtin.everyone "vMenu.PlayerAppearance.Menu" allow

# Les administrateurs obtiennent les fonctions complètes
add_ace group.admin "vMenu.Everything" allow

# Ajout d'un administrateur
add_principal identifier.license:VOTRE_IDENTIFIANT group.admin

Vous pouvez aussi créer un groupe de modération distinct :

add_ace group.moderator "vMenu.Staff" allow
add_ace group.moderator "vMenu.OnlinePlayers.Menu" allow
add_ace group.moderator "vMenu.OnlinePlayers.Kick" allow

add_principal identifier.license:IDENTIFIANT_MODERATEUR group.moderator

N’accordez pas vMenu.Everything à builtin.everyone. Tous les joueurs recevraient alors les fonctions les plus sensibles.

Les permissions ACE sont le socle de la sécurité du menu. Une mauvaise configuration peut donner à un joueur l’accès au bannissement, à la téléportation, au noclip ou à la gestion des autres membres.

Pour approfondir cette logique, consultez le guide consacré à la protection d’un serveur FiveM avec un anticheat.

Configurer les options de base de vMenu

Les principaux réglages se trouvent dans :

resources/vMenu/config/permissions.cfg

Vous pouvez y configurer les permissions ainsi que différentes variables générales.

La touche d’ouverture par défaut est généralement M :

setr vmenu_menu_toggle_key "M"

Cette valeur définit la touche initiale. Les joueurs peuvent ensuite retrouver ou modifier l’association dans les paramètres de touches de FiveM.

Vous pouvez rendre le menu accessible uniquement aux membres possédant la permission vMenu.Staff :

setr vmenu_menu_staff_only true

Pour un serveur freeroam ouvert à tous, conservez plutôt :

setr vmenu_menu_staff_only false

L’accès aux sous-menus reste ensuite contrôlé avec les permissions ACE.

Les catégories importantes comprennent notamment :

• options du joueur ;
• apparence du personnage ;
• options et apparition des véhicules ;
• armes ;
• téléportation ;
• météo ;
• heure ;
• joueurs connectés ;
• outils de modération.

Vous pouvez, par exemple, réserver la météo et l’heure aux modérateurs :

add_ace group.moderator "vMenu.TimeOptions.Menu" allow
add_ace group.moderator "vMenu.WeatherOptions.Menu" allow

Évitez d’activer immédiatement toutes les permissions. Commencez par les fonctions nécessaires, testez avec un compte joueur, puis élargissez progressivement les droits.

vMenu propose également des fonctions de bannissement et de journalisation. Vérifiez le chemin de la banlist et les paramètres correspondants avant d’ouvrir le serveur au public.

Dépanner vMenu

vMenu n’apparaît pas avec la touche M

Vérifiez que la ressource est démarrée :

ensure vMenu

Contrôlez ensuite la console :

Started resource vMenu

Le joueur peut aussi vérifier l’association de touche dans les paramètres FiveM. Une autre ressource peut déjà utiliser M.

Le menu s’ouvre, mais il est vide

Le fichier permissions.cfg n’est probablement pas exécuté ou aucune permission n’est accordée.

Vérifiez l’ordre :

exec resources/vMenu/config/permissions.cfg
ensure vMenu

Contrôlez aussi :

setr vmenu_use_permissions true

Avec les permissions activées, chaque sous-menu doit disposer d’un droit ACE adapté.

FXServer ne trouve pas la ressource

Vérifiez le nom exact du dossier :

resources/vMenu/

Puis la ligne :

ensure vMenu

Un décalage de casse peut empêcher le chargement.

vMenu entre en conflit avec un autre menu

Désactivez temporairement les autres menus d’administration, de téléportation, de météo ou d’apparence. Redémarrez ensuite pour déterminer quelle ressource provoque le conflit.

vMenu peut également modifier des fonctions déjà gérées par ESX, QBCore ou un script de personnages. Pour un serveur RP structuré, préférez les outils conçus pour votre framework.

En résumé

• Installer vMenu FiveM ajoute un menu joueur et administrateur adapté au freeroam.
• vMenu n’est pas un framework RP et ne remplace pas ESX ou QBCore.
• Téléchargez une release depuis le dépôt officiel, sans utiliser une version modifiée inconnue.
• Placez le dossier dans resources/ et vérifiez que fxmanifest.lua se trouve directement dans vMenu/.
• Conservez exactement la casse du dossier vMenu.
• Exécutez permissions.cfg avant de démarrer la ressource.
• Ajoutez ensure vMenu dans server.cfg.
• Activez le système ACE avec setr vmenu_use_permissions true.
• Utilisez add_ace pour accorder des fonctions et add_principal pour ajouter un joueur à un groupe.
• N’accordez jamais vMenu.Everything à tous les joueurs.
• Si le menu est vide, vérifiez d’abord les permissions ACE et la ligne exec.
• Pour installer vMenu FiveM sur une infrastructure hébergée en France avec panel de gestion, stockage NVMe, Anti-DDoS L3/L4/L7 inclus et support francophone, consultez l’offre serveur FiveM TalCloud.