Change your username directly in Lunar Client settings
Lunar Client stores your username in its own settings, separate from your Minecraft account name. To change it, open Lunar Client, click the gear icon in the top right corner, then select Account from the left menu. You'll see a field labeled Username — type your new name there and click Save. The change takes effect the next time you launch the game.
This username is what other players see when you join servers and what appears in chat. It's different from your Minecraft Java Edition account name, which you change through the official Minecraft launcher if needed. Lunar Client straightforward reads whatever username you've set here when you connect to servers.
If you don't see the Account section in settings, make sure you're logged into Lunar Client first. Click the login button in the top right, enter your Lunar Client credentials, and then return to settings. The Account menu only appears when you're signed in.
Key Takeaways
- Open Lunar Client, click the settings gear icon, and go to Account to find the Username field.
- Type your new username and click Save — the change appears the next time you launch the game.
- This username is what other players see in-game and is separate from your Minecraft account name.
- You must be logged into Lunar Client before the Account settings menu will appear.
- If you want to change your actual Minecraft Java Edition account name, you do that through the official Minecraft launcher, not Lunar Client.
Why the username appears different from your Minecraft account
Lunar Client is a third-party launcher that sits on top of Minecraft Java Edition. When you launch the game through Lunar Client, it uses the username you've set in Lunar Client's settings, not the one tied to your Microsoft account. This is why you can have a different name in Lunar Client than your official Minecraft account uses.
Some servers check your actual Minecraft account name for bans or permissions, while others only see the username Lunar Client sends them. This means changing your Lunar Client username won't bypass a server ban or change your account status — it only changes what name appears to other players on that particular server.
What happens after you change your username
Once you save your new username in Lunar Client settings, it takes effect the next time you close and reopen the launcher. You don't need to restart your computer or reinstall anything. If you're already in a game when you change it, you'll need to disconnect and reconnect for the new name to show up.
Your old username won't carry over to any servers or chat logs — only the new one will appear going forward. Friends who had you added under your old name will still see you in their friends list, but your in-game name will display as the new one.
Changing your actual Minecraft account name
If you want to change the name tied to your Microsoft account (not just what Lunar Client displays), you'll do that through the official Minecraft launcher. Open the Minecraft launcher, click your profile name in the top right, select Preferences, and look for the option to change your name. Microsoft allows one free name change per account, and additional changes cost money.
Changing your Microsoft account name affects all versions of Minecraft you own and is permanent across all servers and platforms. This is different from changing your Lunar Client username, which only affects how you appear when launching through Lunar Client.
Troubleshooting a username that won't save
If you type a new username but it doesn't save, first check that you actually clicked the Save button — it's straightforward to miss. Close Lunar Client completely and reopen it to see if the change took. If it still hasn't saved, log out of Lunar Client entirely, then log back in and try again.
Some usernames contain characters that servers don't accept, like spaces or special symbols. Stick to letters, numbers, and underscores. If you're trying to use a name that's already taken on a server, that won't prevent you from setting it in Lunar Client — the server will just show a conflict when you try to join. Try a different name if you keep getting rejected when connecting to servers.
Frequently Asked Questions
Will changing my Lunar Client username get me unbanned from a server?
No. Most servers ban based on your actual Minecraft account, not the username Lunar Client displays. Changing your Lunar Client username is just a display change and won't remove you from a server's ban list. You would need to contact the server owner to appeal the ban.
Can I use a username that someone else is already using?
Yes, you can set any username in Lunar Client settings. Multiple people can have the same display name. However, servers may reject you if that name is already taken on their system, or they may add a number to distinguish you from the other player.
Does my Lunar Client username have to match my Minecraft account name?
No. They're completely separate. You can have any username in Lunar Client regardless of what your Microsoft account is named. Some players use different names for privacy or just because they prefer a different display name.
What if I forget where the username setting is?
Open Lunar Client, click the gear icon in the top right corner, then click Account in the left sidebar. The Username field is at the top of that menu. Make sure you're logged into Lunar Client first, or the Account option won't appear.
Do I need to restart my computer after changing my username?
No. Just close Lunar Client completely and reopen it. The new username will be active the next time you launch the game or join a server.