Keymaster FiveM: o que é e como ativar seus scripts

Se você já comprou um script protegido para o seu servidor de FiveM e ficou sem saber onde ele está, por que não inicia ou como se ativa, a resposta quase sempre passa pelo mesmo lugar: o Keymaster FiveM, o painel da Cfx.re. Ele gerencia a licença do servidor e as permissões dos assets que você compra, e entendê-lo bem evita a maioria dos problemas clássicos de quem monta uma cidade de roleplay. Neste guia você vê o que ele é, como registrar o servidor, como ativar os scripts comprados e o que fazer quando algo falha.

Como funciona o Keymaster FiveM e para que serve?

O Keymaster é o portal oficial da Cfx.re (portal.cfx.re) onde você gerencia as licenças do servidor de FiveM e os asset grants, as permissões de uso dos scripts protegidos que você compra. Sem licença válida o servidor não sobe, e sem o grant correspondente um script protegido não executa.

Antes ele vivia em um domínio próprio (keymaster.fivem.net), mas hoje está integrado ao portal geral da Cfx.re, junto com as demais ferramentas para donos de servidor.

Na prática, o Keymaster cumpre duas funções que afetam diretamente quem administra um servidor.

Licenças de servidor

Todo servidor de FiveM precisa de uma chave de licença para iniciar e aparecer na lista pública. Essa chave é gerada de graça no portal, fica vinculada à sua conta Cfx.re e só pode estar ativa em um servidor por vez. É o que você escreve na variável sv_licenseKey do server.cfg, e também o que identifica o seu servidor perante os serviços da Cfx.re a cada inicialização.

Asset grants

Um asset grant é a permissão de uso sobre um recurso protegido. Quando você compra um script cifrado com o escrow oficial do FiveM, o criador não envia o código-fonte: ele concede um grant associado à sua conta Cfx.re. Esse grant é o que autoriza os seus servidores a baixar, decifrar e executar o recurso. Você vê todos os seus grants na seção de assets do portal, com a data de concessão e o criador que os emitiu.

A combinação das duas coisas é o que faz o sistema funcionar: o servidor se identifica com a licença, o Keymaster verifica quais grants a conta dona dessa licença possui, e só então libera a execução dos recursos protegidos.

Como criar a conta e registrar o servidor?

Para registrar o servidor, crie uma conta em forum.cfx.re, entre em portal.cfx.re, gere uma chave de licença na seção de servidores, copie-a (as atuais começam com cfxk_) e cole em sv_licenseKey no server.cfg. O processo é gratuito, não exige pagamento e leva poucos minutos, desde que você use a mesma conta Cfx.re das suas compras. Os passos:

1. Crie uma conta no fórum da Cfx.re (forum.cfx.re), caso ainda não tenha. É a mesma conta usada em todo o ecossistema.
2. Acesse portal.cfx.re e entre com essa conta.
3. Vá até a seção de servidores e gere uma nova chave de licença. O portal pede alguns dados básicos sobre o tipo de servidor.
4. Copie a chave gerada (as atuais começam com cfxk_) e cole no seu server.cfg.

O resultado na configuração deve ficar assim:

sv_licenseKey "cfxk_xxxxxxxxxxxxxxxxxxxx_xxxxx"
sv_hostname "Meu Servidor Roleplay"
sv_maxclients 48

Se você usa txAdmin, nem precisa editar o arquivo à mão: o assistente de configuração inicial pede a chave e a coloca para você. Se o servidor ainda não está montado, comece pelo guia completo de como criar servidor FiveM, que cobre esse passo dentro do processo inteiro.

Um detalhe importante: trate a sv_licenseKey como uma senha. Se você compartilhar o server.cfg no Discord ou em um fórum para pedir ajuda, apague a chave antes. Quem tiver a chave pode subir um servidor se passando pelo seu, e você terá de gerar outra no portal.

Como os asset grants funcionam ao comprar um script protegido?

Ao comprar um script protegido em uma loja com Tebex, o grant é atribuído à conta Cfx.re que você confirmou no checkout e aparece no seu Keymaster em poucos minutos. Depois você baixa o recurso, adiciona o ensure e reinicia: o servidor se autentica com a sv_licenseKey e valida o grant sozinho.

O fluxo típico em uma loja séria que vende via Tebex é este:

1. Você adiciona o script ao carrinho e vai ao checkout do Tebex.
2. Durante o pagamento, vincula ou confirma a sua conta Cfx.re. Esse passo é crítico: o grant será atribuído exatamente a essa conta.
3. Conclui o pagamento e recebe o e-mail de confirmação com o ID da transação.
4. Em poucos minutos, o grant aparece no seu Keymaster e você pode baixar o pacote do recurso.
5. Coloca a pasta em resources, adiciona o ensure correspondente e reinicia o servidor.

