O txAdmin é o painel oficial de gerenciamento web para servidores FiveM. Ele cuida de iniciar/parar o servidor, acesso ao console, gerenciamento de recursos, administração de jogadores, reinicializações automáticas e backups — tudo através de uma interface no navegador. Ele vem incluído com o FiveM por padrão e roda na porta 40120.

O txAdmin é gratuito?

Sim. O txAdmin é totalmente gratuito e de código aberto. Ele vem com o FiveM sem custo adicional. O projeto é mantido pela equipe oficial da CFX.re e desenvolvedores.

Posso rodar o txAdmin no Linux?

Sim. O txAdmin funciona tanto no Windows quanto no Linux. O Linux é preferido para servidores em produção por ter menor overhead e melhor estabilidade para processos de longa duração.

Qual porta o txAdmin usa?

Por padrão, o txAdmin usa a porta 40120 para sua interface web. Você pode alterar isso nas configurações do txAdmin. Certifique-se de que essa porta esteja aberta no seu firewall se quiser acessar o txAdmin remotamente.

Vários administradores podem usar o txAdmin ao mesmo tempo?

Sim. O txAdmin suporta múltiplas contas com permissões baseadas em cargos (Dono, Admin, Moderador, etc.). Cada administrador tem seu próprio login e o painel registra todas as ações administrativas no log de auditoria.

Qual é a diferença entre recipes do txAdmin e configuração manual?

Recipes são configurações de servidor pré-construídas que instalam um framework (ESX, QBCore, QBox) e scripts essenciais automaticamente. A configuração manual dá controle total e uma melhor experiência de aprendizado, mas leva mais tempo. Para iniciantes, recipes são mais rápidas. Para projetos sérios, a configuração manual é recomendada.

Guia de Configuração do txAdmin 2026: Instale, Configure e Gerencie Seu Servidor FiveM

Se você está montando um servidor FiveM, vai passar bastante tempo dentro do txAdmin. Ele é o painel de gerenciamento web que cuida de tudo, desde iniciar seu servidor até banir jogadores tóxicos. Conhecê-lo bem vai te poupar horas de depuração.

Este guia cobre tudo, desde sua primeira inicialização do txAdmin até configurações avançadas — reinicializações automáticas, backups, gerenciamento de recursos e permissões de administração.

Se você ainda não configurou um servidor FiveM, comece pelo nosso Guia Completo para Iniciantes sobre Como Criar um Servidor FiveM.

O que é o txAdmin?

O txAdmin é o painel oficial de gerenciamento de servidores FiveM. Ele é desenvolvido pela equipe CFX.re e vem incluído em todos os builds de servidor FiveM.

