Installation sur FiveM Legacy

Cette page concerne le FiveM classique, basé sur le GTA V d'origine, que nous appelons FiveM Legacy. Vous utilisez FiveM Enhanced ? Alors consultez plutôt Installation sur FiveM Enhanced. vMenu Enhanced offre exactement les mêmes menus et fonctionnalités sur les deux.

Avant de commencerCopy Anchor Link

• Ce n'est pas le vMenu d'origine. Il a ses propres noms de permissions et ne lit rien de ce que le vMenu d'origine a enregistré. Ne faites jamais tourner les deux en même temps. Le vMenu d'origine, v3.9.2 et antérieures, n'est plus mis à jour, mais sa documentation reste disponible ici.
• Gardez les artefacts de votre serveur à jour. vMenu envoie des éléments comme les vérifications de mise à jour et les webhooks via un petit utilitaire Node.js, qui nécessite la version 22 de Node.js fournie avec les artefacts actuels. Si votre console indique que le net bridge n'a jamais répondu, mettez à jour vos artefacts.

La méthode rapide, avec txAdminCopy Anchor Link

txAdmin est le panneau de contrôle fourni avec chaque serveur FiveM. Ses « recettes » configurent un serveur complet à votre place. La recette vMenu vous donne vMenu Enhanced, des permissions et réglages prêts à l'emploi, ainsi que les plugins routing buckets, theme picker et custom themes. L'administrateur que vous configurez dans txAdmin peut utiliser tout le menu immédiatement.

Choisissez la recette vMenu dans l'écran de configuration de txAdmin. Si elle n'est pas listée, choisissez « Remote URL Template » et collez ce lien, qui pointe toujours vers la dernière version :

https://github.com/TomGrobbe/vMenu/releases/latest/download/txadmin-vmenu-legacy-recipe.yaml

Et c'est tout, vous pouvez ignorer le reste de cette page. Le server.cfg que txAdmin génère pour vous explique comment configurer les permissions des plugins.

La méthode manuelleCopy Anchor Link

1. Téléchargez et décompressezCopy Anchor Link

Téléchargez vMenu-Enhanced-Legacy-v<version>.zip depuis la dernière version et décompressez-le dans votre dossier resources. Seul le zip qui contient « Legacy » dans son nom fonctionne ici. L'autre refuse de démarrer et vous l'indique dans la console.

2. Ajoutez les premières lignes à votre server.cfgCopy Anchor Link

exec @vMenu.Enhanced/config/permissions.cfg
exec @vMenu.Enhanced/config/configuration.cfg
add_filesystem_permission vMenu.Enhanced write vMenu.Enhanced
ensure vMenu.Enhanced

Les deux lignes exec chargent vos permissions et réglages, que vous créez à l'étape suivante. La ligne add_filesystem_permission permet à vMenu d'écrire dans son propre dossier. Ces trois lignes doivent venir avant ensure, sinon personne ne peut ouvrir le menu et vMenu ne peut rien enregistrer.

Vous utilisez une intégration avec synchronisation des rôles, où c'est votre intégration qui décide de l'appartenance à chaque groupe de permissions ? Dans ce cas, vMenu a aussi besoin de ces deux lignes, que le permissions.cfg d'exemple contient déjà en haut :

add_ace resource.vMenu.Enhanced command.add_principal allow
add_ace resource.vMenu.Enhanced command.remove_principal allow

3. Créez vos fichiers de permissions et de réglagesCopy Anchor Link

Ouvrez resources/vMenu.Enhanced/config/. Copiez permissions.cfg.example et configuration.cfg.example, puis retirez .example du nom des copies. Modifiez ensuite les copies :

• permissions.cfg décide qui peut utiliser quelle partie du menu. Il utilise les permissions « ace », la façon dont FiveM exprime « ce joueur ou ce groupe est autorisé à faire ceci ».
• configuration.cfg décide du comportement de vMenu et de ce qui est activé.

vMenu ne modifie jamais vos copies. Les fichiers .example sont réécrits à chaque démarrage de vMenu, ils listent donc toujours toutes les permissions et tous les réglages existants. Garder vos copies à jour vous incombe : après chaque mise à jour de vMenu, consultez le journal des modifications ou comparez vos copies avec les fichiers .example, et ajoutez vous-même les nouvelles permissions ou nouveaux réglages que vous souhaitez.

Vous jouez juste entre amis ? Cette unique ligne dans permissions.cfg suffit pour démarrer :

add_ace builtin.everyone "vMenu.Enhanced.Everything" allow

C'est terminéCopy Anchor Link

Redémarrez votre serveur, connectez-vous et appuyez sur M pour ouvrir le menu. Consultez Raccourcis clavier pour tout ce que vMenu associe à une touche.

Plugins sur FiveM LegacyCopy Anchor Link

Les plugins écrits en Lua, JavaScript ou TypeScript fonctionnent sur les deux versions, y compris tous les plugins officiels. Un plugin C# nécessite une build conçue pour FiveM Legacy, voir Configuration C#.