Skip to content
Nether Client is here: a free Minecraft client and launcher

Two-Factor Authentication

How to protect your Netherite account with an authenticator app on the website and in game, use recovery codes, manage trusted addresses and handle lockouts.

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.

  1. Open Account settings and scroll to Security.
  2. Click Set up two-factor authentication.
  3. Scan the QR code with your authenticator app, or copy the manual setup key. The setup stays valid for 10 minutes.
  4. Enter the 6-digit code from your app and click Turn on.
  5. 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:

  1. Run /2fa setup in chat. The server prints your account label (Issuer: Netherite) and a clickable manual setup key, valid for 10 minutes.
  2. Add the key to your authenticator app.
  3. 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):

CommandEffect
/2fa statusShows 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 ipsLists 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-xxxxx codes 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.

General

Categories