Como instalar o txAdmin e criar seu servidor de FiveM (tutorial completo)

Quase todo servidor de FiveM rodando hoje foi criado com o txAdmin — o painel de controle web que vem dentro da build oficial do servidor. Ele cuida da implantação, dos reinícios, dos banimentos, do console e do seu server.cfg a partir de uma aba do navegador, e instala uma base completa de ESX ou QBCore em poucos cliques.

Este tutorial vai de uma pasta vazia até um servidor no qual seus amigos podem entrar, explicando por que cada passo importa — não só onde clicar.

O que você precisa antes de começar

• Uma máquina para rodar — seu PC para testes, ou uma hospedagem/VPS para qualquer coisa pública.
• Uma conta Cfx.re gratuita para a chave de licença.
• MySQL ou MariaDB — todo framework sério precisa de banco de dados.
• Cerca de 45 minutos.

No Windows, instale antes o Microsoft Visual C++ Redistributable (x64). O FXServer não inicia sem ele, e o erro que aparece é críptico — essa única dependência faltando causa boa parte dos posts de “fecha na hora”.

No Linux, você precisa do xz-utils para extrair a build, além de um servidor MySQL/MariaDB.

Passo 1 — Consiga sua chave de licença Cfx.re

Acesse keymaster.fivem.net, entre com sua conta Cfx.re (a do fórum) e registre uma nova chave de servidor.

• Escolha “I’m using a server hosting provider” ou um IP fixo, se já souber — dá para mudar depois.
• Guarde a chave em local seguro. É uma sequência longa e aleatória.

Essa chave identifica seu servidor para a Cfx.re. Trate como senha: nunca cole em print no Discord, nunca suba para o GitHub. Uma chave vazada pode ser usada por outro e fazer a sua ser revogada.

Passo 2 — Baixe os artifacts do servidor

Os artifacts são a build real do servidor (FXServer). Baixe do runtime oficial:

• Windows — runtime.fivem.net/artifacts/fivem/build_server_windows/master/
• Linux — runtime.fivem.net/artifacts/fivem/build_proot_linux/master/

Pegue a build marcada como recommended, não a mais nova lá em cima. Artifacts de última hora quebram recursos com frequência, e a recomendada é contra a qual os desenvolvedores realmente testam. Acompanhamos isso no nosso guia de artifacts.

Extraia numa pasta dedicada — por exemplo C:\FXServer\server\ no Windows, ou /home/fivem/server/ no Linux.

Passo 3 — Organize a estrutura de pastas

Mantenha a build e os seus dados do servidor em pastas separadas. É o melhor hábito com que você pode começar: atualizar os artifacts depois vira “apagar e substituir uma pasta” em vez de uma cirurgia no meio dos seus arquivos.

C:\FXServer\
├── server\          <- os artifacts extraídos (substituíveis)
└── server-data\     <- seus recursos, server.cfg, dumps do banco

Quando atualizar o FiveM daqui a seis meses, você apaga server\, extrai a build nova, e tudo que é realmente seu fica intacto.

Passo 4 — Inicie o servidor pela primeira vez

Execute o binário:

• Windows — duplo clique em FXServer.exe dentro de server\.
• Linux — entre na pasta e rode ./run.sh.

Abre um console e o txAdmin inicia. Você verá algo assim:

[txAdmin] Starting txAdmin v7.x.x
[txAdmin] Web UI: http://localhost:40120
[txAdmin] PIN: 4821

Abra essa URL no navegador e digite o PIN.

Passo 5 — Crie sua conta mestre

O txAdmin pede para criar a conta mestre — o admin de topo que nenhum outro admin pode remover.

Use uma senha de verdade, não admin123. Esse painel executa comandos de console no seu servidor; quem chegar nele é dono da sua comunidade. Opcionalmente dá para vincular uma identidade Cfx.re ou Discord para entrar mais fácil.

Perdeu depois? Pare o servidor e inicie uma vez com --resetadmin:

FXServer.exe --resetadmin

Passo 6 — Prepare o banco de dados

Antes de rodar o implantador, tenha MySQL/MariaDB pronto. No Windows, o caminho comum é XAMPP ou uma instalação avulsa do MariaDB; no Linux, mariadb-server pelo gerenciador de pacotes.

Crie um banco vazio (por exemplo fivem) e um usuário com todos os direitos sobre ele. No próximo passo você entrega ao txAdmin uma string de conexão neste formato:

mysql://usuario:senha@localhost/fivem?charset=utf8mb4

Use um usuário dedicado, não o root, e dê a ele uma senha real. O banco de um framework acaba guardando os personagens, o dinheiro e o inventário de cada jogador — é a única coisa que você realmente não consegue reconstruir.

Passo 7 — Implante um framework com o implantador de receitas

Agora a parte que faz o txAdmin valer a pena. A tela de setup oferece vários tipos de implantação; escolha receitas populares e depois sua base:

• ESX — o maior ecossistema; o mais fácil para achar scripts, tutoriais e staff que já conheça.
• QBCore — moderno e voltado ao roleplay.
• Qbox — continuação do QBCore focada em desempenho.

Na dúvida? Leia nossa comparação ESX vs QBCore vs Qbox antes de se comprometer — migrar depois dá trabalho de verdade.

Aí o txAdmin pede:

