FiveM Enhanced (GTA V Enhanced): o que é e como executar um

FiveM Enhanced é o FiveM construído para GTA V Enhanced — a remasterização de 2025 do GTA V lançada junto com o ciclo de marketing do GTA VI. Se seus jogadores usam GTA V Enhanced, eles precisam se conectar a um servidor FiveM Enhanced; a versão Legacy não os aceitará. Todo o resto — sua licença Cfx.re, seus recursos, seu server.cfg — é quase idêntico ao FiveM Legacy.

Quando escolher Enhanced vs Legacy

• Enhanced: escolha esta opção se você ou sua comunidade estiverem usando GTA V Enhanced. Cliente moderno, todas as novas atualizações do Cfx.re chegam aqui primeiro, e é para cá que o desenvolvimento do FiveM está caminhando.
• Legacy: escolha esta opção se sua comunidade estiver usando o GTA V original (pré-Enhanced) ou se um framework de roleplay crítico do qual você depende ainda não foi atualizado para o Enhanced.

Você pode alternar entre os dois a qualquer momento no ServerPrism — o painel lida com a troca de tempo de execução e seus arquivos são mantidos no lugar.

Iniciando um novo servidor Enhanced

1. No checkout (ou na aba Change Version de um servidor FiveM existente), selecione FiveM Enhanced como o tempo de execução.
2. Espere a instalação terminar — o painel puxa a última versão Enhanced recomendada diretamente da documentação do FiveM, então você não precisa se preocupar com números de build.
3. Abra o File Manager, edite server.cfg e cole sua chave de licença Cfx.re na linha sv_licenseKey. Se você ainda não tem uma chave, consulte Configuração da chave de licença FiveM.
4. Inicie o servidor na aba Console.

Esse é o fluxo completo da primeira execução. Tudo do guia base do FiveM (chave de licença, linhas ensure, layout de recursos, configuração de banco de dados) se aplica aqui também.

A única linha que o torna Enhanced

Dentro de server.cfg, perto do topo:

sv_enforceGameBuild 2944

2944 é a versão atual recomendada do GTA V Enhanced. Esta linha diz ao servidor "rejeitar qualquer um cujo cliente não esteja nesta versão do GTA V". Sem ela, clientes Legacy podem tentar se conectar e obter uma incompatibilidade de versão.

• Em servidores Enhanced: mantenha esta linha, ou aumente o número quando o Cfx.re promover uma versão Enhanced mais recente.
• Em servidores Legacy: remova a linha (ou altere o número para uma versão Legacy como 2545, 2802, 2699).

Se você pular esta linha inteiramente, o servidor aceita a versão padrão para o tempo de execução em que está, o que geralmente é a escolha segura para a maioria das comunidades.

Alternando entre Enhanced e Legacy

Você não precisa reinstalar ou reenviar nada para alternar os tempos de execução no ServerPrism. Em Change Version no seu servidor, escolha FiveM (Legacy) ou FiveM Enhanced. O painel:

• Troca o binário de tempo de execução subjacente.
• Mantém sua pasta resources/, server.cfg, configuração do txAdmin e quaisquer dados MySQL que você tenha no servidor.
• Reinicia o contêiner com o novo conjunto de binários.

Após a conclusão da troca, você só precisa ajustar a linha sv_enforceGameBuild em server.cfg se quiser alterar o alvo da versão:

• Legacy → Enhanced: adicione (ou atualize) sv_enforceGameBuild 2944.
• Enhanced → Legacy: remova essa linha, ou altere-a para um número de versão Legacy.

Salve server.cfg, reinicie na aba Console, e você estará no novo tempo de execução.

Compatibilidade de recursos

A maioria dos recursos do FiveM — chat, mapmanager, spawnmanager, oxmysql, ESX, QBCore, VORP, etc. — funciona tanto em Enhanced quanto em Legacy. Alguns casos específicos:

• Recursos mais antigos que codificam um número de versão Legacy: verifique o fxmanifest.lua do recurso para uma linha game 'gta5' combinada com qualquer restrição gameVersion. Se um recurso visa explicitamente uma versão Legacy, ele pode precisar de uma atualização de seu autor antes de funcionar em Enhanced.
• Recursos que usam offsets de memória específicos do GTA V: alguns cheats/handlers dependiam de layouts de memória Legacy. Se um recurso apresentar erro na inicialização apenas em Enhanced, suas chamadas nativas provavelmente precisam ser atualizadas.
• Recursos de UI com NUI: estes geralmente funcionam sem alterações — NUI é executado em uma sobreposição de navegador, não no motor do jogo.

Se um recurso apresentar erro apenas em Enhanced, a primeira linha error no seu console geralmente aponta para o que precisa ser atualizado. Verifique o GitHub do recurso ou o tópico do fórum Cfx.re para um problema de "suporte Enhanced".

Obtendo o número de build recomendado

O Cfx.re publica a versão Enhanced recomendada atual em sua documentação. Nosso instalador de egg raspa isso no momento da instalação, então uma nova instalação Enhanced sempre chega à versão recomendada atual sem que você precise procurá-la. Se você quiser executar uma versão Enhanced específica para testes de compatibilidade, defina a variável FIVEM_VERSION na aba Startup antes de reinstalar.

Requisitos do cliente

• Os jogadores devem possuir GTA V Enhanced (a remasterização de 2025) e ter o cliente FiveM Enhanced instalado. O launcher FiveM detecta automaticamente qual cliente usar com base na versão do GTA V que o jogador possui.
• Jogadores no GTA V original (Legacy) não podem se conectar a um servidor Enhanced. Direcione-os para o seu servidor Legacy, ou peça-lhes para atualizar para Enhanced.

Problemas comuns

• Erros de sv_licenseKey: o mesmo que Legacy — regenere em keymaster.fivem.net.
• "Server build not supported" na conexão do jogador: seu sv_enforceGameBuild não corresponde ao cliente do jogador. Confirme se 2944 está definido e se o jogador está em Enhanced.
• Servidor não aparece no navegador Enhanced: pode levar um minuto após a inicialização para a lista de servidores detectá-lo. Verifique se sv_hostname está definido e se nenhum recurso está apresentando erro fatal na inicialização.
• Um recurso apresenta erro em Enhanced, mas funcionava em Legacy: verifique a documentação do recurso para suporte Enhanced, ou abra um ticket e ajudaremos a identificar a chamada nativa específica que está falhando.

Ainda com problemas?

Abra um ticket de suporte com a saída do seu console — inclua a primeira linha error e o recurso que ela menciona. Se você estiver no meio de uma troca entre Enhanced e Legacy, diga-nos em qual direção você está trocando e poderemos identificar rapidamente o desvio de configuração.