Microsoft Login, Demo Mode & Licensing Issues

This guide will explain how to log in to your Microsoft account in XMCL, what to do if you encounter the "failed to exchange Xbox token" error, why Minecraft might launch in Demo Mode, and how to play without a paid license using alternative logins.

---

🔑 1. Logging In with a Microsoft Account

To sign in and play with your official Minecraft license, follow these steps:

1. Click on your profile/avatar (or "Manage Account") in the top right to open the Account Manager:

2. Click "Add Account", choose Microsoft, and proceed with the login:

💡 Sign In via Device Code:
If you don't want to type your password inside the launcher, check "Login by Device Code". XMCL will show a code; simply visit microsoft.com/link in your web browser, enter the code, and confirm the login.

---

🔍 2. How Microsoft Authentication Works

When logging in, the launcher must verify your identity across three separate authentication layers:

🔑 Authentication Handshake:

STEP 1

Microsoft Login

Checks Password

➔

STEP 2

Xbox Live Services

Obtains Gamertag

➔ ❌ Fails Here

STEP 3 (Exchange)

Minecraft Token

Verifies License

If Step 3 fails, the login will reject with "failed to exchange Xbox token", or the game will launch in Demo Mode. Both symptoms mean the Mojang authentication servers could not verify a valid Minecraft license on your Microsoft account.

---

🛠 3. Troubleshooting Microsoft Login & Demo Mode Issues

If you own the game but encounter login failures or the Demo screen:

Cause A: No Minecraft License on This Microsoft Account

🎮

Mojang servers did not find the purchased game

This is the most common reason. You logged in successfully, but Mojang reports that this specific account does not own Minecraft Java Edition.

How to fix:

• Verify Purchase: Log in to Minecraft.net using your Microsoft account and verify that you see the download option instead of a buy prompt.
• Verify Game Pass Status: If playing via Xbox Game Pass, ensure your subscription is active and that you are logging in with the exact Microsoft account associated with the active subscription.
• Double Check Email: Make sure you aren't logging in with a different Microsoft account (like a school or work email) instead of the personal account that holds the purchase.

---

Cause B: Missing Xbox Live Profile

👤

Microsoft account not activated on Xbox Live

You created a Microsoft account but never initialized Xbox Live services. The login servers cannot generate an access token because the account lacks a unique Gamertag.

How to fix:

1. Go to the official Xbox.com website.
2. Click Sign In in the top right corner.
3. If prompted to create an Xbox profile, accept the agreement and set up a Gamertag (unique nickname).
4. Wait 1-2 minutes for the servers to sync, then launch XMCL and try logging in again.

---

Cause C: Network Blocks and ISP Routing Restrictions

🌐

Blocked connection to Mojang or Microsoft servers

Due to regional ISP blocks, local firewalls, or corrupt DNS configurations, your PC cannot establish a connection to `api.minecraftservices.com` or Xbox Live login servers.

How to fix:

• Use a VPN: Connect to a stable VPN before attempting to log in. This bypasses ISP throttling and blocked routing paths.
• Configure Proxy inside XMCL:
  1. Open Settings (gear icon on the left sidebar).
  2. Navigate to Network Settings.
  3. Input your active proxy server address (HTTP, HTTPS, and SOCKS5 protocols are supported).
• Reset your hosts file: Ensure there are no rules redirecting mojang.com or minecraftservices.com in your system hosts file.

---

🆓 4. Playing Without a License (Alternative Logins)

If you do not own a licensed copy of Minecraft, you can play using alternative login systems. XMCL includes a Developer Mode to allow offline play and third-party authentication services.

How to Enable Developer Mode:

1. Go to Settings (gear icon on the left sidebar).

2. Find the "Developer Mode" option and toggle it on:

   

Once enabled, you will see additional authentication options in the Account Manager when adding an account:

🟢 Offline Mode

• Play locally without connecting to Mojang's servers.
• Simply choose any username and start playing single-player or local multiplayer worlds.

🟡 Littleskin

• A free community authentication and skin server.
• Allows you to use custom skins without a paid Minecraft license.
• Website: https://littleskin.cn

🔵 Ely.by

• A popular third-party skin and account database.
• Supports custom skins, capes, and is compatible with many community servers.
• Website: https://ely.by