Quando o servidor inicia, ele se autentica com a sv_licenseKey, o Keymaster verifica se a conta dona tem o grant do asset e o runtime decifra e executa o recurso protegido (o arquivo .fxap que você vê dentro da pasta faz parte desse mecanismo de cifragem). Tudo acontece de forma automática: não existem códigos de ativação manuais nem passos extras.

Se é a sua primeira compra, o tutorial de como instalar script FiveM leva você passo a passo do download até o ensure.

Como transferir assets entre contas e servidores?

Entre servidores da mesma conta não é preciso transferir nada, porque os grants pertencem à conta e não a uma licença específica. Entre contas diferentes existe uma transferência formal pelo portal da Cfx.re, com prazos de espera e limites que os criadores podem definir.

Entre servidores da mesma conta não há o que transferir. Os grants pertencem à conta, não a uma licença. Se você gerar uma segunda chave com a mesma conta Cfx.re, esse segundo servidor poderá carregar os mesmos assets sem mexer em nada. Mesmo assim, revise os termos do criador, porque a permissão técnica nem sempre coincide com a permissão legal da licença de uso.

Entre contas diferentes existe uma transferência formal. O portal da Cfx.re permite transferir um asset grant de uma conta para outra, algo útil se você comprou com a conta errada ou se está passando a comunidade para outro dono. Essas transferências costumam ter prazos de espera para evitar abusos, e alguns criadores limitam quantas vezes um grant pode ser movido.

O conselho prático que evita tudo isso: use sempre a mesma conta Cfx.re para todas as compras e para gerar as licenças dos seus servidores. Uma conta só, zero problema de grants espalhados.

Quais são os erros comuns do Keymaster e como resolver?

Os três erros que mais geram dúvida são o script aparecer como não autorizado, a mensagem “Could not authenticate server license key” e o grant estar em outra conta. Quase sempre se resolvem conferindo se a conta, a chave e o pacote baixado são os corretos.

O script aparece como não autorizado

O servidor inicia, mas o recurso protegido falha ao subir com erro de verificação ou autorização. As causas habituais, por ordem de probabilidade:

• O grant está em outra conta Cfx.re, diferente da dona da sua sv_licenseKey. Confira em portal.cfx.re com a sessão correta.
• A compra não foi concluída ou ainda está em processamento. Revise o e-mail de confirmação do Tebex.
• Você está usando uma versão do recurso baixada de outro lugar (por exemplo, um leak) que não corresponde ao seu grant. Baixe sempre o pacote oficial da sua compra.
• O cache do servidor guarda uma versão antiga depois de uma atualização. Apague a pasta cache do servidor e reinicie.

Could not authenticate server license key

Esse erro impede o servidor de iniciar e quase sempre tem uma destas causas:

• A chave foi copiada errado no server.cfg: aspas a mais, espaços invisíveis ou chave cortada. Copie de novo pelo portal.
• A chave já está em uso em outra instância ativa. Cada licença só admite um servidor ligado por vez; se você tem um ambiente de testes, gere uma segunda chave.
• A chave foi regenerada pelo portal e a cópia do seu server.cfg ficou obsoleta.
• Há uma instabilidade temporária nos serviços da Cfx.re. É raro, mas, se todo o resto está certo, espere alguns minutos e tente de novo.

O grant está em outra conta

O clássico: você comprou com uma conta Cfx.re no checkout do Tebex e o servidor usa uma licença gerada com outra. Há duas saídas: iniciar a transferência do grant pelo portal para a conta correta ou falar com o suporte da loja para que reatribua a entrega. Nos dois casos, o e-mail de compra e o ID da transação do Tebex são a sua prova de propriedade, então guarde-os sempre.

Quais são as boas práticas com o Keymaster?

A melhor prática é usar uma única conta Cfx.re para compras, licenças e administração do portal, protegê-la com senha forte e nunca publicar a sv_licenseKey. Se suspeitar de vazamento, regenere a chave na hora pelo portal. Os hábitos, em detalhe:

• Centralize tudo em uma conta Cfx.re: compras, licenças e administração do portal.
• Proteja essa conta com senha forte e não compartilhe a sessão com ninguém que não seja coproprietário de verdade do projeto.
• Nunca publique a sua sv_licenseKey. Se suspeitar que vazou, regenere imediatamente pelo portal e atualize o server.cfg.
• Mantenha os e-mails de confirmação do Tebex organizados. Em qualquer disputa ou transferência, são o seu recibo.
• Depois de cada atualização de um script protegido, apague o cache do servidor antes de reportar uma falha: isso resolve uma parte surpreendente dos problemas.
• Compre apenas em lojas que entreguem via Tebex e escrow oficial. É a única via em que o grant fica registrado no seu nome perante a Cfx.re.

Com o Keymaster dominado, ativar um script deixa de ser mistério e vira um processo de dois minutos. Para ampliar o servidor, veja também a lista dos melhores scripts para FiveM.