# Instalando no FiveM Enhanced (/pt-br/docs/enhanced/installing/fivem-enhanced)

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

## O jeito rápido, com o txAdmin [#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](https://github.com/TomGrobbe/vMenu.RoutingBucketsPlugin), [seletor de tema](https://github.com/TomGrobbe/vMenu.ThemePicker) e [temas personalizados](https://github.com/TomGrobbe/vMenu.CustomThemesPlugin). O admin que você configurou no txAdmin já pode usar o menu inteiro de cara. O FiveM Legacy tem [a própria receita](./fivem-legacy.md), 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 [#o-jeito-manual]

### 1. Baixe e descompacte [#1-baixe-e-descompacte]

Baixe o `vMenu-Enhanced-v<version>.zip` da [versão mais recente](https://github.com/TomGrobbe/vMenu/releases/latest) e descompacte na sua pasta `resources`. Deixe de lado o zip com "Legacy" no nome, esse é para servidores FiveM comuns.

:::danger[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 [#2-adicione-as-primeiras-linhas-ao-seu-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
```

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](https://github.com/TomGrobbe/vMenu/blob/main/docs/src/content/docs../integrations.md) 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:

```ini
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 [#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:

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

:::danger[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 [#tudo-pronto]

Reinicie o servidor, entre e aperte `M` para abrir o menu. Veja [Atalhos de teclado](../key-bindings.md) para tudo mais que o vMenu coloca em uma tecla. Roda o servidor no Linux? Dê uma olhada também em [Rodando no Linux](../running-on-linux.md).