CurseForge · Minecraft mod
CustomSkinLoader
Custom Skin Loader mod for Minecraft.
Quick answer
Which CustomSkinLoader release should I use?
CustomSkinLoader_Universal_15.0.1 targets 1.16.3, 1.17.1, 1.21 with Fabric, Forge, NeoForge. The project page does not say whether it belongs on the client. The project page does not say whether it belongs on the dedicated server. No extra mods listed for this file.
Where it goes
Is CustomSkinLoader required on the client, server, or both?
The project page does not say whether it belongs on the client. The project page does not say whether it belongs on the dedicated server.
The source does not explicitly classify this release as client-only or server-only.
What else does CustomSkinLoader_Universal_15.0.1 need?
CustomSkinLoader_Universal_15.0.1. Change the file and its required mods may change too.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add CustomSkinLoader without breaking your instance.
Built for CustomSkinLoader_Universal_15.0.1. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use CustomSkinLoader_Universal_15.0.1. It targets 1.16.3, 1.17.1, 1.21 with Fabric, Forge, NeoForge; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
The project page does not say whether it belongs on the client. The project page does not say whether it belongs on the dedicated server.
- 04
Pick the file you checked
Use the “Get this file” button beside CustomSkinLoader_Universal_15.0.1. It opens that exact file at the source.
About this project
What does CustomSkinLoader add?
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.
Project description from CurseForge.
Pick your setup
CustomSkinLoader by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
26.1.2
4 loader builds26.1.1
4 loader builds26.1
4 loader builds1.21.11
4 loader builds1.21.10
4 loader builds1.21.9
4 loader builds1.21.8
4 loader builds1.21.7
4 loader builds1.21.6
4 loader builds1.21.5
4 loader builds1.21.4
4 loader buildsShowing the newest 12 of 75 game versions. Older files are in the list below.
Check the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
CustomSkinLoader versions and loaders
CustomSkinLoader_Universal_15.0.1
CustomSkinLoader_Universal-15.0.1.jar
21 Jun 2026
CustomSkinLoader_Universal_15.0
CustomSkinLoader_Universal-15.0.jar
20 Jun 2026
CustomSkinLoader_Universal_14.28
CustomSkinLoader_Universal-14.28.jar
27 Mar 2026
CustomSkinLoader_Fabric_14.28
CustomSkinLoader_Fabric-14.28.jar
27 Mar 2026
CustomSkinLoader_ForgeV1_14.28
CustomSkinLoader_ForgeV1-14.28.jar
27 Mar 2026
CustomSkinLoader_ForgeV2_14.28
CustomSkinLoader_ForgeV2-14.28.jar
27 Mar 2026
CustomSkinLoader_ForgeV1_14.27
CustomSkinLoader_ForgeV1-14.27.jar
24 Dec 2025
CustomSkinLoader_Fabric_14.27
CustomSkinLoader_Fabric-14.27.jar
24 Dec 2025
CustomSkinLoader_ForgeV3_14.27
CustomSkinLoader_ForgeV3-14.27.jar
24 Dec 2025
CustomSkinLoader_ForgeV2_14.27
CustomSkinLoader_ForgeV2-14.27.jar
24 Dec 2025
CustomSkinLoader_ForgeV3_14.26.1
CustomSkinLoader_ForgeV3-14.26.1.jar
22 Oct 2025
CustomSkinLoader_Fabric_14.26.1
CustomSkinLoader_Fabric-14.26.1.jar
22 Oct 2025
Looking for an older file? The official CurseForge project page is in Resources.