vMenu Docs
Instalação

Instalando no FiveM Enhanced

Como instalar o vMenu Enhanced em um servidor FiveM Enhanced, com uma receita do txAdmin ou manualmente.

Esta página é para o FiveM Enhanced, a versão do FiveM construída sobre o GTA V Enhanced. Está usando o FiveM comum? Então o que você procura é Instalando no FiveM Legacy.

O jeito rápido, com o txAdmin

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 Enhanced 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. O FiveM Legacy tem a própria receita, e o vMenu original não tem mais uma.

Escolha a receita do vMenu Enhanced 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-enhanced-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 manual

1. Baixe e descompacte

Baixe o vMenu-Enhanced-v<version>.zip da versão mais recente e descompacte na sua pasta resources. Deixe de lado o zip com "Legacy" no nome, esse é para servidores FiveM comuns.

O nome da pasta importa

Dê à pasta exatamente o nome vMenu.Enhanced, com as letras maiúsculas e tudo. Todos os nomes de permissões e configurações são construídos a partir dele, e o vMenu se recusa a iniciar com qualquer outro nome.

2. Adicione as primeiras linhas ao seu server.cfg

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. O FiveM Enhanced impede que resources gravem em disco, e 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ções

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

Isso dá tudo para todo mundo

Só use essa linha em um servidor com whitelist, onde pessoas aleatórias não conseguem entrar.

Tudo pronto

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. Roda o servidor no Linux? Dê uma olhada também em Rodando no Linux.

Nesta página