
Modrinth · Fabric, Forge, NeoForge, Quilt · Client mod
CustomSkinLoader
CustomSkinLoader is a client-side mod. Install it on your computer; the server does not need it.
Custom Skin Loader mod for Minecraft.
- Downloads
- 25.3M
- Author
- xfl03
- Loader
- Fabric, Forge, NeoForge, Quilt
- Minecraft
- 1.10 – 26.3
- Updated
- –
Setup
Install CustomSkinLoader on your client
Client-side mods only run on your computer. More server RAM does not change their performance.
- 01
Install the loader locally
Install Fabric or Forge or NeoForge or Quilt for your Minecraft version in your launcher.
- 02
Download the file
Download the CustomSkinLoader file for your loader and your exact Minecraft version, for example 3D-Shareware-v1.34.
- 03
Add it to the mods folder
Put the .jar file in your local .minecraft/mods folder and remove older duplicates.
- 04
Launch
Launch Minecraft with the loader profile. Nothing needs to change on the server.
- On the server
- Not needed
- On the client
- Required
- Loader
- Fabric, Forge, NeoForge, Quilt
- Minecraft
- 3D-Shareware-v1.34, 26.3, 26.2 +301 more
- License
- GNU General Public License v3.0 only
Releases
Published releases
Pick the file that matches your server’s loader and Minecraft version. The server and players need the same release.
CustomSkinLoader · Modrinth- CustomSkinLoader_Universal_15.0.1June 21, 2026Minecraft 1.10, 1.10.2, 1.11, 1.11.2, 1.12, 1.12.1, 1.12.2, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.8, 1.8.8, 1.8.9, 1.9, 1.9.4, 26.1, 26.1.1, 26.1.2, 26.2 · Fabric, Forge, NeoForge, Quilt
- CustomSkinLoader_Fabric_14.21November 6, 2024Minecraft 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.8, 1.8.1, 1.8.2, 1.8.3, 1.8.4, 1.8.5, 1.8.6, 1.8.7, 1.8.8, 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4 · Fabric
Original description by the project author
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.
Does CustomSkinLoader need to be installed on the Minecraft server?
No. Modrinth marks CustomSkinLoader as unsupported on the server side. Install it only in your local mods folder. Your server can stay unchanged unless the project page lists an additional dependency.
Which version and loader does CustomSkinLoader require?
Use a file for Fabric, Forge, NeoForge, Quilt and your exact Minecraft version. Supported versions include 3D-Shareware-v1.34, 26.3, 26.2. Files for different loaders are not interchangeable.
CustomSkinLoader is not working – what should I check?
First check the Minecraft version, loader version and required dependencies. Because the mod is client-side, more server RAM will not fix it.
Similar mods
Popular mods in the same category
Client only
Iris Shaders
by coderbot
A modern shader pack loader for Minecraft intended to be compatible with existing OptiFine shader packs
Client only
[ETF] Entity Texture Features
by Traben
Emissive, Random & Custom texture support for entities in resourcepacks just like Optifine but for Fabric
Client only
[EMF] Entity Model Features
by Traben
EMF is an, OptiFine format, Custom Entity Model replacement mod available for Fabric and Forge.
Client only
Not Enough Animations
by tr7zw
Bringing first-person animations to the third-person
Looking for mods for your own server?
The catalog lists mods that run on Minecraft servers.