Como criar um servidor FiveM com txAdmin

Este guia mostra como configurar um servidor FiveM para GTA V Legacy com FXServer e txAdmin no Windows ou Linux. Você vai criar uma chave de registro no Cfx.re Portal, implantar a receita padrão, revisar a configuração e testar a conexão. Adicione um framework de roleplay depois que o servidor básico estiver funcionando.

Antes de começar

Requisito	O que preparar
Conta Cfx.re	Use sua conta para registrar o servidor no Portal e vinculá-la ao txAdmin.
Uma máquina para o servidor	Um PC local para aprender ou uma hospedagem que ofereça suporte ao FXServer. Confira o acesso aos arquivos, console, firewall e backups antes de escolher o serviço.
Um cliente para jogar	Para entrar neste servidor Legacy, use uma instalação legítima do GTA V Legacy e o cliente FiveM correspondente. Não é preciso instalar o GTA V na máquina que hospeda o servidor.
Ferramentas no Windows	Um programa que extraia arquivos `.7z`, como o 7-Zip.
Ferramentas no Linux	Uma conta sem privilégios de root para executar o FXServer, uma ferramenta de download e suporte à extração de arquivos `.tar.xz`. Os comandos de pacotes abaixo são para Debian/Ubuntu.

Não dá para garantir uma quantidade de jogadores apenas com os números de RAM e CPU. O código dos recursos, os conteúdos enviados aos clientes, o banco de dados e as atividades simultâneas influenciam o consumo. Comece com uma configuração pequena de teste e meça a carga antes de contratar mais capacidade.

Escolha entre Legacy e Enhanced

Os comandos abaixo são para GTA V Legacy e FXServer. Na data da revisão das fontes indicada ao final, a Cfx.re apresenta o FiveM for GTAV Enhanced como uma versão em acesso antecipado. O Enhanced usa arquivos separados do Cfx Server, incluindo cfx-server.exe no Windows, e traz mudanças que podem exigir ajustes nos recursos ou na configuração.

Para o Enhanced, leia as notas oficiais de migração e mudanças de compatibilidade antes de escolher um framework ou migrar um servidor. Confira o suporte a assets, comunicação por voz e Asset Escrow na versão atual. Nossa comparação entre Legacy e Enhanced explica a escolha; renomear um executável não é um procedimento de migração.

Passo 1: crie uma chave de registro

Abra a página Server registration keys do Cfx.re Portal e entre na sua conta.
Escolha a opção para gerar uma chave, informe um nome de exibição e confirme.
Copie a chave gerada para o Recipe Deployer do txAdmin. No server.cfg, a configuração correspondente é sv_licenseKey.

As instruções atuais da Cfx.re pedem um nome de exibição, não o IP público da primeira inicialização descrito em tutoriais antigos do Keymaster. Não coloque a chave em repositórios públicos, capturas de tela ou logs compartilhados. Se ela vazar, gere-a novamente no Portal e atualize a configuração do servidor.

Passo 2: baixe os arquivos do servidor Legacy

Acesse a página oficial Server Download, selecione FiveM para GTA V Legacy e seu sistema operacional e baixe a versão recomendada. Copie a URL atual dessa página em vez de reutilizar um número de versão de um tutorial.

Windows

Crie C:\FXServer\server para os arquivos do servidor.
Baixe server.7z e extraia o conteúdo nessa pasta.

Linux: preparação no Debian/Ubuntu

Instale as ferramentas de download e extração com uma conta autorizada a gerenciar pacotes. Execute o FXServer com seu usuário dedicado, sem privilégios de root.

sudo apt update
sudo apt install ca-certificates wget xz-utils
mkdir -p ~/FXServer/server
cd ~/FXServer/server
wget -O fx.tar.xz 'PASTE_RECOMMENDED_LINUX_URL_HERE'
tar -xf fx.tar.xz

Substitua PASTE_RECOMMENDED_LINUX_URL_HERE antes de executar o download. Resolva qualquer erro de download ou extração antes de continuar. Em outras distribuições, use o gerenciador de pacotes correspondente e confira os requisitos oficiais para Linux.

Passo 3: inicie o FXServer e acesse o txAdmin

O txAdmin está incluído nas versões atuais do FXServer. Inicie o FXServer sem +exec server.cfg; o txAdmin gerenciará a configuração do servidor pelo assistente de instalação.

Windows: execute FXServer.exe na pasta extraída.
Linux: execute bash ~/FXServer/server/run.sh.

O console mostra a URL de configuração e o PIN. A porta web padrão do txAdmin é 40120 TCP. Na máquina do servidor, abra http://127.0.0.1:40120. Uma hospedagem gerenciada pode fornecer outra URL ou porta.

Em um servidor remoto com acesso SSH, você pode abrir este túnel no seu próprio computador, mantê-lo ativo e depois acessar a mesma URL local:

ssh -N -L 127.0.0.1:40120:127.0.0.1:40120 user@YOUR_SERVER_IP