Ele fornece uma interface web (acessível em http://SEU_IP:40120) que permite:

Iniciar, parar e reiniciar seu servidor com um clique
Acessar o console do servidor em tempo real pelo navegador
Editar o server.cfg com destaque de sintaxe
Navegar, iniciar e parar recursos individuais
Banir, expulsar e avisar jogadores
Configurar reinicializações agendadas e backups automáticos
Gerenciar múltiplas contas de administração com permissões baseadas em cargos
Visualizar métricas do servidor (CPU, RAM, contagem de jogadores) em tempo real

Sem o txAdmin, você teria que gerenciar seu servidor via comandos brutos no console — possível, mas doloroso. O txAdmin é o padrão.

Instalando o txAdmin

O txAdmin já vem incluído com o servidor FiveM. Você não instala o txAdmin separadamente — você baixa o build do servidor FiveM e o txAdmin é iniciado automaticamente.

Instalação no Windows

Instale o Git e o 7-Zip se ainda não os tiver.
Acesse a página oficial de artefatos do FiveM: runtime.fivem.net/artifacts/fivem/build_server_windows/master/
Baixe o build "recomendado" mais recente (procure pela tag verde) — é um arquivo .7z.
Extraia o server.7z em uma pasta (ex.: C:\FXServer\server).
Execute o FXServer.exe — o txAdmin será iniciado automaticamente e abrirá seu navegador.
Insira o PIN exibido no console, clique em Link Account e autentique-se com sua conta CFX.re.

Instalação no Linux

Para produção, o Linux é recomendado (melhor desempenho, mais fácil de manter atualizado, menor consumo de memória).

# Pré-requisitos
sudo apt install git xz-utils

Criar um usuário dedicado
sudo adduser fivem
sudo su - fivem

Baixar o FXServer
mkdir -p ~/FXServer/server
cd ~/FXServer/server
Substitua LATEST_LINK pela URL real da página de artefatos
wget https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/LATEST_LINK
tar xf fx.tar.xz --strip-components=1
rm fx.tar.xz

Iniciar o FXServer
bash run.sh +exec server.cfg

Substitua LATEST_LINK pela URL real de download da página de artefatos Linux. Escolha o build recomendado mais recente.

Após iniciar, você verá a mesma URL do txAdmin. Abra-a no seu navegador.

Uma nota sobre rodar o txAdmin atrás de um proxy reverso

Se você quer uma URL limpa como panel.seuservidor.com em vez de seu-ip:40120, configure o Nginx ou Caddy como proxy reverso. Isso também permite habilitar HTTPS via Let's Encrypt. Recomendado para qualquer servidor público.

Assistente de primeira configuração

Na primeira execução, o txAdmin te guia por um assistente de 4 etapas.

Etapa 1 — Crie sua conta de administrador principal

Você vai criar a conta de administrador principal do txAdmin. Essa conta tem permissões totais sobre o painel. Escolha uma senha forte — qualquer pessoa com esse login controla seu servidor inteiro.

Você também pode vincular via sua conta Discord ou CFX.re para login OAuth. Recomendado por segurança (nenhuma senha para vazar).

Etapa 2 — Vincule sua conta CFX.re

O txAdmin vai pedir para autorizá-lo com sua conta CFX.re. Isso conecta seu servidor à sua chave de licença CFX.re para que ele possa se autenticar corretamente.

Etapa 3 — Configuração do servidor

Será solicitado:

Nome do servidor (ex.: "Meu Servidor RP Incrível")
Pasta do servidor — onde seus resources/ e server.cfg ficarão
Caminho dos dados do servidor — onde o txAdmin armazena seus dados (logs, backups, etc.)

Etapa 4 — Escolha uma recipe (ou pule)

Esta é a grande decisão: você quer que o txAdmin instale automaticamente um servidor base para você, ou quer começar do zero?

Selecione "Popular Recipes" para ver os templates disponíveis. A lista varia ao longo do tempo, mas as opções típicas incluem:

CFX Default FiveM — configuração mínima padrão, não requer banco de dados. Melhor para experimentar pela primeira vez.
QBCore — framework QBCore completo + scripts essenciais. Requer MariaDB.
ESX Legacy — framework ESX completo + scripts essenciais. Requer MariaDB.
QBox — framework QBox completo. Requer MariaDB.

Algumas recipes da comunidade (vMenu, templates personalizados) também podem estar disponíveis. Nossa recomendação: se você é um iniciante completo apenas experimentando — use CFX Default FiveM (sem necessidade de banco de dados). Se você está construindo um servidor RP sério — escolha uma recipe de QBCore ou QBox, ou comece com uma configuração em branco e instale tudo manualmente. Você vai entender sua stack muito melhor, o que compensa quando estiver depurando às 2h da manhã.

Após essa etapa, o txAdmin finaliza a configuração e inicia seu servidor. Você deve ver "Server started" no console.

Entendendo o painel do txAdmin

Após fazer login, você verá o painel principal do txAdmin. Vamos detalhar cada seção.

Barra superior

A barra no topo mostra:

Status do servidor (Online/Offline com contagem de jogadores)

Tempo de atividade do servidor

Uso de CPU e RAM

Botões de ação rápida (Iniciar, Parar, Reiniciar servidor)

Barra lateral esquerda

Dashboard — métricas gerais e ações rápidas
Players — jogadores conectados + banco de dados de todos os jogadores
History — histórico de ações administrativas (bans, kicks, avisos)
Whitelist — se a whitelist estiver habilitada
Resources — iniciar/parar/reiniciar scripts individuais
Server Log — saída do console em tempo real
Server.cfg Editor — edite seu arquivo de configuração principal com destaque de sintaxe
txAdmin Settings — configure o próprio painel

Console ao vivo

O Live Console é onde você vai passar a maior parte do seu tempo de depuração. Ele mostra a saída do servidor em tempo real: mensagens de chat, erros, avisos de recursos, conexões de jogadores.

Você pode digitar comandos do servidor diretamente no console — qualquer coisa que você digitaria via SSH funciona aqui. Exemplos:

ensure hz-weather     # iniciar um recurso
restart hz-weather    # reiniciar um recurso
stop hz-weather       # parar um recurso
status                    # mostrar status do servidor
players                   # listar jogadores conectados
quit                      # parar o servidor

Configurando o server.cfg pelo txAdmin

Seu server.cfg é o coração do seu servidor FiveM. Ele controla hostname, quantidade de slots, chave de licença, permissões de administração e quais recursos iniciar.

O editor integrado do txAdmin inclui destaque de sintaxe e um botão "Save & Restart".

Configurações essenciais do `server.cfg`

Aqui está um server.cfg mínimo para começar:

# Chave de licença do portal.cfx.re
sv_licenseKey "sua-chave-aqui"

Identidade do servidor
sv_hostname "^1Meu ^7Servidor ^2RP Incrível"
sv_projectName "MeuServidor"
sv_projectDesc "Uma comunidade RP amigável"
sv_maxClients 48

Configurações de endpoint
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

Tags do servidor (para o navegador FiveM)
sets tags "roleplay, qbcore, custom"
sets locale "en-US"

Conexão com banco de dados (MariaDB — para ESX/QBCore/QBox)
set mysql_connection_string "mysql://user:password@localhost/dbname?charset=utf8mb4"

OneSync (necessário para sincronização de jogadores no servidor)
set onesync on

Recursos — a ordem importa
ensure oxmysql
ensure ox_lib
ensure qb-core
ensure pma-voice
ensure hz-weather
ensure hz-television
... adicione mais recursos aqui

Ordem dos recursos

Os recursos são carregados na ordem em que aparecem no server.cfg. Dependências devem vir primeiro.

Ordem comum:

Banco de dados (oxmysql — o padrão moderno, substitui o mysql-async)

Bibliotecas (ox_lib, PolyZone)

Núcleo do framework (es_extended, qb-core, qbx_core)

Módulos do framework (profissões, banco, inventário)

Scripts standalone (HZ-Scripts, clima, TVs, áudio, etc.)

Por último (ferramentas de admin, mods opcionais)

Se você colocar ensure em um script antes da sua dependência, verá erros na inicialização. Ler o console com atenção mostra o que está faltando.

Gerenciando recursos

A aba Resources no txAdmin lista todos os recursos na sua pasta resources/, com seus status (iniciado/parado) e tempo de início.

Iniciar/parar/reiniciar pelo painel

Clique em qualquer recurso e use os botões:

Start — equivalente a ensure nome_do_recurso
Stop — equivalente a stop nome_do_recurso
Restart — para e depois inicia novamente

Reiniciar um recurso individual é muito mais rápido do que reiniciar o servidor inteiro. Use isso constantemente durante o desenvolvimento.

Atualizando a lista de recursos

Se você colocar uma nova pasta de recurso em resources/ e ela não aparecer no painel, clique em "Refresh". Isso faz uma nova varredura da pasta.

Erros comuns de recursos

A maioria dos erros de recursos aparece no console com tags [ERROR] ou [WARN]:

Could not find dependency — um recurso necessário não está rodando. Verifique a documentação do recurso para seus requisitos (geralmente ox_lib, oxmysql).
Script error: attempt to index a nil value — bug no script Lua. Leia o número da linha, abra o arquivo, investigue.
oxmysql: no connection — suas credenciais do MariaDB/MySQL no server.cfg estão erradas ou o banco de dados não está rodando.

Administração de jogadores

A aba Players mostra todos os conectados, além de um banco de dados pesquisável de todos os jogadores que já entraram.

Ações rápidas por jogador

Clique com o botão direito em qualquer jogador para:

Kick (com motivo)

Warn (registrado no histórico dele)

Ban (temporário ou permanente)

DM (mensagem direta no jogo)

Spectate (assistir o gameplay dele)

Teleport (ferramenta de admin)

Banimentos

Os banimentos do txAdmin armazenam a licença, IP, ID de hardware, Steam, Discord e identificadores Xbox Live do jogador. Um jogador banido não consegue voltar simplesmente mudando o IP ou a conta Steam — a menos que falsifique todo o ID de hardware.

Para máxima eficácia, aplique banimentos pelo txAdmin (não por comandos de chat no jogo) para que sejam persistidos no banco de dados do txAdmin.

Reinicializações automáticas e backups

Dois recursos que todo servidor deve habilitar: reinicializações agendadas e backups automáticos.

Reinicializações agendadas

Servidores FiveM acumulam memória lentamente ao longo do tempo. Uma reinicialização limpa a cada 6-12 horas mantém o desempenho estável.

Em Settings — Restarter:

Habilite "Scheduled Restarts"

Defina os horários de reinicialização (ex.: 06:00, 18:00, horário do servidor)

Configure avisos: o txAdmin vai transmitir mensagens no jogo 30, 15 e 5 minutos antes da reinicialização

Backups automáticos

O txAdmin pode fazer backup da sua pasta server-data + banco de dados MariaDB em um agendamento.

Em Settings — Backup:

Habilite "Auto Backup"

Defina a frequência (diário é recomendado)

Defina a retenção (mantenha 7-14 dias de backups)

Especifique o destino do backup (pasta local ou armazenamento compatível com S3)

Configure backups do MariaDB separadamente através do seu provedor de hospedagem ou com um cron job customizado de mariadb-dump. O txAdmin não faz backup do banco de dados automaticamente por padrão.

Permissões e cargos de administração

O txAdmin usa um sistema de permissões baseado em cargos. Os cargos padrão:

Owner — acesso total a tudo (o administrador inicial)
Admin — pode gerenciar jogadores, reiniciar recursos, editar server.cfg
Moderator — pode expulsar/banir jogadores, ver logs, mas não pode modificar a configuração do servidor
Cargos personalizados — você pode definir os seus

Adicionando novos administradores

Em Settings — Admin Management:

Clique em "Add Admin"

Insira o nome de usuário/email

Atribua um cargo

Eles receberão um link de convite para definir sua senha

Discord OAuth (recomendado)

Vincular contas de administração ao Discord OAuth é mais seguro do que senhas:

Nenhuma senha para vazar

Revogação mais fácil (basta remover do Discord)

Trilha de auditoria mais fácil (nomes de usuário do Discord nos logs)

Configure isso em Settings — Authentication.

Resolução de problemas comuns

O servidor não inicia

Sintoma: o txAdmin diz "Server start failed" ou trava na inicialização. Causas:

sv_licenseKey inválida — verifique em portal.cfx.re
Conflito de porta — outro processo está usando a porta 30120
Crash de recurso ao carregar — verifique o console para o último recurso que carregou

Solução: comece com um server.cfg mínimo (sem recursos exceto mapmanager, chat, spawnmanager). Adicione recursos de volta um por um até encontrar o culpado.

Não consigo acessar o painel web do txAdmin

Sintoma: http://seu-ip:40120 não carrega. Causas:

Firewall bloqueando a porta 40120
O txAdmin não está rodando (servidor não iniciado)
IP errado

Solução: acesse seu servidor via SSH, verifique netstat -tulpn | grep 40120 (Linux) para confirmar que o txAdmin está escutando. Abra a porta no seu firewall (ufw allow 40120/tcp no Ubuntu).

Jogadores não conseguem se conectar

Sintoma: jogadores recebem erros "Couldn't load resource" ou "Connection lost". Causas:

Um recurso falhou ao carregar — verifique o console por [ERROR]
O servidor está lotado — verifique sv_maxClients
O GTA V do jogador está desatualizado — peça para atualizar

Solução: leia o console do servidor quando o jogador tentar se conectar. O txAdmin mostra exatamente qual etapa falhou.

Erros de conexão com MariaDB

Sintoma: oxmysql: connection refused ou Access denied. Causas:

String de conexão errada no server.cfg
Servidor MariaDB não está rodando
Permissões de usuário incorretas

Solução: teste suas credenciais com HeidiSQL (incluído com MariaDB no Windows) ou DBeaver. Se funcionarem lá, o problema é a sintaxe do seu server.cfg.

Próximos passos

Agora que você conhece o txAdmin por dentro e por fora:

Escolha seu framework com sabedoria — Comparativo ESX vs QBCore vs QBox
Escolha seus primeiros scripts — Primeiros Scripts para Instalar no Seu Servidor FiveM
Monte seu catálogo de scripts — navegue pelos HZ-Scripts para recursos premium plug-and-play

O txAdmin é a peça mais subestimada do ecossistema FiveM. Domine-o cedo — você vai se agradecer quando estiver depurando um servidor de 64 jogadores às 2h da manhã com a comunidade do Discord perguntando "já voltou?"

FAQ

Consulte o FAQ acima de cada seção, ou navegue pelos guias relacionados para tópicos específicos.