Lunar Client uses your Minecraft account, not a separate username

Lunar Client does not have its own username system. When you log in to Lunar Client, you are logging in with your Microsoft or Mojang account — the same account you use to play Minecraft itself. If you want to change the name that appears in Lunar Client, you change your Minecraft username through Microsoft's account settings, and that change shows up in Lunar Client automatically.

This matters because it means there is no Lunar Client-specific step. You are not creating a profile within the client or setting a display name. You are changing the actual Minecraft account name, which affects how you appear everywhere you play Minecraft, including Lunar Client, vanilla servers, and any other launcher.

Key Takeaways

  • Lunar Client pulls your username from your Microsoft account, so changing your Minecraft username is the only step needed.
  • You change your Minecraft username through the Microsoft account website, not through Lunar Client itself.
  • The change takes effect when ready in Lunar Client once you log out and log back in.
  • You can change your Minecraft username once every 30 days, and the change is permanent until you change it again.
  • If you are using a Mojang account instead of a Microsoft account, the process is slightly different but still happens outside Lunar Client.

Changing your username through a Microsoft account

If your Minecraft account is linked to a Microsoft account (which is the standard for newer accounts), go to account.microsoft.com and sign in with your email and password. Once you are logged in, look for your profile or account settings — this is usually in the top right corner of the page.

Find the section labeled "Your Info" or "Profile" and look for your Minecraft profile name. Click on it to edit. You will see a field showing your current Minecraft username. Type in the new username you want, check that it is available (the system will tell you if it is not), and save the change. The system will confirm the change when ready.

Once you have changed it on the Microsoft website, close Lunar Client completely and log back in. When you launch Lunar Client and enter your credentials again, it will pull your new username from Microsoft's servers and display it in the client.

Changing your username if you have a Mojang account

Older Minecraft accounts that were never migrated to Microsoft use Mojang's login system. If this is your account, go to launcher.mojang.com and sign in with your Mojang credentials. Look for "Change Username" or a similar option in your account settings.

Enter your new desired username, confirm it is available, and save. Like the Microsoft process, this change takes effect when ready on Mojang's end. Close Lunar Client, log back in with your Mojang account, and the new username will appear.

What happens to your old username after you change it

When you change your Minecraft username, your old name becomes available for someone else to claim after 37 days. During those 37 days, no one else can use it, but you cannot reclaim it either. If you change your mind within that window, you would need to change your username again to something else, wait 37 days, and then change it back to your original name.

Your UUID — a unique identifier behind the scenes — stays the same. This means your progress, skins, and server data tied to your account do not disappear. Only the visible name changes.

Why Lunar Client does not have its own username setting

Lunar Client is a launcher and mod client for Minecraft, not a separate game platform. It does not maintain its own user database or profile system. Instead, it authenticates you through Microsoft or Mojang and then displays whatever username is associated with that account. This design keeps things straightforward: you have one Minecraft identity across all launchers and servers.

Some other games or platforms let you set a display name separate from your account name, but Minecraft does not work that way. Your username is your identity in the game, and it is managed at the account level, not the client level.

Troubleshooting: your old username still shows in Lunar Client

If you changed your Minecraft username on the Microsoft or Mojang website but Lunar Client is still showing your old name, the most common fix is to fully close the client and log out of your account within it. Do not just close the window — use the logout or sign-out option if the client offers one, or clear your login cache.

Then restart Lunar Client and log in again with your Microsoft or Mojang credentials. The client will fetch your current username from the account servers. If it still shows the old name after that, wait a few minutes and try again — sometimes the servers take a moment to sync.

If the problem persists, check that you are actually logged into the correct Microsoft or Mojang account. It is straightforward to have multiple accounts and log into the wrong one by mistake. Verify which email address is associated with your Minecraft account, then make sure you are signing into Lunar Client with that same email.

The 30-day cooldown between username changes

Minecraft enforces a 30-day waiting period between username changes. Once you change your username, you cannot change it again for 30 days. This rule applies whether you are using a Microsoft account or a Mojang account, and it applies across all launchers — Lunar Client, the official launcher, and any other client you use.

If you try to change your username before 30 days have passed, the Microsoft or Mojang website will show you a message telling you when you will be able to change it next. There is no way to bypass this cooldown, and Lunar Client has no control over it.

Frequently Asked Questions

Does changing my Minecraft username affect my progress or skins?

No. Your UUID stays the same, so all your progress, skins, and server data remain tied to your account. Only the visible name changes. Other players will see your new name, but your inventory, achievements, and everything else stays intact.

Can I change my username back to what it was before?

Only after 37 days have passed since you changed it away. Your old username becomes available for someone else to claim after that period, but during the 37-day window, no one can use it. You can change your username again after 30 days, but you would need to change it to something else first, wait 37 days, then change it back.

What if I do not remember my Microsoft or Mojang password?

Use the "Forgot password" link on the Microsoft or Mojang login page to reset it. You will need access to the email address associated with your account. Once you reset your password, you can log into the website and change your username from there.

Will my friends see my new username right away in Lunar Client?

Yes. Once you change your username on the Microsoft or Mojang website and log back into Lunar Client, your new name appears when ready to everyone. There is no delay or sync time — the change is live as soon as you log in.