# Installation sur FiveM Enhanced (/fr/docs/enhanced/installing/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](./fivem-legacy.md).

## La méthode rapide, avec txAdmin [#la-méthode-rapide-avec-txadmin]

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](https://github.com/TomGrobbe/vMenu.RoutingBucketsPlugin), [theme picker](https://github.com/TomGrobbe/vMenu.ThemePicker) et [custom themes](https://github.com/TomGrobbe/vMenu.CustomThemesPlugin). L'administrateur que vous configurez dans txAdmin peut utiliser tout le menu immédiatement. FiveM Legacy a [sa propre recette](./fivem-legacy.md), 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 manuelle [#la-méthode-manuelle]

### 1. Téléchargez et décompressez [#1-téléchargez-et-décompressez]

Téléchargez `vMenu-Enhanced-v<version>.zip` depuis la [dernière version](https://github.com/TomGrobbe/vMenu/releases/latest) 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.

:::danger[Le nom du dossier est important]
Nommez le dossier exactement `vMenu.Enhanced`, majuscules comprises. Chaque nom de permission et de réglage en est dérivé, et vMenu refuse de démarrer sous tout autre nom.
:::

### 2. Ajoutez les premières lignes à votre server.cfg [#2-ajoutez-les-premières-lignes-à-votre-servercfg]

```ini
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](https://github.com/TomGrobbe/vMenu/blob/main/docs/src/content/docs../integrations.md) 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 :

```ini
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églages [#3-créez-vos-fichiers-de-permissions-et-de-réglages]

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 :

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

:::danger[Cela donne tout à tout le monde]
N'utilisez cette ligne que sur un serveur en liste blanche où n'importe qui ne peut pas se connecter.
:::

### C'est terminé [#cest-terminé]

Redémarrez votre serveur, connectez-vous et appuyez sur `M` pour ouvrir le menu. Consultez [Raccourcis clavier](../key-bindings.md) pour tout ce que vMenu associe à une touche. Votre serveur tourne sous Linux ? Jetez aussi un œil à [Utilisation sous Linux](../running-on-linux.md).