Como criar um servidor FiveM

O que precisas antes de começar

O FiveM é a framework de modificação que dá vida ao multijogador personalizado do GTA V. O software do servidor (FXServer) é gratuito; os jogadores entram a partir do cliente gratuito do FiveM, mas cada um deles precisa de uma cópia legítima do GTA V. Antes de construíres o que quer que seja, reúne o seguinte:

• Uma conta Cfx.re e uma chave de licença do servidor. Gratuita no keymaster e necessária para arrancar o servidor. Explicamos no próximo passo.
• Uma máquina que fica sempre ligada. O FiveM tem de funcionar sem parar numa ligação pública. Um PC de jogo em segunda mão serve para um teste em LAN, mas uma comunidade a sério precisa de uma máquina Linux permanente ou de alojamento — mais à frente explicamos porquê.
• Uma decisão sobre a framework. A maioria dos servidores usa ESX ou QBCore (empregos, dinheiro, inventário para roleplay); os servidores de freeroam e corridas costumam manter-se mais perto do standalone. Podes mudar de ideias mais tarde.
• Um pouco de tempo. Reserva uma hora para o teu primeiro arranque auto-alojado; um servidor gerido fica pronto em minutos.

O FiveM é mais pesado do que a maioria dos servidores de jogos — a RAM e a velocidade da CPU em thread único decidem quão fluido corre, muito mais do que o número bruto de jogadores. Um servidor leve ou vanilla contenta-se com 6 GB; um servidor ESX/QBCore ativo com 30-80 recursos quer 8 GB; um servidor de roleplay movimentado com mais de 200 recursos, MLOs personalizados e veículos em streaming precisa de 12-16 GB.

Passo 1: Obtém a tua chave de licença Cfx.re gratuita

Todos os servidores FiveM precisam de uma chave de licença. É gratuita e demora dois minutos.

1. Inicia sessão no keymaster. Vai a keymaster.fivem.net e inicia sessão com a tua conta Cfx.re (a do fórum).
2. Regista uma nova chave de servidor. Escolhe um rótulo, seleciona "I will run the server on a dedicated machine" (também serve para alojamento) e introduz o IP onde o servidor vai correr — ou gera uma chave portátil se o teu IP puder mudar.
3. Copia a chave. Vais colá-la no server.cfg como sv_licenseKey nos próximos passos.

Caminho A: Aloja o FiveM com FXServer e txAdmin

Este é o caminho completo, com software livre. O FXServer moderno arranca diretamente no txAdmin, um painel web que configura e gere o servidor por ti, por isso a maior parte do trabalho acontece no navegador. Estes passos são para uma máquina Linux (a escolha realista para um servidor público); no Windows segue-se o mesmo esquema com o artifact para Windows.

1. Descarrega os artifacts do FXServer. Obtém a build recomendada mais recente na página de artifacts do FiveM (Linux ou Windows) e descompacta-a numa pasta vazia — este é o runtime do servidor.
2. Obtém os recursos base. Clona os dados iniciais oficiais ao lado dos artifacts, para que o servidor tenha uma base de recursos para carregar:

   git clone https://github.com/citizenfx/cfx-server-data.git server-data

3. Arranca o FXServer para abrir o txAdmin. A partir da pasta dos artifacts, executa o servidor apontando para uma pasta de dados. Abre o txAdmin e mostra um PIN de uso único e um endereço web (porta predefinida 40120):

   ./run.sh +set serverProfile default +set txAdminPort 40120

   Abre esse endereço num navegador, introduz o PIN e cria a tua conta de administrador.
4. Executa o assistente de configuração. No txAdmin, inicia uma nova implementação: aponta-a ao teu server-data, cola a tua chave de licença Cfx.re do Passo 1 e deixa-o construir o teu server.cfg. Define o nome do servidor, o sv_maxclients (até 32 com a chave gratuita) e uma ligação à base de dados se a tua framework precisar.
5. Confirma os endpoints e a licença. O teu server.cfg deve conter o essencial — o txAdmin trata disto, mas vale a pena saber o que escreve:

   endpoint_add_tcp "0.0.0.0:30120"
   endpoint_add_udp "0.0.0.0:30120"
   sv_licenseKey "your_key_here"
   sv_hostname "My FiveM Server"
   sv_maxclients 32
   ensure mapmanager
   ensure chat
   ensure spawnmanager
   ensure sessionmanager

6. Abre a porta 30120. O FiveM usa a porta 30120 tanto em TCP como em UDP. Numa ligação doméstica, entra no teu router, encontra a secção Port Forwarding e reencaminha TCP e UDP 30120 para a máquina que executa o servidor (atribui-lhe primeiro um IP local estático).
   Atenção: abrir uma porta torna público o IP da tua casa, e os servidores FiveM são um alvo preferido de ataques. Um único booter pode deitar abaixo a ligação de toda a tua casa, e uma linha doméstica não tem nada à frente. Só faças auto-alojamento público se compreenderes esse risco.

   

