Lunar Client does not control your username — Minecraft does

Your Minecraft username lives in your Microsoft account, not in Lunar Client. Lunar Client is a launcher and mod manager that connects to your existing account. When you change your username through Microsoft, Lunar Client automatically uses the new name the next time you log in. You cannot change your username inside Lunar Client itself.

This matters because some players think they need to do something special in Lunar Client to change their name. You do not. The process is entirely on Microsoft's side, and it takes about the same time whether you use Lunar Client, the official launcher, or any other launcher.

Key Takeaways

  • Your Minecraft username is stored in your Microsoft account, so you change it through Microsoft's website, not through Lunar Client.
  • You can change your username once every 30 days, and the change takes effect when ready across all launchers.
  • After you change your username on Microsoft's site, close and reopen Lunar Client to see the new name in the launcher.
  • Lunar Client will show your old username in the launcher until you restart it, even though the change is already live on Microsoft's servers.

Steps to change your username through Microsoft

Go to account.microsoft.com and sign in with the email and password you use for Minecraft. Once you are logged in, look for "Your info" or "Account" in the left menu, then find the section that says "Manage your Microsoft account" or similar wording. The exact menu names vary slightly depending on whether you are on a phone or computer.

Find the field that shows your current Minecraft username. It may be labeled "Minecraft profile" or "Gamertag". Click on it to edit. Type your new username — it must be between 3 and 16 characters, and can only contain letters, numbers, and underscores. Microsoft will tell you when ready if the name is taken or invalid. Once you confirm the change, it is live.

The entire process takes less than a minute. You do not need to restart your computer or do anything else on Microsoft's end. Your new username is active right away in Minecraft servers and in the launcher.

What happens in Lunar Client after you change your username

Close Lunar Client completely if it is open. Reopen it and log in again with your Microsoft account. The launcher will now show your new username. Any mods, settings, or cosmetics you had before the change stay exactly where they were — changing your username does not touch any of your Lunar Client data.

If you join a server while Lunar Client still shows your old name in the launcher window, you will still appear with your new name to other players. The launcher display lags behind the actual change. Restarting Lunar Client fixes this display lag.

The 30-day waiting period between changes

Microsoft enforces a rule: you can change your Minecraft username once every 30 days. If you change it today, you cannot change it again for 30 days from that moment. This is a hard limit on Microsoft's side, not something Lunar Client controls.

If you try to change your username before 30 days have passed, Microsoft's website will show you a countdown timer telling you exactly when you can change it again. There is no way around this limit, and no support team can override it.

Troubleshooting: Your old name still shows in Lunar Client

If you changed your username on Microsoft's website but Lunar Client still displays your old name, the fix is straightforward: fully close Lunar Client and reopen it. Do not just minimize it or switch windows. Use the X button to close the entire process, then launch it again.

If the old name persists after a restart, sign out of your Microsoft account within Lunar Client (usually in Settings), then sign back in. This forces Lunar Client to fetch your current information from Microsoft's servers. After you sign back in, your new username should appear.

What does not change when you change your username

Your Minecraft UUID — a unique identifier that servers use to track your account — stays the same forever. Servers recognize you by UUID, not by username, so changing your name does not affect your progress, items, or rank on any server. If you had admin status or a special role on a server, you keep it after the name change.

Your Microsoft account email, password, and two-factor authentication settings do not change. Your Lunar Client mods, shaders, and cosmetics do not change. Your friends list does not change. Only the name that appears above your character in the game changes.

Frequently Asked Questions

Can I change my username more than once a month?

No. Microsoft limits you to one change every 30 days. The timer starts from the moment you make the change, not from the calendar date. If you change your name on January 15, you cannot change it again until February 14.

Do I lose my Lunar Client cosmetics or mods when I change my username?

No. Your cosmetics, mods, shaders, and all Lunar Client settings are tied to your Microsoft account, not your username. They stay with you after the change.

Will servers know it is me after I change my name?

Yes. Servers track you by your UUID, which never changes. Your progress, rank, and items on any server stay with you even after you change your username. Other players will see your new name, but the server knows you are the same account.

What if the username I want is already taken?

Microsoft will tell you the name is unavailable when you try to claim it. You will have to choose a different name. Taken names cannot be reserved or put on a waiting list — you have to pick something else.

Does Lunar Client need to be open to change my username?

No. You change your username entirely through Microsoft's website. Lunar Client does not need to be running. You can change it on your phone, on a different computer, or anywhere you can access account.microsoft.com.