Cape Provider

Modrinth

Provides you with capes! You can choose from various providers or add your own

6.5M downloads164 followersUpdated 15h ago

5.6.2 · MC 26.3 · Fabric

View on Modrinth

Files

6.0.0-SNAPSHOT
alpha
6.0.0-SNAPSHOT
26.3fabric
2026-11-01 · 435 downloads
cape-provider-6.0.0-SNAPSHOT.jar · 224 KB
1 more file
- cape-provider-6.0.0-SNAPSHOT-sources.jar
5.6.2
release
5.6.2
26.3fabric
2026-10-10 · 675K downloads
cape-provider-5.6.2.jar · 200 KB
1 more file
- cape-provider-5.6.2-sources.jar
5.6.1
release
5.6.1
26.3fabric
2026-09-15 · 513K downloads
cape-provider-5.6.1.jar · 200 KB
1 more file
- cape-provider-5.6.1-sources.jar
5.6.0
release
5.6.0
26.326.3-rc-326.3-rc-2fabric
2026-09-13 · 812 downloads
cape-provider-5.6.0.jar · 200 KB
1 more file
- cape-provider-5.6.0-sources.jar
5.5.1
release
5.5.1
26.2fabric
2026-09-12 · 200.4K downloads
cape-provider-5.5.1.jar · 200 KB
1 more file
- cape-provider-5.5.1-sources.jar
5.5.0
release
5.5.0
26.2fabric
2026-06-17 · 2.2M downloads
cape-provider-5.5.0.jar · 199 KB
1 more file
- cape-provider-5.5.0-sources.jar
5.4.3
release
5.4.3
26.1.2fabric
2026-06-15 · 273.7K downloads
cape-provider-5.4.3.jar · 198 KB
1 more file
- cape-provider-5.4.3-sources.jar
5.4.2
release
5.4.2
26.1.2fabric
2026-06-08 · 302.8K downloads
cape-provider-5.4.2.jar · 198 KB
1 more file
- cape-provider-5.4.2-sources.jar
5.4.1
release
5.4.1
26.1.2fabric
2026-06-07 · 1.2K downloads
cape-provider-5.4.1.jar · 201 KB
1 more file
- cape-provider-5.4.1-sources.jar
5.4.0
release
5.4.0
26.1.2fabric
2026-05-07 · 491.3K downloads
cape-provider-5.4.0.jar · 198 KB
1 more file
- cape-provider-5.4.0-sources.jar
5.3.2
release
5.3.2
26.1.2fabric
2026-05-01 · 89K downloads
cape-provider-5.3.2.jar · 198 KB
1 more file
- cape-provider-5.3.2-sources.jar
5.3.1
release
5.3.1
26.1.2fabric
2026-04-12 · 181.9K downloads
cape-provider-5.3.1.jar · 198 KB
1 more file
- cape-provider-5.3.1-sources.jar
5.3.0
release
5.3.0
26.1.2fabric
2026-04-11 · 77.2K downloads
cape-provider-5.3.0.jar · 198 KB
1 more file
- cape-provider-5.3.0-sources.jar
5.2.0
release
5.2.0
26.1.226.1.126.1fabric
2026-03-24 · 317.4K downloads
cape-provider-5.2.0.jar · 203 KB
1 more file
- cape-provider-5.2.0-sources.jar
5.1.0
release
5.1.0
1.21.11fabric
2026-02-22 · 1M downloads
cape-provider-5.1.0.jar · 205 KB
1 more file
- cape-provider-5.1.0-sources.jar
5.0.0.0-legacy+1.21.1
release
5.0.0.0-legacy+1.21.1
1.21.11.21fabric
2026-01-18 · 17.9K downloads
cape-provider-5.0.0.0-legacy+1.21.1.jar · 190 KB
1 more file
- cape-provider-5.0.0.0-legacy+1.21.1-sources.jar
5.0.0
release
5.0.0
1.21.11fabric
2025-12-23 · 13.9K downloads
cape-provider-5.0.0.jar · 200 KB
1 more file
- cape-provider-5.0.0-sources.jar
4.3.1.0-legacy+1.21.10
release
4.3.1.0-legacy+1.21.10
1.21.10fabric
2025-12-17 · 28.2K downloads
cape-provider-4.3.1.0-legacy+1.21.10.jar · 176 KB
1 more file
- cape-provider-4.3.1.0-legacy+1.21.10-sources.jar
4.3.1
release
4.3.1
1.21.11fabric
2025-12-17 · 1.4K downloads
cape-provider-4.3.1.jar · 176 KB
1 more file
- cape-provider-4.3.1-sources.jar
4.3.0
alpha
4.3.0
1.21.11fabric
2025-12-17 · 158 downloads
cape-provider-4.3.0.jar · 176 KB
1 more file
- cape-provider-4.3.0-sources.jar

Show more files (20 more)

Files are delivered unmodified from Modrinth's servers and verified against the SHA-512 hash published by the project. The project's license applies to every file; check it before redistributing.

