1 Pegar o token
Assim que o pagamento é confirmado, a licença já existe. Entre em Gerenciar Licença com a mesma conta do Discord que usou na compra.
Cada licença tem um token fixo, no formato FRST-XXXX-XXXX-XXXX. Ele nunca muda, nem quando você troca de IP, de máquina ou renova o plano. Clique no ícone ao lado do token para copiar.
Quem tem o token consegue autenticar no lugar da sua cidade. Não poste em print, não mande em canal público e não deixe no GitHub.
2 O IP e o caso do 127.0.0.1
A autenticação funciona assim: quando sua cidade sobe, o loader manda o token para o nosso servidor, e nós comparamos o IP de onde a conexão chegou com o IP cadastrado na licença. Se os dois baterem, libera.
O 127.0.0.1 é um endereço que todo computador usa para falar consigo mesmo. Ele nunca é o IP público de um servidor FiveM, então nenhuma cidade autentica com esse valor. Se ele aparece na sua licença, significa apenas que o campo ainda está no valor de fábrica e você precisa trocar pelo IP real. Não é erro, não é bug e não é cobrança: é o passo que falta.
Qual IP colocar
| Onde a cidade roda | Qual IP usar | Muda com o tempo |
|---|---|---|
| VPS ou host | O IPv4 que o painel do seu host mostra | Não, é fixo |
| PC de casa | Seu IPv4 público (não o 192.168.x.x) | Sim, a operadora troca |
Se a cidade roda na mesma máquina de onde você está acessando o painel, clique em Atualizar IP dentro da licença. Ele detecta o IPv4 público da sua conexão e grava na hora. Se a cidade roda numa VPS, acesse o painel de dentro da VPS e clique no mesmo botão, ou copie o IPv4 do painel do seu host e cole no campo manualmente.
O que não serve como IP
127.0.0.1oulocalhost: endereço interno da própria máquina.192.168.x.x,10.x.x.x,172.16.x.xaté172.31.x.x: IPs de rede local, só valem dentro da sua casa.- Um domínio como
meuservidor.com: o campo aceita apenas número IPv4. - Um IPv6 (aquele cheio de dois-pontos, tipo
2804:7110:...): a autenticação opera só em IPv4. Veja a seção de erros.
3 A porta
A porta padrão do FiveM é 30120, e para a maioria das pessoas ela nunca muda. Só mexa nesse campo se você abre mais de uma cidade na mesma máquina. Nesse caso, cada uma usa uma porta diferente: a primeira em 30120, a segunda em 30121, e assim por diante.
O valor aqui precisa ser o mesmo do endpoint_add_tcp e endpoint_add_udp do seu server.cfg.
4 Colocar o token no server.cfg
Abra o server.cfg da sua cidade e coloque o token na linha de autorização:
# Licença Frosty Shop
set sv_authorization "FRST-XXXX-XXXX-XXXX"Troque FRST-XXXX-XXXX-XXXX pelo token que você copiou no passo 1, mantendo as aspas. Salve o arquivo.
Se você renomeou a pasta do script, a autenticação recusa com SCRIPT_MISMATCH. O nome configurado no loader tem que ser igual ao nome que aparece na aba Scripts do painel.
5 Subir e conferir
-
Confirme que o IP no painel está preenchido
Sem
127.0.0.1, sem campo vazio. O valor precisa ser o IPv4 público da máquina onde a cidade roda. -
Suba a cidade
Acompanhe o console. A autenticação acontece no boot e depois se repete de tempos em tempos para manter a licença viva.
-
Volte ao painel e olhe "Última auth"
Se apareceu a data e a hora de agora, está autenticado. Se continua em traço, a autenticação não passou: veja a tabela de erros.
Enquanto o IP não mudar e o plano estiver ativo, você não precisa mexer em mais nada.
6 Quando o IP muda sozinho
Se a cidade roda no seu PC de casa, a operadora troca seu IP público de vez em quando (ao reiniciar o modem, por queda de energia, ou sem motivo aparente). Quando isso acontece, a licença passa a recusar com IP_MISMATCH, porque o IP cadastrado ficou velho.
A correção leva um clique: abra o painel da própria máquina onde a cidade roda e clique em Atualizar IP na licença. Se você tem várias licenças, o botão Atualizar IP'S aplica em todas de uma vez.
Em VPS isso não acontece, o IP é fixo. Se você usa VPS e mesmo assim está batendo IP_MISMATCH, provavelmente a cidade está saindo por um IP diferente do que você cadastrou. O erro no painel mostra qual IP chegou até nós: use exatamente aquele.
7 Tabela de erros
Toda tentativa de autenticação fica registrada. Estes são os motivos que podem aparecer e o que fazer em cada um:
| Motivo | O que aconteceu | Como resolver |
|---|---|---|
IP_NAO_CONFIGURADO | A licença ainda não tem IP definido, é o estado de primeiro acesso. | Abra o painel, clique em Atualizar IP na licença e suba a cidade de novo. |
IP_MISMATCH | O IPv4 de onde a conexão chegou é diferente do IPv4 cadastrado. | Clique em Atualizar IP, ou copie o IP que o erro mostra e cole no campo. |
IP_IPV6 | A cidade conectou por IPv6. A autenticação opera apenas em IPv4. | Force IPv4 no host. Se você conecta por domínio, use o registro A (IPv4) em vez do AAAA. |
NO_TOKEN | O loader não enviou token, o sv_authorization está vazio. | Coloque set sv_authorization "SEU_TOKEN" no server.cfg. |
INVALID_LICENSE | O token enviado não existe no banco. | Confira se copiou o token inteiro, sem espaço sobrando e sem cortar o começo ou o fim. |
SCRIPT_MISMATCH | O nome do script no loader está diferente do nome no painel. | Iguale o nome do recurso ao que aparece na aba Scripts. |
SCRIPT_PAUSED | O script está pausado no painel, do nosso lado. | Abra um ticket, é uma ação administrativa. |
EXPIRED | A validade do plano venceu. | Renove pelo botão Renovar na própria licença. |
STATUS_SUSPENSA | A licença está suspensa. | Abra um ticket para saber o motivo registrado. |
DISCORD_LEFT | O dono da licença saiu do nosso servidor do Discord. | Volte ao servidor e abra um ticket para reativação. |
Se a nossa API ficar fora do ar, o loader recebe uma resposta neutra e continua rodando. Instabilidade nossa não fecha a sua cidade.
8 Ainda travado
Abra um ticket pelo painel ou pelo Discord. Para agilizar, mande junto:
- O token da licença (pode mandar, o ticket é privado).
- O IP que você cadastrou no painel.
- A mensagem exata que aparece no console da cidade.
- Se roda em VPS ou no PC de casa.