Microsoft 인증 오류

GDLauncher에서 Microsoft 계정으로 로그인할 때, 런처가 당신을 대신해 Microsoft OAuth 서비스와 Mojang 인증 API와 통신합니다. 그 서비스들에서 발생한 오류는 런처에 그대로 표시되며, 문구는 GDLauncher가 아니라 Microsoft에서 옵니다.

다음은 가장 흔한 오류와 그 의미입니다.

Invalid Grant

Microsoft가 OAuth 교환을 거부할 때 나타납니다. 일반적인 원인:

• 계정에 비밀번호가 설정되어 있지 않음 (이메일 링크나 소셜 로그인으로 만든 Microsoft 계정). account.microsoft.com에서 비밀번호를 추가하세요.
• 계정이 2단계 인증 없는 옛 로그인 흐름을 사용 중. account.microsoft.com/security에서 2FA를 켜면 대부분 해결됩니다.
• 캐시된 토큰이 오래됨. Settings → Accounts에서 계정을 로그아웃했다가 다시 로그인하세요.

계정 차단

GDLauncher는 Mojang의 응답을 그대로 전달합니다. 차단은 Mojang 쪽에서 일어난 것이며, GDLauncher는 자체 차단 목록을 운영하지 않습니다. 차단 사유와 이의신청 방법은 동일 계정으로 minecraft.net에 로그인해 확인하세요.

콘솔 액세스 필요

이건 보통 Microsoft 가족 그룹 안의 자녀 계정에서 나타납니다. 부모 계정이 account.microsoft.com/family에서 자녀에게 Minecraft Java Edition을 허용해야 합니다. 허용 후 GDLauncher에서 로그아웃했다가 다시 로그인하세요.

Xbox Live 오류

Xbox Live 실패는 보통 두 가지 중 하나입니다:

• Microsoft 계정의 국가/지역 설정이 Xbox Live를 허용하지 않음. account.microsoft.com/profile에서 조정하세요.
• 계정이 Xbox Live 이용 약관에 동의하지 않음. 동일 Microsoft 계정으로 xbox.com에 한 번 로그인해 약관에 동의한 다음 GDLauncher에서 다시 시도하세요.

계정 만료

Microsoft 리프레시 토큰이 만료되었거나 취소되었습니다 (다른 곳에서 계정 비밀번호를 바꾼 경우가 가장 흔합니다). GDLauncher는 ‘Account expired’ 프롬프트를 표시하고 재인증을 제안합니다. Settings → Accounts에서 다시 로그인하세요.

그래도 해결되지 않으면

오류 메시지가 위 어느 것에도 맞지 않으면, 두 앱 레벨 로그를 Discord에서 공유해 주세요: main.log (Electron)과 최신 __gdl_logs__/<timestamp>.log (Rust 코어). 찾는 방법은 Share App Logs를 참고하세요. 인증 흐름은 두 프로세스 사이를 오가기 때문에 둘 다 필요한 경우가 대부분입니다.