# Installeren op FiveM Legacy (/nl/docs/enhanced/installing/fivem-legacy)

Deze pagina is voor de gewone FiveM, gebouwd op de originele GTA V, die wij FiveM Legacy noemen. Draai je juist FiveM Enhanced? Dan wil je [Installeren op FiveM Enhanced](./fivem-enhanced.md). vMenu Enhanced heeft op beide precies dezelfde menu's en functies.

## Voordat je begint [#voordat-je-begint]

- **Dit is niet de originele vMenu.** Het heeft eigen permissienamen en leest niets van wat de originele vMenu heeft opgeslagen. Draai nooit allebei tegelijk. De originele vMenu, v3.9.2 en ouder, wordt niet meer bijgewerkt, maar de documentatie staat nog [hier](../../legacy/index.md).
- **Houd je serverartifacts up-to-date.** vMenu stuurt zaken als updatecontroles en webhooks via een kleine Node.js-helper, en die heeft Node.js versie 22 nodig, die bij actuele artifacts zit. Als je console meldt dat de net bridge nooit heeft geantwoord, update dan je artifacts.

## De snelle manier, met txAdmin [#de-snelle-manier-met-txadmin]

txAdmin is het controlepaneel dat bij elke FiveM-server zit. Met de "recepten" zet het in één keer een complete nieuwe server voor je op. Het vMenu-recept geeft je vMenu Enhanced, kant-en-klare permissies en instellingen, en de plugins [routing buckets](https://github.com/TomGrobbe/vMenu.RoutingBucketsPlugin), [theme picker](https://github.com/TomGrobbe/vMenu.ThemePicker) en [custom themes](https://github.com/TomGrobbe/vMenu.CustomThemesPlugin). De admin die je in txAdmin instelt, kan meteen het hele menu gebruiken.

Kies het vMenu-recept in het setupscherm van txAdmin. Staat het er niet bij, kies dan "Remote URL Template" en plak deze link, die altijd naar de nieuwste release verwijst:

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

Dat is alles, je kunt de rest van deze pagina overslaan. De `server.cfg` die txAdmin voor je maakt, legt uit hoe je de permissies van de plugins instelt.

## De handmatige manier [#de-handmatige-manier]

### 1. Downloaden en uitpakken [#1-downloaden-en-uitpakken]

Download `vMenu-Enhanced-Legacy-v<version>.zip` van de [nieuwste release](https://github.com/TomGrobbe/vMenu/releases/latest) en pak het uit in je `resources`-map. Alleen de zip met "Legacy" in de naam werkt hier. De andere weigert te starten en meldt dat in de console.

:::danger[De mapnaam is belangrijk]
Geef de map exact de naam `vMenu.Enhanced`, hoofdletters en al, ook al is je server geen FiveM Enhanced. Elke permissie- en instellingsnaam is hiervan afgeleid, en vMenu weigert te starten onder een andere naam.
:::

### 2. Voeg de eerste regels toe aan je server.cfg [#2-voeg-de-eerste-regels-toe-aan-je-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
```

De twee `exec`-regels laden je permissies en instellingen, die je in de volgende stap maakt. Met de regel `add_filesystem_permission` mag vMenu in zijn eigen map schrijven. Alle drie moeten vóór `ensure` staan, anders kan niemand het menu openen en kan vMenu niets opslaan.

Gebruik je een [integratie](https://github.com/TomGrobbe/vMenu/blob/main/docs/src/content/docs../integrations.md) met rolsynchronisatie, waarbij je integratie bepaalt wie in welke permissiegroep zit? Dan heeft vMenu ook deze twee regels nodig, die in de voorbeeld-`permissions.cfg` al bovenaan staan:

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

### 3. Maak je permissie- en instellingenbestanden [#3-maak-je-permissie--en-instellingenbestanden]

Open `resources/vMenu.Enhanced/config/`. Kopieer `permissions.cfg.example` en `configuration.cfg.example`, en haal `.example` uit de namen van de kopieën. Bewerk daarna de kopieën:

- `permissions.cfg` bepaalt wie welk deel van het menu mag gebruiken. Het gebruikt "ace"-permissies, de manier van FiveM om te zeggen "deze speler of groep mag dit doen".
- `configuration.cfg` bepaalt hoe vMenu zich gedraagt en wat is ingeschakeld.

vMenu past je kopieën nooit aan. De `.example`-bestanden worden bij elke start van vMenu opnieuw geschreven, dus daarin staan altijd alle bestaande permissies en instellingen. Je kopieën up-to-date houden is aan jou: controleer na elke vMenu-update de changelog of vergelijk je kopieën met de `.example`-bestanden, en voeg zelf de nieuwe permissies of instellingen toe die je wilt hebben.

Speel je alleen met vrienden? Met deze ene regel in `permissions.cfg` kun je aan de slag:

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

:::danger[Dit geeft iedereen alles]
Gebruik die regel alleen op een server met een whitelist waar willekeurige mensen niet op kunnen.
:::

### Klaar [#klaar]

Herstart je server, join, en druk op `M` om het menu te openen. Zie [Toetsenbindingen](../key-bindings.md) voor alles wat vMenu verder op een toets zet.

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

Plugins die in Lua, JavaScript of TypeScript zijn geschreven, werken op beide versies, inclusief elke officiële plugin. Een C#-plugin heeft een build nodig die voor FiveM Legacy is gemaakt, zie [C#-setup](../plugins/csharp.md).
