Erros de autenticação da Microsoft
Quando você entra no GDLauncher com uma conta Microsoft, o launcher fala em seu nome com o serviço OAuth da Microsoft e a API de autenticação da Mojang. Os erros devolvidos por esses serviços aparecem direto no launcher; o texto vem da Microsoft, não do GDLauncher.
Abaixo, os mais comuns e o que significam.
Invalid Grant
Aparece quando a Microsoft recusa a troca OAuth. Causas mais comuns:
- A conta não tem senha definida (conta Microsoft criada via link de email ou login social). Defina uma senha em account.microsoft.com.
- A conta usa um fluxo de login antigo sem autenticação em duas etapas. Ativar 2FA em account.microsoft.com/security resolve pra maioria.
- Os tokens em cache estão expirados. Saia da conta em Settings → Accounts e entre novamente.
Conta banida
O GDLauncher repassa a resposta da Mojang sem alterar. O banimento é do lado da Mojang; o GDLauncher não mantém lista própria de banimentos. Entre em minecraft.net com a mesma conta pra ver o motivo do banimento e opções de recurso.
Acesso de console necessário
Costuma aparecer em contas infantis dentro de um grupo familiar Microsoft. A conta do responsável precisa autorizar Minecraft Java Edition pra criança em account.microsoft.com/family. Depois de autorizar, saia e entre novamente no GDLauncher.
Erros do Xbox Live
Falhas no Xbox Live geralmente caem em uma de duas categorias:
- A configuração de país/região da conta Microsoft não permite Xbox Live. Ajuste em account.microsoft.com/profile.
- A conta não aceitou os termos do Xbox Live. Entre uma vez em xbox.com com a mesma conta Microsoft pra aceitar os termos e tente de novo no GDLauncher.
Conta expirada
O refresh token da Microsoft expirou ou foi revogado (na maioria das vezes porque você mudou a senha da conta em outro lugar). O GDLauncher mostra um prompt “Account expired” e oferece reautenticar. Entre de novo em Settings → Accounts.
Se nada acima resolve
Se a mensagem de erro não bate com nenhuma das anteriores, compartilhe os dois logs no nível do app no nosso Discord: main.log (Electron) e o mais recente __gdl_logs__/<timestamp>.log (Rust core). Onde encontrá-los está no Share App Logs. Quase sempre precisamos dos dois, o fluxo de autenticação passa pelos dois processos.