Substitua o nome do usuário SSH e o endereço do servidor. Restrinja o acesso direto à porta de administração pelos controles de acesso ou pelo firewall da hospedagem; o túnel, por si só, não fecha uma porta exposta publicamente. Os jogadores não precisam acessar o txAdmin para entrar no servidor.

Passo 4: vincule sua conta e implante a receita padrão

Informe o PIN do console, se necessário, e selecione Link Account.
Autorize a vinculação com a conta Cfx.re, escolha uma senha de backup forte e leia os acordos exibidos pelo txAdmin.
Digite um nome para o servidor e escolha Popular Recipes.
Selecione a receita padrão de FiveM da Cfx.re. Dependendo da versão da interface, ela pode se chamar FiveM Basic Server (CFX Default) ou CFX Default FiveM.
Confirme uma pasta de dados separada para os recursos e o server.cfg e abra o Recipe Deployer.
Revise a receita, informe sua chave de registro e selecione Run Recipe.
Aguarde todas as tarefas terminarem com sucesso, revise a configuração gerada e selecione Save & Run Server.

A receita padrão oferece um servidor básico, sem uma economia completa de roleplay. Ela permite testar o servidor antes de incluir as dependências de um framework e de um banco de dados. Se a implantação falhar, guarde o primeiro erro relevante do console e resolva-o antes de tentar novamente.

Crie uma conta para cada membro da equipe no Admin Manager do txAdmin. Conceda apenas as ações necessárias: visualizar o console, executar comandos, editar a configuração e gerenciar outros administradores são permissões distintas. Os cargos do framework e as regras ACE do servidor precisam de configuração própria.

Passo 5: revise o server.cfg

Edite os valores existentes na configuração gerada pela receita. Preserve as linhas que iniciam os recursos. Este trecho mostra um pequeno servidor de teste e não substitui o arquivo completo:

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

sv_hostname "My Legacy test server"
sets sv_projectName "My Legacy test server"
sets sv_projectDesc "A basic server for connection testing"
sets tags "test"

sv_maxclients 8
set onesync on
sv_licenseKey "REPLACE_WITH_YOUR_KEY"

Configuração	O que conferir
`endpoint_add_tcp` e `endpoint_add_udp`	Use a porta atribuída pela hospedagem. Os exemplos usam 30120 nos dois protocolos; as regras de firewall e os comandos de conexão devem corresponder.
`sv_maxclients`	Define o limite de jogadores, não uma garantia de desempenho. Limites maiores podem exigir uma assinatura Cfx.re; confira as permissões atuais da sua conta no Portal.
`sv_projectName` e `sv_projectDesc`	Preencha com informações úteis para a lista de servidores.
`sv_enforceGameBuild`	Só exija uma versão do jogo depois de conferir a documentação dos recursos e as versões compatíveis com a variante do seu servidor.

O guia do server.cfg explica a configuração em mais detalhes. Você também pode consultar o gerador de server.cfg e outras ferramentas para servidor; confira os valores gerados de acordo com a receita e a hospedagem.

Passo 6: configure o acesso dos jogadores

Para receber jogadores em outras máquinas, libere a porta de jogo configurada no firewall do sistema e no firewall da hospedagem, se houver. Os exemplos usam 30120 TCP e UDP. Mantenha a porta separada do txAdmin restrita aos administradores.

Firewall do Windows: PowerShell como administrador

New-NetFirewallRule -DisplayName "FiveM TCP" -Direction Inbound -Protocol TCP -LocalPort 30120 -Action Allow
New-NetFirewallRule -DisplayName "FiveM UDP" -Direction Inbound -Protocol UDP -LocalPort 30120 -Action Allow

Linux: quando o UFW já está em uso

sudo ufw allow 30120/tcp
sudo ufw allow 30120/udp
sudo ufw status

Confira as regras resultantes e preserve o acesso usado para administrar a máquina. Esses comandos não configuram um firewall externo nem o roteador.

Se o servidor estiver atrás de um roteador doméstico, encaminhe a porta de jogo nos dois protocolos para o endereço local do PC servidor. Confirme que sua conexão permite tráfego público de entrada. Um servidor público hospedado em casa expõe o endereço público da sua conexão; considere isso ao escolher onde hospedá-lo.

Passo 7: verifique conexões locais e externas

Abra o cliente FiveM para Legacy, pressione F8 e use o endereço adequado ao teste. Substitua os marcadores de endereço e a porta conforme necessário.

Teste	Comando no cliente
Cliente e servidor no mesmo PC	`connect 127.0.0.1:30120`
Outro PC na mesma rede local	`connect SERVER_LAN_IP:30120`
Um jogador fora da sua rede	`connect SERVER_PUBLIC_IP:30120`

Entre no mundo, movimente-se, desconecte e conecte novamente enquanto acompanha o console do servidor. Para um servidor público, peça um teste a um jogador em outra rede: uma conexão local bem-sucedida não comprova o acesso público.

