Before you start
Create your Microsoft app
Open the entra.microsoft.com admin center (or the Azure portal) and sign in. Go to App registrations and press New registration. If Azure asks you to create a free account first, do it. App registrations cost nothing.
Players see this name on the Microsoft sign-in page, so use your server's name. Don't use "Minecraft", "Mojang" or "Microsoft" in it.
Allow public client flows
In your new app open Authentication, scroll to Advanced settings and set Allow public client flows to Yes, then press Save. This lets players sign in with a code on their phone, and it is needed for the test sign-in.
Copy the client ID
Open Overview and copy the Application (client) ID. You don't need a client secret. Never make one for a launcher and never paste one anywhere.
Ask Mojang for Minecraft access
Mojang reviews thisNew Microsoft apps can't sign anyone in to Minecraft until Mojang approves them. Open aka.ms/mce-reviewappid, give your client ID and describe your launcher, for example: "A launcher for my Minecraft server Frostvale. Players sign in with their own Microsoft account."
Mojang checks every request by hand and emails you when it is done. There is no fixed waiting time. Until then, the test sign-in shows Invalid app registration. That is normal. Keep designing your launcher meanwhile.
Add the client ID on CraftRank
In your panel open Server Launcher → Settings → Microsoft login, paste the ID and press Save. We check right away that Microsoft knows the app and that it accepts personal accounts.
Test the sign-in
Press Test sign-in, open microsoft.com/link and type the code you see. Sign in with an account that owns Java Edition. We walk the same path every player will: Microsoft, Xbox Live, then Minecraft. The tokens are thrown away right after.
Pay and build
Once the test passes, the Pay $29 button opens. Checkout is handled by Creem. Builds for Windows, macOS and Linux start right after and take a few minutes.
Using it every day
Post news
Owner app → News. It shows in every launcher within a minute.
Maintenance
Lock the Play button with a message and a countdown. Your team can still join.
Update the modpack
Upload a new .mrpack. Players get it the next time they press Play.
Launcher updates
Rebuild after changing the name or icon. Launchers update in the background.
Statistics
Players, launches, systems and sign-in results.
Crash reports
Players can send a report with one click. You see the log and their mods.
Fixing problems
| Message | What it means | Fix |
|---|---|---|
| Invalid app registration | Mojang hasn't approved your client ID yet. | Wait for Mojang's email, then test again. |
| AADSTS700016 | Microsoft can't find the app, or it isn't set for personal accounts. | Copy the ID again. Check Supported account types. |
| AADSTS70002 | The app isn't set up for personal accounts or for signing in with a code. | Check Supported account types and step 2. |
| AADSTS7000218 | Public client flows are off. | Do step 2 again and press Save. |
| Doesn't own Java Edition | The account has no Java Edition license. | Sign in with the account that bought the game. |
| No Xbox profile | The account has never used Xbox services. | Sign in once at minecraft.net, then try again. |
| Child account | Accounts under 18 need a Microsoft family. | An adult adds the account at account.microsoft.com/family. |