Como criar um servidor FiveM

O que você precisa antes de começar

O FiveM é o framework de modificação que dá vida ao multiplayer personalizado do GTA V. O software do servidor (FXServer) é gratuito; os jogadores entram pelo cliente gratuito do FiveM, mas cada um deles precisa de uma cópia legítima do GTA V. Antes de construir qualquer coisa, deixe isto pronto:

• Uma conta Cfx.re e uma chave de licença do servidor. Gratuita no keymaster e necessária para iniciar o servidor. Explicamos no próximo passo.
• Uma máquina que fica sempre ligada. O FiveM precisa rodar sem parar em uma conexão pública. Um PC gamer reserva serve para um teste em LAN, mas uma comunidade de verdade precisa de uma máquina Linux permanente ou de hospedagem — mais adiante explicamos por quê.
• Uma decisão de framework. A maioria dos servidores usa ESX ou QBCore (empregos, dinheiro, inventário para roleplay); os servidores de freeroam e corrida costumam ficar mais perto do standalone. Você pode mudar de ideia depois.
• Um pouco de tempo. Reserve uma hora para o seu primeiro boot auto-hospedado; um servidor gerenciado 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 o quão fluido ele roda, muito mais do que o número bruto de jogadores. Um servidor leve ou vanilla se contenta 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: Obtenha a sua chave de licença Cfx.re gratuita

Todo servidor FiveM precisa de uma chave de licença. Ela é gratuita e leva dois minutos.

1. Faça login no keymaster. Acesse keymaster.fivem.net e entre com a sua conta Cfx.re (a do fórum).
2. Registre uma nova chave de servidor. Escolha um rótulo, marque "I will run the server on a dedicated machine" (também funciona para hospedagem) e informe o IP onde o servidor vai rodar — ou gere uma chave portátil se o seu IP puder mudar.
3. Copie a chave. Você vai colá-la no server.cfg como sv_licenseKey nos próximos passos.

Caminho A: Hospede o FiveM com FXServer e txAdmin

Este é o caminho completo, com software livre. O FXServer moderno inicia direto no txAdmin, um painel web que configura e roda o servidor para você, então 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 formato com o artifact do Windows.

1. Baixe os artifacts do FXServer. Pegue a build recomendada mais recente na página de artifacts do FiveM (Linux ou Windows) e descompacte-a em uma pasta vazia — este é o runtime do servidor.
2. Obtenha os recursos base. Clone 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. Inicie o FXServer para abrir o txAdmin. Na pasta dos artifacts, execute o servidor apontando para uma pasta de dados. Ele abre o txAdmin e mostra um PIN de uso único e um endereço web (porta padrão 40120):

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

   Abra esse endereço em um navegador, informe o PIN e crie a sua conta de administrador.
4. Execute o assistente de configuração. No txAdmin, inicie um novo deployment: aponte-o para o seu server-data, cole a sua chave de licença Cfx.re do Passo 1 e deixe-o montar o seu server.cfg. Defina o nome do servidor, o sv_maxclients (até 32 com a chave gratuita) e uma conexão de banco de dados se o seu framework precisar.
5. Confirme os endpoints e a licença. O seu server.cfg deve conter o essencial — o txAdmin cuida disso, mas vale saber o que ele 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. Libere a porta 30120. O FiveM usa a porta 30120 tanto em TCP quanto em UDP. Em uma conexão residencial, acesse o seu roteador, encontre a seção Port Forwarding e encaminhe TCP e UDP 30120 para a máquina que roda o servidor (dê a ela primeiro um IP local fixo).
   Atenção: abrir uma porta torna público o IP da sua casa, e os servidores FiveM são um alvo preferido de ataques. Um único booter pode derrubar a internet da sua casa inteira, e uma linha residencial não tem nada na frente. Só faça auto-hospedagem pública se você entender esse risco.

   

Isso já é um servidor funcionando. Antes de torná-lo permanente, pese o que a auto-hospedagem realmente custa a você:

Caminho B: Alugue um servidor FiveM gerenciado (online em minutos)

