CustomSkinLoader

CustomSkinLoader is a client-side Minecraft Java mod that loads skins, capes, and elytra textures from a configurable list of skin servers instead of relying on the default Mojang lookup alone. It ships as a single Universal jar for Fabric, Forge, NeoForge, and Quilt-compatible Fabric Loader setups, with the current 15.0.1 build reaching Minecraft 26.2 on every one of those loaders. New to custom skins altogether? The Minecraft skin install guide covers the basics for both editions first.

Supported skin sources and load order

The mod checks a load list of skin APIs in order and uses the first one that returns a result for a given player. Out of the box that list includes Mojang's official API, LittleSkin and BlessingSkin (CustomSkinAPI), Ely.by-compatible ElyByAPI servers, Glitchless, plus cape-only sources such as MinecraftCapes, OptiFine capes, and Cloaks+. Server owners running a compatible skin service can publish an ExtraList file so players add their server to the load list without editing config by hand. Since CustomSkinLoader is client-side only, a server that wants to assign skins to everyone connecting, regardless of what each player has installed, needs a server-side option such as SkinsRestorer instead.

Installing CustomSkinLoader

• Download the CustomSkinLoader_Universal jar for your Minecraft version from the Modrinth page.
• Drop it into your mods folder alongside your loader of choice: Fabric, Forge, NeoForge, or a Quilt build using the Fabric Loader compatibility layer.
• No other mod is required. The latest 15.0.1 Universal build lists no hard or optional dependencies.
• Launch the game once to generate the .minecraft/CustomSkinLoader folder, where the load list and local skin files live.

Why a skin changed itself or stopped loading

A skin that changes on its own, or stops loading, almost always traces back to the load order. If a player is registered on more than one source in the list, whichever source comes first wins, so a change on that earlier service overrides one made on a lower-priority service. CustomSkinLoader also caches profiles so skins keep showing when a skin server is briefly unreachable; once the cache refreshes against a live source, the displayed skin can flip back. A local skin file placed under CustomSkinLoader/LocalSkin always takes priority over any online source for that username, which is the usual cause of a skin that will not update no matter what changes online.

Version support by loader

The 15.0.1 Universal build, released June 2026, declares support from 1.8 through 26.2 on Fabric, Forge, NeoForge, and Quilt-compatible Fabric Loader environments alike. That wide, identical range across every loader is because the bootstrap jar detects the active loader and Minecraft mapping namespace at runtime and applies loader-specific class patches, rather than shipping a separate jar per loader and version. It replaces the older edition-specific jars from previous CustomSkinLoader releases. Players who want the loaded skin's jacket, hat, and pants layers to render with real 3D depth instead of flat can pair it with 3D Skin Layers, which changes how a skin renders rather than where it comes from.