Need help with MCCustomSkinLoader?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

266 Stars 18 Forks 330 Commits 12 Opened issues


Custom Skin Loader for Minecraft

Services available


Need anything else?

Contributors list

# 245,525
221 commits
# 373,428
48 commits
# 597,585
4 commits
# 403,453
1 commit
# 84,658
1 commit
# 153,938
1 commit
# 534,749
1 commit


What's this?

Custom Skin Loader mod for Minecraft.
It's a mod which can load skins and capes from any online source or from your local.


Build Server : CircleCI & ~~Infinity Studio CI~~
Release Page : MCBBS & GitHub & CurseForge


Support Plenty of Skin Load API and Customizable Skin Load List

Supported Skin Load APIs:
- Mojang API
- CustomSkinAPI
- CustomSkinAPIPlus (Test Only)
- UniSkinAPI
- ElyByAPI
- Legacy

You can use this feature to customize your skin load list so as to load your skins from any skin server you want.
If you are the owner of skin server, you can use CustomSkinLoader to load skins from your server if one of the APIs has been actualized by your server.

HD Skins Support

Even though you don't have OptiFine and MCPatcher, CustomSkinLoader can still load and render HD skins.
You can easily to get a better view of skins.

Skull Support

Fixed skull loading bug, you can apply any skin to your skull now.
Dynamic skull supported.

Profile Cache

  • Decrease the frenquency of using the network.
  • Meanwhile, you can still load profiles when network is unavailable.(*)

*Only when it is opened in configratulation.

Local Skin

Load skins without a skin server.
Furthermore, by using this function you can preview your skins in game and even change the default skin and model.
You can load local skins by using any API (excluding MojangAPI).
*While using default configratulation, just put your skins into


Extra List

A json file generated by skin servers which supports this feature.
To add a server to your load list, users just need to put the file into


Transparent Skin Support

The problem of incorrectly rendering textures has been fixed.

Spectator Menu Fixed

By using this mod, you can see correct avatar of players in Spectator Menu rather than steve and alex.

Default Load List

  • Mojang (Mojang API)
  • LittleSkin (CustomSkinAPI)
  • Blessing Skin (CustomSkinAPI)
  • ElyBy (ElyByAPI)
  • SkinMe (UniSkinAPI)
  • LocalSkin (Legacy)
    If you want to apply to add other skin server to default list, please go to issue.

To Skin Server Owner

CustomSkinLoader is designed for loading from any server, which makes the mod complex.
It's not a good idea to refer to CustomSkinLoader's source code to develop your own skin mod.
It's recommended to use CustomSkinLoader for your server directly.
Furthermore, you can add your server to 'Default Load List'.
You can also use 'ExtraList' which makes it easier for users to add your server into load list.

Development and Contribution


Copyright & LICENSE

Binary File

You could not modify binary file.
Feel free to use and share this mod and unmodified file in anyway like modpack.
When using in modpack, you must put 'CustomSkinLoader' in mod list.
You could not repost this mod to any website without permission.
You could not earn money with this mod excluding modpack.

Source Code

Package 'customskinloader'

Including some codes from - AsteriskTeam/TabIconHackForge (GPLv3) - RecursiveG/UniSkinMod (GPLv3)
- NekoCaffeine/Alchemy (GPLv3)

Copyright © 2013-2014 Jeremy Lam "JLChnToZ".
Copyright © 2014-2019 Alexander Xia "xfl03".

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.


You should change the name of the package to avoid others' misunderstanding.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.