ACLClouds
ACLClouds

Como ativar o txAdmin e instalar uma receita num servidor FiveM?

Ativar o txAdmin a partir da página Arranque, entrar com o código PIN, implementar uma receita ESX ou QBCore, atualizar os artifacts e fazer o servidor

O txAdmin é o painel de administração web incluído com o servidor FiveM (FXServer). Instala uma receita de servidor, reinicia o servidor a horas fixas, mostra os jogadores ligados e gere os banimentos. Na ACLClouds está desativado por predefinição: o servidor executa diretamente server.cfg. Depois de ativado, é o txAdmin que inicia o FXServer, numa porta reservada ao seu servidor.

Procedimento passo a passo

  1. Ativar o txAdmin

    Pare o servidor, abra «Arranque» e mude a variável «Enable txadmin» (TXADMIN_ENABLE) para 1. A variável «txAdmin Port» não pode ser alterada: essa porta foi reservada para o seu servidor na criação e aparece em «Rede», ao lado da porta principal.

  2. Obter o endereço e o código PIN

    Inicie o servidor e leia a consola. O txAdmin mostra o endereço da sua interface, http://IP:PORT com a porta do txAdmin, e um código PIN de 4 algarismos enquanto nenhum administrador estiver registado.

  3. Criar a conta de administrador

    Abra esse endereço no navegador, introduza o PIN, associe a sua conta Cfx.re e escolha uma palavra-passe de recurso. Esta primeira conta é a conta «master»: tem todas as permissões e pode convidar o resto da equipa.

  4. Implementar uma receita

    O assistente propõe uma receita popular (CFX Default, ESX Legacy, QBCore…), um modelo por URL ou uma pasta de servidor existente. Para ESX ou QBCore, crie primeiro uma base em «Bases de dados» e indique o anfitrião, o utilizador, a palavra-passe e o nome quando o implementador os pedir.

  5. Verificar a porta do jogo

    Antes de iniciar o servidor, abra o server.cfg da receita no editor do txAdmin: as linhas endpoint_add_tcp e endpoint_add_udp devem usar a porta principal indicada em «Rede». Substitua 30120 se não for a sua porta.

  6. Iniciar e verificar

    Inicie o servidor a partir do txAdmin e aguarde a linha Server license key authentication succeeded na consola em direto. Depois ligue-se no jogo com o endereço IP e a porta principal.

Linhas do server.cfg a verificar

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
sv_hostname "My RP server"
sets sv_projectName "My RP server"
sets sv_projectDesc "Serious roleplay, whitelist open"
sets locale "fr-FR"
sets tags "roleplay, esx, serious"
sv_maxclients 48
load_server_icon logo.png

O que o txAdmin muda na ACLClouds

Sem txAdmin, o comando de arranque executa o server.cfg na raiz do servidor, e o painel reescreve nele, em cada arranque, o nome, o número de vagas, a chave de licença e as linhas endpoint a partir das variáveis de «Arranque». Com o txAdmin, o FXServer carrega o server.cfg da receita, guardado na pasta txData: esse ficheiro edita-se no editor do txAdmin ou em «Ficheiros».

As duas ferramentas complementam-se: o painel mantém a consola, os ficheiros, as cópias de segurança e as variáveis de arranque; o txAdmin acrescenta as receitas, os reinícios agendados, a lista de jogadores e a moderação.

  • A porta do txAdmin é atribuída automaticamente na criação do servidor e não muda.
  • Os dados do txAdmin (contas, banimentos, definições) estão na pasta txData: inclua-a nas suas cópias de segurança.
  • O modelo RedM atual executa diretamente server.cfg, sem opção txAdmin.

Atualizar os artifacts do FiveM

Os artifacts são os ficheiros do servidor FXServer, publicados pela Cfx.re como builds numeradas; o txAdmin vem incluído com eles. A variável «fivem version» (FIVEM_VERSION) escolhe a versão instalada: recommended (predefinida), latest ou um número de build específico retirado da página de artifacts para Linux.

A versão só muda na instalação: altere a variável, faça uma cópia de segurança e execute «Definições» > «Reinstalar o servidor». O script descarrega os novos artifacts e mantém o server.cfg existente. Um número de build que não é encontrado volta a recommended.

  • Mantenha recommended num servidor em produção e teste latest num servidor à parte.
  • Depois de uma atualização, leia a consola: um recurso antigo pode exigir uma versão mais recente do seu framework.

Fazer o servidor aparecer na lista do FiveM

A lista de servidores do FiveM mostra os servidores com uma chave de licença válida que se anunciam à Cfx.re. O servidor aparece normalmente alguns minutos depois de arrancar. Para ser encontrado, cuide das variáveis sets do server.cfg: nome do projeto, descrição, idioma e tags servem para os filtros e a pesquisa.

  • sv_master1 "" retira o servidor da lista: apague ou comente esta linha num servidor público.
  • load_server_icon logo.png mostra um ícone PNG de 96 × 96 píxeis colocado ao lado do server.cfg.
  • sv_endpointPrivacy true oculta o endereço IP do servidor na lista.

Que plano para um servidor FiveM?

A 17 de novembro de 2026, três planos da ACLClouds suportam FiveM: Dev (2,5 vCPU, 6 GB de RAM, 50 GB de armazenamento, 1 base de dados) a 2,49 € por mês com IVA sem fidelização, City (4,5 vCPU, 10 GB de RAM, 80 GB, 2 bases) a 5,49 € e Empire (7 vCPU, 16 GB de RAM, 120 GB, 3 bases) a 9,99 €, ou 1,99 €, 4,39 € e 7,99 € por mês com fidelização de um ano. Uma receita ESX ou QBCore com algumas dezenas de scripts cabe no City; o Dev serve para testes e pequenos grupos.

Verificação rápida

  • A consola mostra o endereço do txAdmin com a porta indicada em «Rede».
  • A conta master consegue entrar no txAdmin.
  • As linhas endpoint do server.cfg usam a porta principal.
  • O servidor responde no jogo e aparece na lista do FiveM.

Perguntas frequentes

A página do txAdmin não abre, o que verificar?

Utilize a porta do txAdmin indicada na consola e em «Rede», não a porta do jogo, com um endereço em http:// e não https://. Confirme também que TXADMIN_ENABLE está a 1 e que o servidor foi reiniciado depois da alteração.

Perdi o código PIN, como obtenho outro?

Enquanto nenhuma conta for criada, o txAdmin mostra um PIN em cada arranque: reinicie o servidor e volte a ler a consola.

Perdi o acesso à conta master, o que fazer?

Pare o servidor, abra «Ficheiros», apague txData/admins.json e reinicie: o txAdmin considera que não existe nenhum administrador e mostra um novo PIN. As receitas, as definições e os banimentos mantêm-se; as outras contas de administrador têm de ser criadas de novo.

O servidor arranca mas ninguém se consegue ligar, porquê?

O server.cfg de uma receita escuta muitas vezes na 30120. Substitua essa porta pela porta principal de «Rede» nas linhas endpoint_add_tcp e endpoint_add_udp e reinicie a partir do txAdmin.

É possível voltar a arrancar sem txAdmin?

Sim. Volte a pôr TXADMIN_ENABLE a 0: o servidor executa de novo o server.cfg da raiz. Copie para lá as suas linhas ensure e definições se as tinha alterado no da receita.