A licença do FiveM é obrigatória para publicar e iniciar corretamente um servidor na plataforma Cfx.re. Ela identifica o servidor, permite que ele se comunique com os serviços do FiveM e ajuda a controlar recursos oficiais. Quando a licença está errada, vencida, exposta ou vinculada de forma incorreta, o servidor pode não aparecer na lista, falhar na inicialização ou apresentar mensagens de autenticação no console. Por isso, configurar o Keymaster com atenção é uma etapa básica para qualquer cidade em VPS.
O que é o Keymaster
Keymaster é a área oficial da Cfx.re onde você cria e gerencia chaves de licença para servidores FiveM. A chave gerada é colocada no server.cfg por meio da configuração sv_licenseKey. Essa chave deve ser tratada como informação sensível. Não publique em prints, repositórios, grupos ou arquivos compartilhados com pessoas sem responsabilidade técnica.
Antes de gerar a chave
Tenha em mãos a conta Cfx.re correta, o IP público da VPS e a informação do tipo de servidor. Use uma conta que pertença ao dono ou gestor oficial do projeto, não a um desenvolvedor temporário. Se a chave ficar na conta de alguém que sai da equipe, a cidade pode ter problemas para trocar, auditar ou recuperar acesso depois.
Como aplicar no server.cfg
Depois de criar a chave, adicione no arquivo server.cfg. Evite espaços extras, aspas erradas ou caracteres invisíveis. Um exemplo simples é:
sv_licenseKey sua_chave_aquiReinicie o servidor após alterar. Se o console apontar erro de licença, confira se a chave foi copiada inteira, se pertence ao IP correto e se não foi revogada. Em VPS com troca de IP, você pode precisar gerar ou ajustar a chave.
Servidor não aparece na lista
A licença é apenas uma parte do processo. Se o servidor não aparece na lista pública, também confira endpoints, firewall, porta UDP e TCP, tags, nome do servidor e conexão externa. Muitos donos culpam a licença, mas o problema está na porta bloqueada. A porta padrão 30120 precisa estar liberada corretamente na VPS e, se houver painel de rede do provedor, nas regras externas também.
Segurança da chave
Não coloque a chave em repositório público. Se sua equipe usa Git, adicione arquivos sensíveis ao ignore ou separe configurações privadas. Se a chave vazar, gere uma nova e substitua imediatamente. Em prints para suporte, oculte a chave. O mesmo cuidado vale para senhas de banco, tokens de bots e webhooks do Discord.
Organização para equipes
Em projetos sérios, documente quem criou a chave, em qual conta, para qual IP e quando foi alterada. Isso facilita auditoria e migração. Se a cidade trocar de VPS, registre a data da mudança e teste o servidor antes de anunciar abertura. Uma falha simples de licença pode atrasar evento, wipe ou inauguração.
Erros comuns
- Usar chave criada em conta pessoal de ex-desenvolvedor.
- Copiar a chave com espaço ou quebra indevida.
- Trocar IP da VPS e esquecer de ajustar licença.
- Publicar
server.cfgcom chave em repositório. - Confundir erro de firewall com erro de Keymaster.
- Usar artifact antigo e ignorar avisos do console.
Checklist rápido
Antes de abrir a cidade, confirme chave válida, IP correto, server.cfg salvo, portas liberadas, servidor reiniciado e console sem erro de autenticação. Depois teste conexão direta pelo FiveM e verifique se o servidor aparece corretamente. Faça esse teste antes de divulgar horário de abertura.
Conclusão
Configurar Keymaster e licença do FiveM é simples, mas precisa de cuidado. A chave é parte crítica da identidade do servidor e deve ficar protegida. Em VPS, combine licença correta com firewall, endpoints, organização de arquivos e documentação da equipe. Assim você evita problemas de publicação, atrasos e exposição de dados sensíveis.
