Newon GoogleMake CraftRank a preferred source in Google SearchAdd on Google ›
CraftRank SitesA free website and store for your server Make yours ›AshlarFree server software built on Paper, with DDoS and backdoor protection See Ashlar ›Security RadarA free check of your server's login, anti-bot and proxy settings, only with your OK See how it works ›CommunityAsk questions, share builds and find people to play with Join the forum ›
Server Launcher / Setup guide

Set up your launcher

From an empty Azure account to a download page your players can use. Server Launcher only works with Microsoft sign-in, so the first steps make your own Microsoft app and get it approved by Mojang.

About 20 minutes of work
Plus Mojang's review time
You pay only at step 7

Before you start

A Microsoft account. Any account can own the app. Use one your team can get back into.
Minecraft: Java Edition on an account you can sign in with, for the test.
Your server on CraftRank, and your modpack if you use one.
A design. You can make it first. It is free and saves as you go.
1

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.

Register an application
Frostvale Launcher

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.

Accounts in this organizational directory only
Accounts in any organizational directory and personal Microsoft accounts
Personal Microsoft accounts onlyPick this one. Minecraft accounts are personal accounts.
Public client/native (mobile & desktop)
https://login.microsoftonline.com/common/oauth2/nativeclient
2

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.

Authentication: Advanced settings
Allow public client flowsYes
3

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.

Overview: Essentials
Display nameFrostvale Launcher
Application (client) ID3f6c9a52-81d4-4e7b-a0c9-2b7d5e14f8a0
Supported account typesPersonal Microsoft accounts only
4

Ask Mojang for Minecraft access

Mojang reviews this

New 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.

5

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.

craftrank.org/panel/launcher
3f6c9a52-81d4-4e7b-a0c9-2b7d5e14f8a0 Found
Open Server Launcher
6

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.

Test sign-in
Microsoft accountSigned in, public client flows onPassed
Xbox LiveProfile foundPassed
Minecraft servicesYour app is approved by MojangPassed
Java EditionThe account owns the gamePassed
7

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.

8

Share with players

Your download page is craftrank.org/l/your-server. Post it on Discord and your website. The page offers the right file for each system, and the launcher updates itself after that.

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

MessageWhat it meansFix
Invalid app registrationMojang hasn't approved your client ID yet.Wait for Mojang's email, then test again.
AADSTS700016Microsoft can't find the app, or it isn't set for personal accounts.Copy the ID again. Check Supported account types.
AADSTS70002The app isn't set up for personal accounts or for signing in with a code.Check Supported account types and step 2.
AADSTS7000218Public client flows are off.Do step 2 again and press Save.
Doesn't own Java EditionThe account has no Java Edition license.Sign in with the account that bought the game.
No Xbox profileThe account has never used Xbox services.Sign in once at minecraft.net, then try again.
Child accountAccounts under 18 need a Microsoft family.An adult adds the account at account.microsoft.com/family.