Installeren op 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. vMenu Enhanced heeft op beide precies dezelfde menu's en functies.

Voordat je begintCopy Anchor Link

• 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.
• 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 txAdminCopy Anchor Link

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, theme picker en custom themes. 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 manierCopy Anchor Link

1. Downloaden en uitpakkenCopy Anchor Link

Download vMenu-Enhanced-Legacy-v<version>.zip van de nieuwste release 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.

2. Voeg de eerste regels toe aan je 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

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 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:

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

3. Maak je permissie- en instellingenbestandenCopy Anchor Link

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:

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

KlaarCopy Anchor Link

Herstart je server, join, en druk op M om het menu te openen. Zie Toetsenbindingen voor alles wat vMenu verder op een toets zet.

Plugins op FiveM LegacyCopy Anchor Link

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.