Um servidor gerenciado é o mesmo FXServer rodando em um datacenter em vez da sua casa — sempre ligado, atrás de proteção DDoS de verdade, com o txAdmin e os artifacts mais recentes já prontos. Tudo o que é trabalhoso no Caminho A (artifacts, endpoints, manter a máquina acordada) já está resolvido. Aqui está a configuração inteira:

1. Escolha um tamanho. Na página de hospedagem FiveM, escolha 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 pesado. Os planos começam em poucos euros por mês e cada um inclui um banco de dados MySQL.
2. Finalize a compra. O servidor é provisionado automaticamente poucos minutos após o pagamento — o FXServer, o txAdmin e os artifacts mais recentes do FiveM são instalados para você. Os dados do seu painel chegam por email.
3. Abra o txAdmin. Entre no painel, cole a sua chave de licença Cfx.re do Passo 1, defina o nome do servidor e os slots, e inicie o servidor. Não há nada para baixar nem porta para liberar.
4. Adicione o seu framework. Envie ou instale ESX ou QBCore pelo gerenciador de arquivos ou via SFTP, conecte-o ao banco de dados incluído e ative-o com ensure na sua configuração — o painel deixa o acesso ao banco de dados e aos arquivos a um clique.
5. Convide os jogadores. Compartilhe o seu endereço para que as pessoas possam fazer connect no cliente FiveM, ou distribua o seu link de entrada cfx.re. Os amigos que ajudam a administrar o servidor podem ter o próprio acesso como subusuário do painel, em vez da sua senha.

O que você está pagando, na prática: o servidor permanece online com uma meta de 99,9% de uptime esteja o seu PC ligado ou não, a proteção DDoS Voxility de mais de 1 Tbps absorve ataques que derrubariam uma linha residencial, os arquivos ficam em NVMe SSD com CPUs de alto clock (a velocidade em thread único da qual o FiveM depende), os nós na UE mantêm o ping baixo na Romênia, na Moldávia e nos Bálcãs, e o suporte por chat ao vivo está disponível das 8h às 23h (horário 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. Os frameworks e os recursos são o que o transformam em um mundo de roleplay, um servidor de drift ou uma liga de corrida.

• ESX — o framework de roleplay mais estabelecido: empregos, dinheiro, inventário e uma enorme biblioteca de scripts da comunidade. Maduro e amplamente documentado.
• QBCore — o favorito moderno para os novos servidores de roleplay, em desenvolvimento ativo, com uma estrutura limpa e um grande ecossistema de empregos e sistemas prontos.
• Standalone — sem framework nenhum. Ideal para servidores de freeroam, corrida ou minigames que não precisam de dinheiro e empregos.

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

ensure resource-name

Reinicie o servidor (ou atualize e inicie o recurso pelo txAdmin) e ele fica ativo. Os frameworks que armazenam dados — dinheiro, personagens, veículos — precisam de um banco de dados MySQL e do recurso oxmysql para se comunicar com ele, que é exatamente por isso que um banco de dados vem incluído nos nossos planos FiveM.

Mantenha o seu servidor online e seguro

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

• Leve o DDoS a sério. Os servidores FiveM são atacados o tempo todo, principalmente os de roleplay competitivo. Uma conexão residencial não tem proteção; a hospedagem em datacenter coloca uma filtragem dedicada (Voxility, no nosso caso) entre a internet e o seu servidor.
• Faça backup do seu banco de dados e dos seus recursos. O seu banco de dados MySQL guarda cada personagem, emprego e veículo — é a única coisa que você não consegue baixar de novo. Tire um snapshot antes de adicionar ou atualizar um recurso grande.
• Conheça o seu limite real de slots. O sv_maxclients pode ser configurado mais alto, mas a chave gratuita Cfx.re limita você a 32 jogadores de qualquer jeito — só aumente depois de fazer upgrade da sua própria chave Element Club.
• Mantenha os artifacts atualizados, mas não na versão recém-lançada. Fique com as builds de artifacts recomendadas; as totalmente novas podem quebrar recursos. Nos planos gerenciados, isso é cuidado para você.