Two-factor authentication (2FA) adds a 6-digit code from an authenticator app (such as Google Authenticator, Microsoft Authenticator, Authy, 1Password or Bitwarden) on top of your normal Microsoft or /web login sign-in. Once set up, it protects your website sign-in and can also check your IP address when you join the Minecraft server.
Setting up 2FA on the website#
You can turn on 2FA from the Security card in Account Settings. Changing security settings requires a website sign-in from the last 15 minutes; if your session is older, the card asks you to Sign in again first.
- Open Account settings and scroll to Security.
- Click Set up two-factor authentication.
- Scan the QR code with your authenticator app, or copy the manual setup key. The setup stays valid for 10 minutes.
- Enter the 6-digit code from your app and click Turn on.
- Save the 10 single-use recovery codes (
xxxxx-xxxxx) shown on screen using Copy all or Download (.txt), tick I have saved these codes, and click Done.
Confirming setup signs out all of your other active website sessions.
Setting up 2FA in game#
You can also enroll directly in game with /2fa setup:
- Run
/2fa setupin chat. The server prints your account label (Issuer: Netherite) and a clickable manual setup key, valid for 10 minutes. - Add the key to your authenticator app.
- Run
/2fa confirm <code>with the 6-digit code from your app.
Confirming setup in game displays your 10 single-use recovery codes (with a [Copy all codes] button), enables two-factor on both the website and in game, trusts your current IP address, and signs out any existing website sessions.
Signing in on the website with 2FA#
When 2FA is on, signing in with Microsoft or /web login sends you to the two-factor screen before creating a session:
- If your Microsoft account has joined on both Java and Bedrock Edition, you pick which edition to sign in as on this screen. Editions without 2FA sign straight in; editions with 2FA ask for a code.
- Enter the 6-digit code from your authenticator app (it submits automatically when the sixth digit is entered), or click Use a recovery code instead to enter a single-use recovery code.
The in-game check#
When the In-game check is enabled, joining the Minecraft server from an IP address that is not in your trusted list freezes you in place and asks for a code before you can play.
- Enter your 6-digit authenticator code or a recovery code directly in chat, or run
/2fa <code>. - While the check is pending, other commands are blocked and you have 120 seconds (
2 minutes) to enter a valid code before being disconnected. - Passing the check adds that IP address to your trusted list so future joins from the same address do not prompt again.
Managing the in-game check and trusted addresses#
On the website (Account settings > Security):
- Toggle Also require my code in-game when I join from a new IP address (requires a current 6-digit or recovery code). Turning it on trusts your current browser IP if detectable; turning it off forgets all trusted addresses.
- Under Trusted addresses, entries are masked by default with Show / Hide buttons and show when they were last used. Click Forget on one entry or Forget all to require a code on the next join (forgetting requires no code).
In game, use /2fa (alias /twofactor):
| Command | Effect |
|---|---|
/2fa status | Shows whether web 2FA and the in-game check are on, how many trusted addresses you have, and whether your current address is trusted |
/2fa enable <code> | Turns on the in-game check and trusts your current IP address |
/2fa disable <code> | Turns off the in-game check and forgets all trusted addresses |
/2fa ips | Lists your trusted addresses (masked; hover to view) and marks your current address |
/2fa forget <target> | Forgets one trusted address by its number in /2fa ips, or all to forget every address |
/2fa <code> | Enters a pending join code |
Recovery codes, lockouts and resets#
- Recovery codes: Each of your 10
xxxxx-xxxxxcodes works once on the website, in game, or when confirming security changes. You can generate 10 fresh codes at any time from Security > Regenerate recovery codes (which invalidates all unused previous codes). - Lockouts: Website and in-game 2FA share the same attempt limit. 5 wrong attempts lock code entry for 15 minutes.
- Turning off 2FA: Click Turn off in Security and confirm with an authenticator or recovery code (within 15 minutes of signing in). Turning off 2FA also turns off the in-game check and forgets all trusted addresses.
- Lost authenticator and recovery codes: Contact staff through a support ticket (Support Tickets) or Discord (Contacting Staff) to request a two-factor reset.