If you like this mod or think it's useful, could you give me a star on GitHub?

How to Use

Please see it at GitHub.

You can chat with us in Telegram: https://t.me/CustomSkinLoader

Install Guide

Download the jar named with "Forge" for Forge or "Fabric" for Fabric.

Put the jar into ".minecraft/mods" folder.

The jar can be used in 1.8-1.16.5.

What's this? 

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

What can you do with it?

- Restore official skins

- Use skins offline

- Load skins from 3rd-party site

- Even load skins from your computer

- Make a dynamic skull

- Apply HD and transparent skins

- Do what you can imagine with skins

Feature

Plenty of Skin Load API Support and Customizable Skin Load List

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

In the default list, we restored skins from Mojang. And if you need upload skins to 3rd-party source, you can put it into LittleSkin if in China, while ElyBy is recommened for other users.

HD Skins Support

Even though there is no Optifine or MCPatcher, CustomSkinLoader has fix this problem.
You can easily to get a better view in skin.

Skull Support

Fixed skull load bug, and Dynamic skull is supported.

Profile Cache

Cache profile into file, and it can be used without network.

Local Skin

Load skin without skin server.
Furthermore, by using this function you can preview your skin in game and even change default skin and model.
You can load local skin by using any API(excluding MojangAPI).

Transparent Skin Support

The problem of rendering incorrect texture 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.

FAQ

 - Q: My friends can't load my skin!

    A: CustomSkinLoader is a client mod, so make sure your friends also install it and you are not using a local skin.

 - Q: Default 3rd party online skin website.

    A: Arranged in the default load order: LittleSkin  BlessingSkin  Elyby  SkinMe  GlitchlessGames

- Q: How can I modify configurations of CustomSkinLoader?

   A: The config file is .minecraft/CustomSkinLoader/CustomSkinLoader.json . Unfortunately, there is no way to modify the CustomSkinLoader configuration file in the game currently, so you need to manually modify it by using a code editor (e.g. VSCode). However, we have a website to modify the configuration file online, you only need to import and modify your current configuration file.

- Q: What is the meaning of each item in the config file?

   A: There is a document written in Chinese.

 - Q: CustomSkinLoader always load Mojang skins instead of custom skins.

    A: CustomSkinLoader has the highest default priority for loading Mojang skins, so you should modify "loadlist" in config file. 

CustomSkinLoader

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.

Download

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

Contact Us

QQ Group: 651287593
Telegram: @customskinloader

Feature

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 .minecraft/CustomSkinLoader/LocalSkin/(skin|cape)s/{USERNAME}.png.

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 .minecraft/CustomSkinLoader/ExtraList .

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)
• TLauncher (ElyByAPI)
• 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

See CONTRIBUTING.md

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.

GPLv3: http://www.gnu.org/licenses/gpl.html

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