CustomSkinLoader

CustomSkinLoader

Custom Skin Loader mod for Minecraft.

by
22.3M Downloads
fabricforgeneoforgequiltdecoration
Configure a Compatible Minecraft Server

About this Mod

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:

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

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

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.

Available Versions

CustomSkinLoader_Universal_15.0.1release
MC 1.8, 1.8.8, 1.8.9, 1.9, 1.9.4, 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.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2fabric, forge, neoforge, quilt
June 21, 2026
CustomSkinLoader_Universal_15.0release
MC 1.8, 1.8.8, 1.8.9, 1.9, 1.9.4, 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.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2fabric, forge, neoforge, quilt
June 20, 2026
CustomSkinLoader_Universal_14.28release
MC 26.1, 26.1.1, 26.1.2fabric, quilt
April 5, 2026
CustomSkinLoader_Universal_14.28release
MC 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.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2forge, neoforge
March 27, 2026
CustomSkinLoader_Fabric_14.28release
MC 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.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11fabric, quilt
March 27, 2026

How to Install CustomSkinLoader on Your Client

1

Install the Mod Loader Locally

Install fabric for your local Minecraft version.

2

Download the Matching File

Choose the CustomSkinLoader file for fabric and Minecraft 26.2.

3

Install Mod

Place the .jar file in your local .minecraft/mods folder and restart Minecraft. No server-side installation is required.

Compatibility

Mod Loaders

fabricforgeneoforgequilt

Minecraft Versions

26.2, 26.1.2, 26.1.1 (+300 more)

Server-side

Unsupported

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

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 Minecraft mods folder. Your server can remain unchanged unless the mod 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 26.2, 26.1.2, 26.1.1. 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. Put the .jar file in your local .minecraft/mods folder and remove older duplicates. Because this mod is client-side, adding server RAM will not fix it.

Minecraft Server for Your Group

CustomSkinLoader stays on your client. Host a compatible world for your group.

Recommended RAM
4 GBfrom €5.2/mo
Minimum 3 GB | per 8 players
Create Server Now
Client Compatibility Guide
NVMe SSD Storage
DDoS Protection included

Details

License
GNU General Public License v3.0 only
Server-side
Unsupported

Supported Versions

26.226.1.226.1.126.11.21.111.21.101.21.91.21.81.21.71.21.6+293 more