What 'Active' means
The Active account is the one Play uses when you launch an instance. You can be signed in to several Microsoft accounts at once, the launcher remembers all of them, but only one is "active" at a time. Switching is one click; nothing else needs to be touched.
Status states explained
- ok (green check): the access token is valid. Ready to launch.
- expired (yellow alert): the access token expired and hasn't been auto-refreshed yet. Click the refresh icon in Actions to re-authenticate through Microsoft, or wait, the launcher will try its background refresh on the next opportunity.
- refreshing (yellow refresh): the launcher is currently refreshing the token in the background. No action needed.
- invalid (red X): the refresh token itself was rejected by Microsoft, so no background refresh will recover this. Common triggers: you changed your Microsoft password, signed out from Microsoft's website, or hit a security policy. Click the refresh icon in Actions to walk through Microsoft sign-in again, or remove and re-add.
Why an account suddenly goes invalid
Microsoft can invalidate refresh tokens server-side at any time. The most common triggers:
- You changed your Microsoft password.
- You enabled or disabled two-factor authentication.
- You signed out from microsoft.com or account.microsoft.com explicitly.
- You haven't used the account in months and Microsoft expired old tokens as a cleanup.
None of these are GDLauncher's fault, the launcher just sees a "token rejected" response. The fix is always the same: remove the account, add it again, sign in fresh.
Linked GDL accounts
If you've signed up for a GDL account, one of your Microsoft accounts is the linked owner of it. Removing that Microsoft account triggers a confirmation modal, breaking the link affects what your GDL profile is anchored to. You can re-link to a different Microsoft account later in GDL Account settings.
Children accounts and Family Group
If you have a child Microsoft account or one inside a Family Group, the parent account may need to grant Minecraft access on the platform before sign-in works. Go to account.microsoft.com/family and check the child's app permissions. Without that, GDLauncher's sign-in flow shows a "console access required" or "Xbox Live not allowed" error.
Removing the last account
Removing the last signed-in Microsoft account signs you out of GDLauncher entirely. You're routed to the home page; you'll need to add an account again before you can launch anything.