Configurando seu servidor FiveM: chave de licença, server.cfg e recursos

Um servidor FiveM precisa de três coisas para funcionar: uma chave de licença Cfx.re gratuita, um server.cfg funcional e seus recursos (scripts, mapas e frameworks). Este guia acerta os três para que seu servidor inicialize e apareça na lista de servidores.

1. Gerar uma chave de licença Cfx.re

Todo servidor FiveM precisa de uma chave de licença do keymaster da Cfx.re — é grátis.

1. Vá para keymaster.fivem.net e faça login com sua conta Cfx.re (Fórum).
2. Clique em New server key / Register.
3. Para o IP, você pode registrar uma chave para o IP do seu servidor ou gerar uma chave não listada (adequado para a maioria das configurações). Nota: uma chave está vinculada à forma como você a registra, então se você mudar de servidor, pode precisar de uma nova chave.
4. Copie a chave — ela se parece com uma longa string aleatória.

2. Adicionar a chave ao server.cfg

1. Abra seu servidor e clique em File Manager.

2. Abra server.cfg na raiz.

3. Encontre a linha sv_licenseKey (ou adicione uma) e cole sua chave:

   sv_licenseKey sua_chave_aqui
   

4. Salve e reinicie na aba Console.

Sem uma chave válida, o console imprimirá Invalid license key e o servidor não ficará online.

3. Entender o server.cfg

server.cfg é o coração do seu servidor. As linhas que você mais usará:

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

sv_hostname "Meu Servidor FiveM ServerPrism"
sv_maxclients 32
sets locale "en-US"

# Carregar recursos
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure my-custom-resource

sv_licenseKey sua_chave_aqui

• sv_hostname — o nome do seu servidor no navegador de servidores FiveM.
• sv_maxclients — slots de jogadores (até 48 em builds padrão).
• ensure <name> — inicia um recurso na inicialização. É assim que você habilita scripts.

Não altere a porta do endpoint a menos que você conheça sua alocação. A porta do jogo FiveM é definida pela sua alocação ServerPrism — o padrão 30120 está correto para a maioria dos servidores. Verifique a aba Startup/Network se tiver dúvidas.

4. Adicionar recursos

Recursos (scripts, mapas, frameworks como ESX ou QBCore) vão na pasta resources/.

1. Faça upload da pasta do recurso para resources/ via File Manager ou SFTP (SFTP é melhor para grandes frameworks — veja File Manager & SFTP).
2. Adicione uma linha ensure <resource-name> ao server.cfg para cada um que você deseja executar.
3. Reinicie. Observe o console — cada recurso imprime Started resource <name> quando é carregado.

Para um framework de roleplay completo, instale seus recursos base na ordem especificada em sua documentação (geralmente um banco de dados + framework principal primeiro, depois scripts dependentes).

Bancos de dados (ESX/QBCore)

Frameworks de roleplay precisam de um banco de dados MySQL. Crie um na aba Databases e aponte a configuração do framework (geralmente via mysql_connection_string no server.cfg ou em um arquivo de configuração do framework) para as credenciais. Veja Criando e conectando a um banco de dados MySQL.

Peculiaridade do banco de dados no mesmo nó: se o seu DB e o servidor FiveM estiverem no mesmo nó e o framework não conseguir se conectar pelo IP público, abra um ticket de suporte — este é um caso de rede conhecido que podemos corrigir rapidamente interligando os contêineres.

Problemas comuns

• Invalid license key: a chave está errada, expirou ou foi registrada para um IP diferente — regenere-a no keymaster.
• Servidor não aparece no navegador: ainda está inicializando, sv_hostname não está definido ou um recurso está com erro — leia o console para o primeiro error.
• Um recurso falha ao iniciar: verifique o console para a primeira linha de erro sob esse recurso; geralmente é uma dependência ausente ou um banco de dados que não pode ser alcançado.
• Erros ghmattimysql/oxmysql: a string de conexão do banco de dados está errada — copie as credenciais novamente da aba Databases.

Ainda com problemas?

Abra um ticket de suporte com a primeira linha de error do seu console e o recurso que ela menciona. Podemos investigar a configuração diretamente no nó.