Isto já é um servidor a funcionar. Antes de o tornares permanente, pesa o que o auto-alojamento realmente te custa:

Caminho B: Aluga um servidor FiveM gerido (online em minutos)

Um servidor gerido é o mesmo FXServer a correr num datacenter em vez de em tua casa — sempre ligado, por trás de proteção DDoS a sério, com o txAdmin e os artifacts mais recentes já instalados. Tudo o que é trabalhoso no Caminho A (artifacts, endpoints, manter a máquina acordada) fica tratado. Aqui está a configuração completa:

1. Escolhe um tamanho. Na página de alojamento FiveM, escolhe um plano por RAM: 6 GB para um servidor leve ou inicial, 8 GB para uma comunidade ESX/QBCore ativa, 12-16 GB para roleplay exigente. Os planos começam em poucos euros por mês e cada um inclui uma base de dados MySQL.
2. Finaliza a compra. O servidor é aprovisionado automaticamente poucos minutos após o pagamento — o FXServer, o txAdmin e os artifacts mais recentes do FiveM são instalados por ti. Os dados do teu painel chegam por email.
3. Abre o txAdmin. Entra no painel, cola a tua chave de licença Cfx.re do Passo 1, define o nome do servidor e os slots, e arranca o servidor. Não há nada para descarregar nem qualquer porta para abrir.
4. Adiciona a tua framework. Carrega ou instala ESX ou QBCore através do gestor de ficheiros ou por SFTP, liga-a à base de dados incluída e ativa-a com ensure na tua configuração — o painel torna o acesso à base de dados e aos ficheiros um só clique.
5. Convida os jogadores. Partilha o teu endereço para que as pessoas possam fazer connect no cliente FiveM, ou distribui o teu link de junção cfx.re. Os amigos que ajudam a gerir o servidor podem ter o seu próprio acesso como subutilizador do painel, em vez da tua palavra-passe.

Aquilo que estás a pagar, em concreto: o servidor mantém-se online com um objetivo de 99,9% de uptime quer o teu PC esteja ligado ou não, a proteção DDoS Voxility de mais de 1 Tbps absorve ataques que deitariam abaixo uma linha doméstica, os ficheiros ficam em NVMe SSD com CPUs de alta frequência (a velocidade em thread único de que o FiveM vive), os nós na UE mantêm o ping baixo na Roménia, na Moldávia e nos Balcãs, e o suporte por chat ao vivo está disponível das 8:00 às 23:00 (hora de Chișinău). Migrar um servidor existente é grátis.

Frameworks e recursos: ESX, QBCore e adicionar scripts

Um servidor FiveM vazio é uma cidade deserta. As frameworks e os recursos são o que o transformam num mundo de roleplay, num servidor de drift ou numa liga de corridas.

• ESX — a framework de roleplay há mais tempo estabelecida: empregos, dinheiro, inventário e uma enorme biblioteca de scripts da comunidade. Madura e amplamente documentada.
• QBCore — a favorita moderna para os novos servidores de roleplay, em desenvolvimento ativo, com uma estrutura limpa e um vasto ecossistema de empregos e sistemas já prontos.
• Standalone — sem qualquer framework. Ideal para servidores de freeroam, corridas ou minijogos que não precisam de dinheiro e empregos.

Adicionar um recurso segue sempre o mesmo padrão: coloca a pasta do recurso no diretório resources/ do teu servidor e depois carrega-o no server.cfg com uma única linha:

ensure resource-name

Reinicia o servidor (ou atualiza e inicia o recurso a partir do txAdmin) e fica ativo. As frameworks que guardam dados — dinheiro, personagens, veículos — precisam de uma base de dados MySQL e do recurso oxmysql para comunicar com ela, que é exatamente por isso que uma base de dados está incluída nos nossos planos FiveM.

Mantém o teu servidor online e seguro

Algumas coisas separam um servidor FiveM que dura de um que morre na primeira semana:

• Leva o DDoS a sério. Os servidores FiveM são atacados constantemente, sobretudo os de roleplay competitivo. Uma ligação doméstica não tem proteção; o alojamento em datacenter coloca uma filtragem dedicada (Voxility, no nosso caso) entre a internet e o teu servidor.
• Faz backup da tua base de dados e dos teus recursos. A tua base de dados MySQL guarda cada personagem, emprego e veículo — é a única coisa que não podes voltar a descarregar. Faz-lhe um snapshot antes de adicionares ou atualizares um recurso grande.
• Conhece o teu limite real de slots. O sv_maxclients pode ser posto mais alto, mas a chave gratuita Cfx.re limita-te a 32 jogadores de qualquer forma — só o aumentes depois de melhorares a tua própria chave Element Club.
• Mantém os artifacts atualizados, mas não na última versão acabada de sair. Fica-te pelas builds de artifacts recomendadas; as totalmente novas podem partir recursos. Nos planos geridos, isto é tratado por ti.