Getting Started
Accounts & First Launch
Sign in with a Microsoft account or add an offline profile, then create and launch your first instance.
Open the Accounts panel from the avatar button near the bottom-left corner of the sidebar.
Microsoft account
- Select Microsoft in the Accounts view.
- Complete the OAuth sign-in flow in your system browser (
http://localhost/oauth/callback). - Wait for
mclto finish exchanging credentials and select the active profile.
If you compile
mclyourself, supply your own Microsoft Entra application client ID viaMCL_MICROSOFT_CLIENT_IDor.env.local. See Environment & Configuration.
Offline profile
- Select Offline in the Accounts view.
- Enter a player name to create a local profile for offline single-player or LAN testing.
Creating your first instance
- Click + in the instances sidebar to open the creation workspace.
- Choose a loader (Vanilla, Fabric, Quilt, Forge, or NeoForge) and Minecraft version.
- Click Create & Install, then press Launch once preparation finishes.