ACLClouds
ACLClouds

Criar um servidor FiveM: licença, txAdmin e recursos

Chave de licença Cfx.re, txAdmin, server.cfg, framework ESX ou QBCore: os passos para lançar um servidor FiveM bem configurado e mantê-lo estável.

Um servidor FiveM dá vida a uma comunidade de roleplay em GTA V, com regras, scripts e veículos próprios. Antes de convidar os jogadores, há três elementos que devem estar prontos: uma chave de licença válida, uma ferramenta de administração e uma lista de recursos bem controlada.

  • Um servidor FiveM precisa de uma chave de licença gratuita, criada no portal Cfx.re.
  • O txAdmin, incluído com o FiveM, gere as receitas, os reinícios agendados e a moderação.
  • Cada recurso coloca-se em resources e declara-se depois com ensure em server.cfg.
  • Adicione os scripts um a um e leia a consola após cada reinício.

O que é preciso antes de começar

O FiveM é a plataforma multijogador da Cfx.re para GTA V. Cada jogador tem de possuir o jogo no PC, e o servidor precisa de uma chave de licença. Esta chave é gratuita: cria-se com a sua conta no portal Cfx.re. Convém também prever uma base de dados MySQL ou MariaDB caso pretenda usar um framework de roleplay.

  • Uma conta Cfx.re para criar a chave de licença do servidor.
  • GTA V no PC para cada jogador.
  • Uma base de dados MySQL ou MariaDB para ESX, QBCore ou Qbox.
  • Um nome de servidor, uma descrição e regras claras.

Criar e introduzir a chave de licença

No portal Cfx.re, crie uma chave para o servidor e associe-a ao respetivo endereço se o formulário o pedir. No painel, a chave introduz-se nos parâmetros de arranque (sv_licenseKey) antes do primeiro lançamento: sem ela, o servidor não arranca. O guia para configurar uma chave de licença ou um token detalha cada passo.

  • Copie a chave completa, sem espaços nem aspas.
  • Reinicie e leia a consola: um erro de token indica uma chave inválida ou associada a outro endereço.
  • Nunca publique a chave numa captura de ecrã ou num repositório público.

txAdmin, a interface de administração

O txAdmin vem incluído com o FiveM. Esta interface web serve para instalar uma receita de servidor (uma base pronta a usar com o respetivo framework), agendar reinícios, acompanhar os jogadores ligados e gerir banimentos. Complementa a consola, o gestor de ficheiros e os parâmetros de arranque do painel ACLClouds, sem os substituir.

  • Receitas: uma instalação inicial com ESX, QBCore ou um servidor vazio.
  • Reinícios agendados, com avisos enviados aos jogadores.
  • Moderação: avisos, expulsões e banimentos a partir do navegador.
  • Gestão de administradores, com permissões por membro da equipa.

Adicionar recursos sem comprometer o servidor

Um recurso é uma pasta que contém um manifesto (fxmanifest.lua) e os respetivos scripts Lua, JavaScript ou C#. Coloque-o na pasta resources com o gestor de ficheiros e declare-o depois em server.cfg com uma linha ensure. A ordem conta: um recurso deve arrancar depois daqueles de que depende, a começar pelo framework e pela ligação à base de dados.

  • Um recurso de cada vez, com um reinício e uma leitura da consola entre cada adição.
  • Scripts de fontes conhecidas, compatíveis com a versão do framework utilizada.
  • Uma cópia de server.cfg antes de cada alteração importante.

Manter o servidor estável

A maioria das falhas resulta de um script incompatível, de uma dependência em falta ou de uma base de dados inacessível. A consola do painel mostra estes erros no arranque: leia o primeiro, não o último. Faça cópias de segurança dos ficheiros e da base de dados e guarde uma cópia fora do servidor, como recomenda a regra das cópias de segurança 3-2-1. Quando os jogadores e os scripts se multiplicam, compare os planos FiveM e mude para um plano com mais RAM e vCPU.

  • Ler o primeiro erro da consola após um arranque falhado.
  • Fazer cópia de segurança dos ficheiros e da base de dados antes de cada atualização.
  • Mudar de plano quando a memória ou o CPU saturam nas horas de ponta.
  • Proteção anti-DDoS incluída em cada servidor de jogo ACLClouds.

Perguntas frequentes

A chave de licença FiveM é paga?

Não. A chave de licença base é gratuita e cria-se com a sua conta no portal Cfx.re. Introduz-se nos parâmetros de arranque do servidor antes do primeiro lançamento.

É preciso usar o txAdmin?

Não é obrigatório, mas é a ferramenta de administração incluída com o FiveM. Simplifica a instalação de uma receita, os reinícios agendados e a moderação dos jogadores.

ESX ou QBCore para começar?

Ambos são adequados. O ESX dispõe de um vasto catálogo de scripts, enquanto o QBCore e o seu derivado Qbox são mais recentes. Escolha o framework suportado pelos seus scripts e mantenha-o: mudar obriga a adaptar todos os scripts.

Porque é que o meu servidor FiveM não arranca?

Verifique primeiro a chave de licença e depois o primeiro erro apresentado na consola: um recurso não encontrado, uma dependência em falta ou uma base de dados inacessível são as causas habituais.