1. Um nome de servidor e a pasta de dados (server-data\).
2. Sua string de conexão do passo 6.
3. Sua chave de licença do passo 1.

Manda implantar. O txAdmin baixa o framework, importa o SQL, escreve um server.cfg funcional e inicia o servidor. Acompanhe o log: se algo falhar, ele diz exatamente qual peça foi.

Passo 8 — Confira seu server.cfg

A receita escreve uma configuração que funciona, mas você deve entender o que tem ali. O txAdmin traz um editor embutido (Settings → CFG Editor), então não precisa mexer em arquivo por FTP para mudanças pequenas.

As linhas que mais importam:

sv_hostname "Meu servidor de roleplay"
sv_maxclients 48
sv_licenseKey "sua-chave-aqui"

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

# OneSync — necessário para mais de 32 jogadores
set onesync on
sv_enforceGameBuild 3095

Duas coisas que se aprendem do jeito difícil:

• sv_maxclients não é estratégia de crescimento. Comece com 32–48. Um servidor vazio de 128 slots parece morto; um cheio de 48 parece vivo.
• sv_enforceGameBuild fixa a build do GTA que seu servidor espera. Mude só quando um recurso realmente precisar de conteúdo DLC mais novo, e conte com testar tudo de novo depois.

Passo 9 — Abra as portas certas

Os jogadores conectam na 30120, TCP e UDP. Se você só liberar TCP, o servidor aparece na lista mas ninguém consegue entrar — clássico que custa uma tarde.

Nunca exponha a 40120 publicamente. Se precisar de acesso remoto, coloque atrás de uma VPN ou de um proxy reverso com HTTPS e senha forte. Um painel txAdmin aberto na internet é um console remoto completo do seu servidor, e existem bots que varrem procurando isso.

Passo 10 — Aprenda o painel

Gaste dez minutos aqui; se paga sozinho:

• Dashboard — gráfico de desempenho ao vivo. Quando os jogadores disserem “tá lagando”, é aqui que você confirma.
• Live Console — o console real do servidor no navegador. Leia de cima para baixo e corrija sempre o primeiro erro vermelho; o resto costuma ser consequência.
• Players — buscar, avisar, expulsar, banir e ver o histórico por identificador.
• Restarter — reinícios programados. Configure desde o primeiro dia (veja abaixo).
• CFG Editor — editar o server.cfg sem FTP.
• Bot do Discord — opcional; mensagens de status e whitelist por cargos.

Configure já os reinícios programados

Em Settings → Restarter, programe reinícios a cada 6–12 horas. Um FXServer rodando há muito tempo acumula memória e degrada aos poucos, e um reinício programado com contagem regressiva é invisível para os jogadores. Um crash imprevisto no horário de pico não é.

Passo 11 — Adicione seus primeiros recursos

Com o framework rodando, os recursos vão em server-data/resources/, cada um ativado com uma linha ensure. A ordem importa — as dependências iniciam primeiro:

# Núcleo — estes vêm primeiro
ensure oxmysql
ensure ox_lib
ensure es_extended

# Jogabilidade
ensure meu-inventario
ensure meu-hud

Adicione recursos um de cada vez, reiniciando entre eles. Se você jogar quinze scripts de uma vez e o servidor morrer, você tem quinze suspeitos. Um a um, você sempre sabe exatamente o que quebrou.

Os sistemas que os jogadores notam primeiro são o inventário e o HUD — estão na tela o tempo todo, então definem como seu servidor parece mais do que qualquer script de emprego. Nosso guia dos melhores inventários de FiveM compara as opções; se você quer um que cubra ESX, QB, QBCore e Qbox a partir de uma só base de código, o Quasar Inventory é o polivalente polido ao qual sempre voltamos nos testes. Para o passo a passo da instalação, siga nosso tutorial de instalação de inventário.

Passo 12 — Teste direito, depois abra

Conecte localmente com connect localhost pelo cliente do FiveM (console F8), depois peça a um amigo para entrar pelo seu endereço público.

Percorra o ciclo completo antes de anunciar: nascer, pegar um emprego, ganhar dinheiro, abrir o inventário, guardar um item, comprar e retirar um carro, relogar e confirmar que tudo persistiu. Relogar é o teste de verdade — a maioria dos relatos de “meu servidor perde os dados dos jogadores” é um problema de banco que só aparece na reconexão.

Faça backup do seu banco — o txAdmin não faz por você

Essa é a falha mais comum em servidores por outro lado bem cuidados. O txAdmin gerencia seu servidor; ele não faz backup do seu banco de dados. Monte seu próprio dump programado:

mysqldump -u fivem -p fivem > backup-$(date +%F).sql

Automatize (cron ou Agendador de Tarefas) e guarde cópias fora da máquina. Um servidor que você reconstrói numa tarde é um transtorno. Um banco que você não consegue restaurar é o fim da comunidade.

Solução de problemas

Para onde ir agora

Você já tem um servidor rodando, reiniciável e com backup. As duas coisas que decidem se os jogadores ficam são o desempenho e um ciclo de jogo coerente — não quantos scripts você tem.

Leia nosso guia de otimização antes da sua primeira noite cheia, e como reduzir o lag quando ele chegar, porque vai chegar. Depois tranque as portas: nosso guia de segurança cobre o que endurecer antes de você valer a pena atacar.