Instalando no FiveM Legacy

Esta página é para o FiveM comum, construído sobre o GTA V original, que chamamos de FiveM Legacy. Está usando o FiveM Enhanced? Então o que você procura é Instalando no FiveM Enhanced. O vMenu Enhanced tem exatamente os mesmos menus e recursos nos dois.

Antes de começarCopy Anchor Link

• Este não é o vMenu original. Ele tem nomes de permissões próprios e não lê nada que o vMenu original salvou. Nunca rode os dois ao mesmo tempo. O vMenu original, v3.9.2 e anteriores, não recebe mais atualizações, mas a documentação dele continua aqui.
• Mantenha os artifacts do seu servidor atualizados. O vMenu envia coisas como verificações de atualização e webhooks por meio de um pequeno helper em Node.js, e isso exige o Node.js versão 22 que os artifacts atuais trazem. Se o seu console disser que o net bridge nunca respondeu, atualize seus artifacts.

O jeito rápido, com o txAdminCopy Anchor Link

O txAdmin é o painel de controle que acompanha todo servidor FiveM. As "receitas" dele configuram um servidor novo inteiro para você. A receita do vMenu entrega o vMenu Enhanced, permissões e configurações prontas e os plugins de routing buckets, seletor de tema e temas personalizados. O admin que você configurou no txAdmin já pode usar o menu inteiro de cara.

Escolha a receita do vMenu na tela de configuração do txAdmin. Se ela não aparecer na lista, escolha "Remote URL Template" e cole este link, que sempre aponta para a versão mais recente:

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

Pronto, você pode pular o resto desta página. O server.cfg que o txAdmin cria para você explica como configurar as permissões dos plugins.

O jeito manualCopy Anchor Link

1. Baixe e descompacteCopy Anchor Link

Baixe o vMenu-Enhanced-Legacy-v<version>.zip da versão mais recente e descompacte na sua pasta resources. Só o zip com "Legacy" no nome funciona aqui. O outro se recusa a iniciar e avisa isso no console.

2. Adicione as primeiras linhas ao seu 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

As duas linhas exec carregam suas permissões e configurações, que você cria no próximo passo. A linha add_filesystem_permission permite que o vMenu grave na própria pasta. As três precisam vir antes do ensure, senão ninguém consegue abrir o menu e o vMenu não consegue salvar nada.

Usa uma integração com sincronização de cargos, em que a integração decide quem fica em qual grupo de permissões? Então o vMenu também precisa destas duas linhas, que o permissions.cfg de exemplo já tem no topo:

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

3. Crie seus arquivos de permissões e configuraçõesCopy Anchor Link

Abra resources/vMenu.Enhanced/config/. Copie permissions.cfg.example e configuration.cfg.example e remova o .example do nome das cópias. Depois edite as cópias:

• permissions.cfg decide quem pode usar qual parte do menu. Ele usa permissões "ace", que é o jeito do FiveM de dizer "este jogador ou grupo tem permissão para fazer isto".
• configuration.cfg decide como o vMenu se comporta e o que está ativado.

O vMenu nunca altera as suas cópias. Os arquivos .example são reescritos toda vez que o vMenu inicia, então sempre listam todas as permissões e configurações existentes. Manter suas cópias atualizadas é com você: depois de cada atualização do vMenu, confira o changelog ou compare suas cópias com os arquivos .example e adicione por conta própria as novas permissões ou configurações que quiser.

Só vai jogar com os amigos? Esta única linha no permissions.cfg já resolve:

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

Tudo prontoCopy Anchor Link

Reinicie o servidor, entre e aperte M para abrir o menu. Veja Atalhos de teclado para tudo mais que o vMenu coloca em uma tecla.

Plugins no FiveM LegacyCopy Anchor Link

Plugins escritos em Lua, JavaScript ou TypeScript funcionam nas duas versões, incluindo todos os plugins oficiais. Um plugin em C# precisa de um build feito para o FiveM Legacy, veja Configuração de C#.