PojavLauncher supports two distinct account types: authenticated Microsoft (Xbox Live) accounts that can join online servers and access your purchased copy of Minecraft, and local offline accounts that let you play singleplayer or LAN worlds without any internet credentials. Both types are managed from the same account spinner on the main screen, and each account’s data is stored as a small JSON file inside the launcher’s internal data directory.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/pojavlauncherteam/pojavlauncher/llms.txt
Use this file to discover all available pages before exploring further.
Adding an Account
Tap the account spinner at the top of the main screen (it shows the currently active username and skin face), then tap Add account. You will be taken to the auth-method selection screen where you can choose between Microsoft and local login.- Microsoft (Xbox Live)
- Local (Offline)
Microsoft login uses an in-app OAuth 2.0 web view that loads the official
login.live.com authorization page. No credentials are stored by the launcher itself — only the resulting tokens are saved.Tap 'Microsoft Account'
On the auth-method selection screen, tap Microsoft Account. An in-app browser opens pointing to the Microsoft Live sign-in page.
Sign in with your Microsoft account
Enter the email address and password associated with the Microsoft account that owns your Minecraft: Java Edition licence. Complete any two-factor authentication (2FA) prompts that appear.
Wait for the launcher to finish authentication
After you grant access, the launcher receives an authorization code and automatically exchanges it for an Xbox Live token, an XSTS token, and finally a Minecraft access token. A short toast — “Login started!” — confirms the process has begun. The main menu reloads once authentication is complete.
Microsoft tokens expire after a fixed period. PojavLauncher refreshes them automatically using the stored
msaRefreshToken when you launch the game — you do not need to log in again manually unless you revoke access or change your password.Switching Accounts
Tap the account spinner at the top of the main screen. A dropdown lists all saved accounts with their skin faces. Tap any entry to make it the active account. The change takes effect immediately — the next time you press Play, the game launches with the newly selected account.Account Storage
Each account is persisted as a JSON file inside the launcher’s private internal storage:| Field | Description |
|---|---|
accessToken | The current Minecraft session token; "0" for local accounts |
clientToken | The client identifier used to refresh/invalidate sessions; "0" for local accounts |
profileId | The player’s UUID (used to fetch the skin face) |
username | The Minecraft in-game name |
selectedVersion | The last Minecraft version string associated with this account (e.g. "1.7.10") |
isMicrosoft | true for Microsoft accounts, false for local |
msaRefreshToken | The long-lived Microsoft refresh token; "0" for local accounts |
xuid | The Xbox User ID linked to this account |
expiresAt | Unix timestamp (ms) when the current accessToken expires |
skinFaceBase64 | Legacy: skin head image encoded as Base64 (newer versions use a cache file) |
The skin face is separately cached as a PNG at
<internal_data>/cache/<username>.png and is downloaded from https://mc-heads.net/head/<uuid>/100. If the device has no internet connection the cache file is simply not updated — the launcher continues to function normally.Removing an Account
Account files can be deleted manually from<internal_data>/accounts/ using a file manager with root or internal-storage access, or through the account spinner’s remove option if your build includes it. After deletion, the account no longer appears in the spinner. If the deleted account was the active one, you must select a different account before launching the game.
Next Steps
Playing the Game
Learn how the main screen works and how to launch your first game session.
Profiles
Create separate profiles for different Minecraft versions or game directories.