ModsFinder

CustomSkinLoader

by xfl03

CustomSkinLoader loads custom skins, capes or elytra textures from online skin APIs or from local files.

FabricForgeNeoForgeQuiltClient-side onlyGNU General Public License v3.0 onlyOpen source1.8 – 26.3

What it does

Textures are read from a configurable load list of skin servers and special skin sites, and from files kept on the player's own computer. HD skins and capes are supported, and OptiFine capes are rewritten into the standard cape layout when required. Local textures go under the default folders inside the game directory, so no server is required to use them.

Skin server owners can offer their server to players by providing an ExtraList JSON file, which users place in the CustomSkinLoader folder inside .minecraft to add it to the list. Render patches keep skin and cape transparency correct on the versions that need them. Open source under the GNU General Public License v3.0 only, its source code, issue tracker and wiki are public. Published for Fabric, Forge, NeoForge and Quilt across 75 release versions, with snapshot builds also available.

Key features

  1. Multiple skin sources

    The load list can include several skin servers and special skin sites, so skins and capes come from more than one place.

  2. HD skins and capes

    High-resolution skins and capes load as well, and OptiFine cape textures are converted when needed.

  3. Local texture folders

    Skins, capes and elytra textures can be placed in folders on the player's computer and loaded without a server.

  4. Server-hosted lists

    Skin servers can publish an ExtraList JSON file that users add to their folder to include the server in the load list.

  5. Transparency patches

    Render patches keep semi-transparent areas of skins and capes displaying as intended on supported releases.

Compatibility

Latest build for each game version and loader.

26.x5 of 5 versions with builds
26.315.1-Universal15.1-Universal15.1-Universal15.1-Universal
26.215.1-Universal15.1-Universal15.1-Universal15.1-Universal
26.1.215.1-Universal15.1-Universal15.1-Universal15.1-Universal
26.1.115.1-Universal15.1-Universal15.1-Universal15.1-Universal
26.115.1-Universal15.1-Universal15.1-Universal15.1-Universal
1.21.x12 of 12 versions with builds
1.21.1115.1-Universal15.1-Universal15.1-Universal15.1-Universal
1.21.1015.1-Universal15.1-Universal15.1-Universal15.1-Universal
1.21.915.1-Universal15.1-Universal15.1-Universal15.1-Universal
1.21.815.1-Universal15.1-Universal15.1-Universal15.1-Universal
1.21.715.1-Universal15.1-Universal15.1-Universal15.1-Universal
1.21.615.1-Universal15.1-Universal15.1-Universal15.1-Universal
1.21.515.1-Universal15.1-Universal15.1-Universal15.1-Universal
1.21.415.1-Universal15.1-Universal15.1-Universal15.1-Universal
1.21.315.1-Universal15.1-Universal15.1-Universal15.1-Universal
1.21.215.1-Universal15.1-Universal15.1-Universal15.1-Universal
1.21.115.1-Universal15.1-Universal15.1-Universal15.1-Universal
1.2115.1-Universal15.1-Universal15.1-Universal15.1-Universal
1.20.x7 of 7 versions with builds
1.19.x5 of 5 versions with builds
1.18.x3 of 3 versions with builds
1.17.x2 of 2 versions with builds
1.16.x6 of 6 versions with builds
1.15.x3 of 3 versions with builds
1.14.x5 of 5 versions with builds
ReleaseBetaAlphaNot available

This mod also publishes snapshot builds. Snapshots are not shown in the matrix.

27 older game versions (1.8 – 1.13.2) not shown. All files on Modrinth

Required by 2 mods

Skin Stealer1.21.4 – 1.21.8InstantSkin1.12.2

Use cases

Using a skin server

A player who already has skins on a skin server adds the server to the load list, or to ExtraList, and the textures appear in game.

Personal textures

A player keeps custom capes and elytra textures in local folders and loads them without any online service.

Who it’s for: Custom skin, cape and elytra texture users, and skin server owners who want their server reachable from the load list.

How it compares

Full comparison

Histoskins is client-side only, works on Fabric and Quilt for 1.20.2 – 26.1.2, uses All rights reserved and is not open source. Wavey Capes is client-side only, runs on Fabric, Forge, NeoForge and Quilt for 1.8.8 – 26.3, and is under a custom license that is not open source. Skinss+ is server required with client optional, works on Fabric and Forge for 1.18.2 – 1.21.8, and is under the MIT License.

ModLoadersGame versionsEnvironmentUpdated
CustomSkinLoaderFabric, Forge, NeoForge and Quilt1.8 – 26.3Client-side only2026-10-11
HistoskinsFabric and Quilt1.20.2 – 26.1.2Client-side only2026-04-05
Wavey CapesFabric, Forge, NeoForge and Quilt1.8.8 – 26.3Client-side only2026-09-18
Skinss+Fabric and Forge1.18.2 – 1.21.8Server required, client optional2026-07-04

Questions

Does CustomSkinLoader need to be installed on the server?

No. Only the player's game needs the mod, since it is client-side only. Skin servers only need to publish an ExtraList file or be added to the default load list.

Which loader should a player pick for 26.3?

Fabric, Forge, NeoForge and Quilt all have a 15.1-Universal file for 26.3, released 2026-10-11, so the choice depends on the loader already used in the modpack.

How is a skin server added to the list?

A server owner can provide an ExtraList JSON file. The user places it in the CustomSkinLoader folder inside .minecraft, and the server is added to the load list.

Do other mods depend on CustomSkinLoader?

Two catalog mods require it: Skin Stealer and InstantSkin.

In the catalog

CustomSkinLoader is one of 12,078 Decoration mods on ModsFinder, and one of 6,982 Decoration mods for Fabric. 8,071 mods support Minecraft 26.3.

Decoration mods12,078Fabric modsMods for 26.38,071

More from xfl03

All projects
I18nUpdateMod1.6.1 – 1.21.10

Similar mods

[ETF] Entity Texture Features1.16.5 – 26.3Not Enough Animations1.16.5 – 26.3Continuity1.17.1 – 26.3LambDynamicLights - Dynamic Lights1.16.2 – 26.3Presence Footsteps1.7.10 – 26.3AmbientSounds1.12.2 – 26.3

What the author says

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…
xfl03, on the Modrinth page

Official listing

Owner
xfl03
Published
2021-10-15
Updated on Modrinth
2026-10-11
Facts verified
2026-10-15

Tags

Decoration
Open on ModrinthCompare