Você também pode verificar http://SERVER_PUBLIC_IP:30120/info.json de fora da rede do servidor. Uma resposta JSON verifica o endpoint HTTP; ela não comprova o tráfego UDP nem o funcionamento de todo o processo de entrada no jogo. Mantenha o teste com um cliente externo.

Depois que essas verificações passarem, faça uma cópia segura da pasta de dados funcional e da configuração do txAdmin antes de novas alterações.

Passo 8: escolha um framework de roleplay

Escolha conforme os recursos que pretende usar e as interfaces que sua equipe consegue manter. Compare as opções no nosso guia de frameworks FiveM.

Framework	Verificação de compatibilidade
QBCore	Confira se os recursos são compatíveis com as APIs e dependências da versão instalada do QBCore.
Qbox	Sua camada de compatibilidade com QBCore atende muitos recursos que usam interfaces documentadas. Scripts que acessam tabelas ou arquivos internos podem precisar de ajustes. O guia de instalação exige MariaDB e não oferece suporte a MySQL ou XAMPP.
ESX Legacy	Use recursos compatíveis com ESX e siga as instruções atuais da receita e do banco de dados.

Leia o guia de instalação atual do framework antes da implantação. Use uma pasta de dados nova e um banco de teste vazio para a receita. Crie uma conta de banco de dados dedicada à aplicação, mantenha as credenciais privadas e verifique a criação de personagens e a persistência dos dados antes de adicionar mais recursos.

Passo 9: adicione e mantenha recursos

Confira a origem de cada recurso, a compatibilidade com a variante do servidor, os requisitos de framework e as dependências.
Coloque-o na pasta resources/ da receita, por exemplo resources/[local]/example_resource. Examine o fxmanifest.lua fornecido e as instruções de instalação.
Adicione ensure example_resource depois das dependências necessárias no server.cfg.
Teste uma adição por vez e leia o primeiro erro na inicialização ou no jogo. Para veículos, veja o guia de instalação de carros personalizados.

Nos seus scripts de gameplay, valide ações sensíveis no servidor usando permissões e estados obtidos no servidor. Verificações apenas no cliente não bastam para proteger a entrega de itens, pagamentos ou ações privilegiadas.

Guarde backups dos recursos, da configuração e de qualquer banco de dados e teste uma restauração. Leia as notas de versão e experimente atualizações em uma cópia separada antes de substituir uma instalação funcional. Investigue problemas com logs e medições; reinícios agendados não corrigem a causa.

Solução de problemas

Sintoma	O que verificar em seguida
`no license key was specified`	Confira `sv_licenseKey` na configuração que o txAdmin realmente carrega. Na inicialização manual, confira também a pasta de dados e `+exec server.cfg`; não adicione esse argumento ao comando de inicialização do txAdmin.
`Failed to start resource`	Leia o erro anterior. Confira a pasta do recurso, o manifesto, as dependências e a ordem de inicialização; a mensagem sozinha não aponta uma causa única.
A conexão expira ou é recusada	Confirme que o FXServer está rodando e depois verifique o endereço escolhido, os dois protocolos da porta de jogo, o firewall da máquina e as regras do roteador ou da hospedagem.
A conexão direta funciona, mas o servidor não aparece na lista	Aguarde a atualização da lista. Confira `sv_projectName`, `sv_projectDesc` e qualquer configuração `sv_master1 ""` conforme a documentação da Cfx.re sobre a lista de servidores.
O txAdmin não abre	Confira a URL e a porta exibidas no console, o processo e as regras de acesso administrativo. No navegador, `127.0.0.1` aponta para a máquina em que ele está rodando, a menos que você tenha configurado o túnel acima.
O FXServer para de responder	Examine os logs próximos da primeira falha, as alterações recentes nos recursos e o uso de CPU, memória e armazenamento da máquina. Guarde essas informações antes de reiniciar.

Para continuar o diagnóstico, consulte o guia de erros do FiveM e a documentação oficial de problemas do servidor abaixo.

Perguntas frequentes

Preciso de um framework pago ou de um pacote de servidor?

Uma instalação básica do FXServer não precisa de um framework pago. Planeje separadamente a hospedagem, os recursos licenciados e as assinaturas Cfx.re necessárias às funções escolhidas. Se pretende monetizar o servidor, leia as orientações atuais da Cfx.re sobre Tebex e as políticas vinculadas antes de criar suas ofertas.

Devo usar Windows ou Linux?

Escolha um sistema aceito pela hospedagem e que sua equipe saiba administrar. Este guia mostra as duas formas de iniciar o Legacy; a instalação de pacotes, o gerenciamento de serviços e o diagnóstico variam entre os sistemas.

Quanto tempo leva a configuração?

Downloads, acesso à conta, rede e dependências da receita determinam o tempo. A primeira etapa é concluir os testes de conexão com sucesso. Configurar o framework, integrar recursos e testar a recuperação são tarefas adicionais antes da abertura ao público.

Fontes

Revisão das fontes técnicas: 10 de outubro de 2026. Este artigo foi conferido com a documentação vinculada; os comandos não foram executados em um servidor de teste nesta revisão.