# Installation sur FiveM Legacy (/fr/docs/enhanced/installing/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](./fivem-enhanced.md). vMenu Enhanced offre exactement les mêmes menus et fonctionnalités sur les deux.

## Avant de commencer [#avant-de-commencer]

- **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](../../legacy/index.md).
- **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 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 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.

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 manuelle [#la-méthode-manuelle]

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

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

:::danger[Le nom du dossier est important]
Nommez le dossier exactement `vMenu.Enhanced`, majuscules comprises, même si votre serveur n'est pas un FiveM Enhanced. 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. 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.

## Plugins sur FiveM Legacy [#plugins-sur-fivem-legacy]

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#](../plugins/csharp.md).