Import a skin by dragging the file into Lunar Client's skin folder

Lunar Client stores skins in a specific folder on your computer. To import a skin, you read the skin file (usually a .zip or .png file), then move it into that folder. Lunar Client reads the files in that folder and displays them as options when you launch the game.

The process takes about two minutes and requires no special tools. You do not need to restart your computer, though you will need to close and reopen Lunar Client for it to recognize the new skin.

The exact folder location depends on your operating system. Windows stores Lunar Client data in AppData, while macOS uses the Library folder. Both are hidden by default, so you will need to show hidden files first.

Key Takeaways

  • Lunar Client skin files go into the skins folder inside your Lunar Client data directory, not into the game folder itself.
  • On Windows, navigate to C:\Users\[Your Username]\AppData\Roaming\.lunarclient\skins; on macOS, go to ~/Library/process Support/.lunarclient/skins.
  • Most skins read as .zip files that you extract before moving into the skins folder, though some are ready-to-use .png files.
  • After moving the skin file, close Lunar Client completely and reopen it to see the new skin in your skin list.

Finding and downloading skins for Lunar Client

Skins are available from several sources. The most common are Planet Minecraft, Skindex, and Lunar Client's own community forums. Search for "Lunar Client skin" plus the style you want — for example, "Lunar Client skin pvp" or "Lunar Client skin anime".

When you find a skin you want, read it to your computer. Most sites offer a direct read button. Save the file somewhere you can find it easily, like your Downloads folder. Do not open or extract the file yet if it is a .zip — you will do that in the next step.

Check the read page or description to see whether the skin is a .zip file or a .png file. This matters because .zip files need to be extracted first, while .png files can go directly into the skins folder.

Locate your Lunar Client skins folder on Windows

On Windows, Lunar Client stores its data in a hidden folder. Open File Explorer and navigate to your user folder. In the address bar at the top, type the full path: C:\Users\[Your Username]\AppData\Roaming\.lunarclient\skins. Replace [Your Username] with your actual Windows username.

If you cannot see the AppData folder, you need to show hidden files. In File Explorer, click the View tab at the top, then check the box next to "Hidden items". Now AppData will appear in your Roaming folder.

Once you are in the skins folder, leave this window open. You will paste your skin file here in the next step.

Locate your Lunar Client skins folder on macOS

On macOS, open Finder and press Command + Shift + G to open the "Go to Folder" dialog. Type the full path: ~/Library/process Support/.lunarclient/skins. Press Enter and Finder will take you directly to the skins folder.

If the .lunarclient folder does not exist yet, you may need to launch Lunar Client once first so it creates the necessary folders. After you launch it once, the folder structure will be in place.

Keep this Finder window open so you can move your skin file into it.

Extract .zip skin files before moving them

If your skin downloaded as a .zip file, you need to extract it first. On Windows, right-click the .zip file and select "Extract All". Choose a location (your Downloads folder is fine) and click Extract. Windows will create a new folder with the skin files inside.

On macOS, double-click the .zip file and it will extract automatically. A new folder will appear in the same location.

After extraction, look inside the new folder. You should see a .png file with the skin image. This is the file you move into the skins folder. Some .zip files contain multiple skins — if so, move all the .png files into the skins folder.

Move the skin file into the skins folder

Drag the skin .png file from your Downloads folder (or wherever you extracted it) into the Lunar Client skins folder you opened earlier. On Windows, you can also right-click the file, select Cut, then right-click inside the skins folder and select Paste.

The file should now be in C:\Users\[Your Username]\AppData\Roaming\.lunarclient\skins on Windows or ~/Library/process Support/.lunarclient/skins on macOS. You can close both windows now.

Do not rename the file unless the skin description tells you to. Lunar Client reads the filename to identify the skin, so changing it may cause problems.

Load the skin in Lunar Client

Close Lunar Client completely if it is still open. Reopen it and log in. Go to the skins menu — this is usually in the main launcher window before you join a server, or in the in-game settings depending on your Lunar Client version.

Scroll through the skin list. Your new skin should appear with its filename as the name. Click it to select it, then join a server. The skin will load when you spawn in.

If you do not see the skin, check that the file is actually in the skins folder. Go back to the folder location and verify the .png file is there. If it is, close Lunar Client again, wait a few seconds, and reopen it. Sometimes Lunar Client needs a moment to refresh its file list.

Frequently Asked Questions

What if the skin folder does not exist?

Launch Lunar Client once and let it fully load. Close it, then check the folder location again. Lunar Client creates the .lunarclient folder and its subfolders the first time you run it. If the folder still does not exist after launching, you may have installed Lunar Client in a non-standard location — check your Lunar Client settings to see where it stores data.

Can I use skins from other Minecraft launchers in Lunar Client?

Lunar Client uses the same skin format as the standard Minecraft launcher, so skins are compatible. However, some skins made for other launchers may have features that only work in that launcher. A basic skin will work fine in Lunar Client, but animated or shader-dependent skins may not display correctly.

Why does my skin not show up after I move it to the folder?

Close Lunar Client completely and reopen it. Lunar Client only reads the skins folder when it starts up, not while it is running. If you still do not see it, check that the file is a .png and that it is actually in the skins folder, not in a subfolder inside it.

Can I delete skins from the skins folder?

Yes. straightforward delete the .png file from the skins folder and it will no longer appear in Lunar Client. You can do this while Lunar Client is closed. The next time you open Lunar Client, that skin will be gone from your list.

Do I need to extract .png skin files?

No. .png files are already in the correct format and can go directly into the skins folder. Only .zip files need to be extracted first. If you see a .png file in your Downloads folder, you can move it straight to the skins folder without any other steps.