SkinsAndCapes

SkinsAndCapes

A client-side mod that loads player skins and capes by username/uuid from an HTTP source you control — HD textures, animated GIF/APNG, one shared engine across Minecraft 1.7.10 through 1.21.1.

If none of your configured sources return anything for a player, their vanilla skin is left untouched. There is no Mojang or third-party fallback baked in; the mod only ever shows what your sources hand it.

Client-side only — nothing needs to be installed on the server.

Install

1. Grab the jar for your Minecraft version and loader from Releases and drop it into mods/.
2. Add its runtime dependency, if it has one:
   • 1.7.10 — UniMixins
   • 1.12.2 — MixinBooter
   • Fabric builds — Fabric API
   • Forge 1.19/1.20.1 and NeoForge 1.21.1 need nothing extra.
3. Launch the game once. The mod writes a disabled config to config/skinsandcapes.json; edit it (see below) to point at your source.

Configuration

Everything lives in config/skinsandcapes.json. loadlist starts empty, which means the mod changes nothing. Add one or more sources to turn it on. Edits are re-read while the game is running — no restart needed.

Any URL may contain {nickname}, {uuid}, or {uuid_dashed}.

Direct source

Point straight at the finished texture:

{
  "enableSkin": true,
  "enableCape": true,
  "enableAnimation": true,
  "hdMaxResolution": 512,
  "loadlist": [
    {
      "name": "my-cdn",
      "type": "direct",
      "priority": 100,
      "skin": "https://example.com/skins/{nickname}.png",
      "cape": "https://example.com/capes/{nickname}.png",
      "model": "auto"
    }
  ]
}

model is auto (detect slim vs. wide from the texture), slim, or wide.

API source

Point at an endpoint that tells the mod where the textures are. format is json, text, or redirect:

{
  "name": "my-api",
  "type": "api",
  "priority": 200,
  "url": "https://example.com/api/{uuid}",
  "format": "json",
  "json": { "skin": "textures.skin.url", "cape": "textures.cape.url", "model": "textures.skin.model" }
}

With more than one source, they are tried from the lowest priority value upward and the first that returns a texture wins.

Other keys