Installation sur FiveM Enhanced

Cette page concerne FiveM Enhanced, la version de FiveM basée sur GTA V Enhanced. Vous utilisez le FiveM classique ? Alors consultez plutôt Installation sur FiveM Legacy.

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 Enhanced 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. FiveM Legacy a sa propre recette, et le vMenu d'origine n'en a plus.

Choisissez la recette vMenu Enhanced 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-enhanced-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-v<version>.zip depuis la dernière version et décompressez-le dans votre dossier resources. Ne touchez pas au zip qui contient « Legacy » dans son nom, celui-là est destiné aux serveurs FiveM classiques.

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. FiveM Enhanced empêche les ressources d'écrire sur le disque, et 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. Votre serveur tourne sous Linux ? Jetez aussi un œil à Utilisation sous Linux.