Gallery

About

Provides you with capes!

You can choose from various providers or add your own.

Improved/Reworked version of the "Capes" mod:

Improved and easier cape provider integration
Allows ordering providers
Support for custom providers
More options to fine tune how capes are applied
Written only in Java (no Kotlin needed)
Various fixes and improvements

Creating a custom cape provider

The mod provides many different ways how a provider can be added.

The following possibilities are sorted by simplicity:

Simple Local Provider

Recommended for:

Users that just want a customizable cape

Modpacks (using config/cape-provider/simple-custom)

The simplest way to display a cape is by going into the config/cape-provider directory and creating a cape texture file named cape.png.

Additionally there are the following optional files:

owners.txt - Determines which player names or UUIDs will get the cape displayed. If this file is not present then all players will display with the cape.
name.txt - To override the display name of the provider

You can also add more providers by creating corresponding directories in config/cape-provider/simple-custom.
Example: config/cape-provider/simple-custom/my-super-cool-provider/cape.png

Remote Provider in configuration

Recommended for:

Users that want to add a custom remote provider

This demo showcases how to apply the capes inside custom-cape-demo.

Open the config file located in config/cape-provider/config.json

In the remoteCustomProviders section add the following entry:

{
  "id": "cp1",
  "name": "CustomProvider1",
  // You can replace uuid with $id, $name or $idNoHyphen to customize the cape per Player
  "uriTemplate": "https://raw.githubusercontent.com/litetex-oss/mcm-cape-provider/refs/heads/dev/custom-cape-demo/uuid.png"
}

Example for SkinMC

{
  "id": "skinmc",
  "name": "SkinMC",
  "uriTemplate": "https://skinmc.net/api/v1/skinmcCape/$id"
}

Restart the game and activate the provider

For more details have a look at RemoteCustomProvider and RemoteCustomProviderConfig

NOTE: Texture resolvers can be selected using the textureResolverId attribute (see below for details).

via Mods

Recommended for:

Mods

If you are a mod developer and want to e.g. display a cape for supporters or contributors of your mod, you can provide it using the mod's resources and/or metadata in fabric.mod.json. The overall behavior is similar to how modmenu handles this.

Local/Simple (Recommended)

This approach requires no network communication and is the recommended way. It works by reading metadata and resources from the cape directory.

Here is an example:

Add the following mod metadata: fabric.mod.json

{
  ...
  "custom": {
    "cape": "Contributors"
  }
}

Create a cape directory inside resources
Add the cape texture in cape/cape.png
Add the players that should be given the cape in cape/owners.txt with their UUIDs or names

Note: There is also a more detailed variant

fabric.mod.json

{
  "custom": {
    "cape": {
      "name-extra": "Contributors",
      "owners": {
        // You can also used UUIDs
        "names": [
          "Notch"
        ]
      }
    }
  }
}

The mod uses this strategy itself. See the fabric.mod.json or cape directory for details.

Remote

Here's an example implementation that shows how a remote cape provider can be added:

fabric.mod.json

{
  ...
  "custom": {
    "cape": "https://raw.githubusercontent.com/litetex-oss/mcm-cape-provider/refs/heads/dev/custom-cape-demo/uuid.png"
  }
}

Here's a more detailed variant

fabric.mod.json

{
  "custom": {
    "cape": {
      // Gives everyone a christmas cape
      // You can also use variables here, like $uuid. See above for more details
      // You may have to escape the $ with \ or you can alternatively use § instead of $
      // Alternative: "uriTemplate"
      "url": "https://example.org/textures/§uuid.png",
      "changeCapeUrl": "https://...",
      "rateLimitedReqPerSec": 20 // Default is 20
    }
  }
}

Programmatic

You can also create a programmatic cape provider.

Further notes

Maximum size

Images/Textures should not exceed 10MB. Otherwise they might be ignored.

Texture resolvers / Animated textures

The following resolvers are currently built-in:

Resolver-ID	Animated	Format	Example	Notes
`default` / null	❌	PNG	uuid.png
`sprite`	✔	Stacked PNG	animated.png
`gif`	✔	GIF	animated.gif	Usage not recommended GIFs require more resources when compared to more modern formats like PNG.

Please note that animated textures can be frozen or completely disabled in the settings.

Cape Provider

Files

6.0.0-SNAPSHOT

5.6.2

5.6.1

5.6.0

5.5.1

5.5.0

5.4.3

5.4.2

5.4.1

5.4.0

5.3.2

5.3.1

5.3.0

5.2.0

5.1.0

5.0.0.0-legacy+1.21.1

5.0.0

4.3.1.0-legacy+1.21.10

4.3.1

4.3.0

Gallery

About

Creating a custom cape provider

Simple Local Provider

Remote Provider in configuration

via Mods

Local/Simple (Recommended)

Remote

Programmatic

Further notes

Maximum size

Texture resolvers / Animated textures