CustomSkinLoader

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?

CustomSkinLoader is a Minecraft mod that loads skins, capes, and elytra textures from online skin APIs or local files.

This branch is the Universal generation of MCCustomSkinLoader. It replaces the old edition-specific jars with one bootstrap artifact. The bootstrap jar prepares a runtime CustomSkinLoader-Common.jar, remaps it for the active Minecraft mapping namespace, and applies the required loader-specific class patches at runtime.

Supported Loaders

• Forge Legacy and Forge ModLauncher
• NeoForge
• Fabric
• Quilt-compatible Fabric Loader environments

Feature

Universal Runtime

One user-facing jar is used across supported loaders. The generated installable artifact is:

Bootstrap/build/libs/CustomSkinLoader_Universal-<version>.jar

Common/build/libs/Common-<version>.jar is the nested runtime payload and should not be installed directly.

Support Plenty of Skin Load APIs and Customizable Skin Load List

Supported skin loading APIs:

• MojangAPI
• CustomSkinAPI
• CustomSkinAPIPlus
• UniSkinAPI
• ElyByAPI
• Legacy

Supported special skin sites and profiles:

• Glitchless
• MinecraftCapes
• OptiFineCape
• Cloaks+
• Wynntils compatible profile support

You can customize the skin load list and load textures from any compatible skin server. Skin server owners can also use ExtraList files to help users add their server.

HD Skins and Capes Support

CustomSkinLoader can load and process HD skins and capes. OptiFine cape textures are converted to the standard cape format when needed.

Profile Cache

• Decreases repeated network requests.
• Allows cached profiles to load when the network is unavailable.

Local Skin

Load skins without a skin server. With the default Legacy paths, place textures under:

.minecraft/CustomSkinLoader/LocalSkin/skins/<USERNAME>.png
.minecraft/CustomSkinLoader/LocalSkin/capes/<USERNAME>.png
.minecraft/CustomSkinLoader/LocalSkin/elytras/<USERNAME>.png

Extra List

Skin servers can provide ExtraList JSON files. Users can put them into .minecraft/CustomSkinLoader/ExtraList to add servers to the load list.

Transparent Texture Support

The render patches are designed to keep skin and cape transparency correct on supported versions.

Default Load List

• Mojang (MojangAPI)
• LittleSkin (CustomSkinAPI)
• BlessingSkin (CustomSkinAPI)
• ElyBy (ElyByAPI)
• TLauncher (ElyByAPI)
• Glitchless (ElyBy-compatible profile)
• LocalSkin (Legacy)
• MinecraftCapes
• OptiFineCape
• Cloaks+

If you want to add another skin server to the default list, please open an issue.

To Skin Server Owner

CustomSkinLoader is designed for loading textures from many server implementations. It is usually better to support one of CustomSkinLoader's APIs than to copy this mod's internal implementation. If you maintain a skin server, you can provide an ExtraList file or request inclusion in the default load list.

Copyright & LICENSE

Major Contributor

• 2013-2014 Jeremy Lam (JLChnToZ)
• 2014-2024 Alexander Xia (xfl03)
• 2020-2026 ZekerZhayard

Binary File

You may use and share the unmodified official binary in modpacks. When used in a modpack, CustomSkinLoader must be listed in the mod list. Do not repost the mod to other websites without permission.

Source Code

The source code is licensed under GPL-3.0-only. See LICENSE.

Package customskinloader includes code or ideas from:

• AsteriskTeam/TabIconHackForge (GPLv3)
• RecursiveG/UniSkinMod (GPLv3)
• NekoCaffeine/Alchemy (GPLv3)

If you redistribute a modified build, change the package name and clearly mark the build as modified to avoid confusion with official CustomSkinLoader releases.