Client Custom Capes
by Werea25
Client Custom Capes lets each player choose which cape they see on screen, using PNG images hosted at custom URLs, without any change to the server.
What it does
Custom cape URLs point to PNG images that the client displays in place of the standard cape. A default cape can be set for all players, and a per-player cape can be assigned to individual players by nickname. Nickname matching ignores letter case, and resolved UUIDs are cached automatically so repeated lookups do not need to be repeated.
Two filtering modes control whose capes are shown. Whitelist mode shows capes only for the players named in the list, while blacklist mode hides capes for the players named. Changes to the lists and the default cape are made in the mod's configuration. The mod follows Mojang's cape guidelines and only overrides visuals on the client, and the original cape visibility rules stay in effect on unmodified clients.
The mod is published for Fabric only, for Minecraft 1.21.4, as version 1.0.0. It requires Cloth Config API and Fabric API. Servers do not need it; each player installs it for their own game. Functionality is opt-in and needs explicit user configuration before any custom capes appear.
Key features
Custom cape URLs
Each cape can point to a PNG image at a custom URL, which the client loads and displays on the player model.
Default cape for all players
A single default cape can be set and shown on every player who has no custom cape assigned.
Per-player cape assignment
Individual players can be given their own cape by nickname, with nickname matching that is not case-sensitive.
Whitelist and blacklist modes
Whitelist mode shows capes only for listed players, while blacklist mode hides capes for listed players.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 2
How it compares
CatCapes is client-side only and open source under the GNU General Public License v3.0 only, for 1.21 – 1.21.11. TheErrorExe's Capes is client-side only and under the MIT License, not open source, for 1.21.4 – 1.21.11. Client Custom Capes covers 1.21.4 alone and is also client-side only under the MIT License.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Client Custom Capes | Fabric | 1.21.4 | Client-side only | 2025-08-12 |
| CatCapes | Fabric | 1.21 – 1.21.11 | Client-side only | 2026-02-05 |
| TheErrorExe's Capes | Fabric | 1.21.4 – 1.21.11 | Client-side only | 2026-06-07 |
Questions
Does Client Custom Capes need Fabric API?
Does a server need to install Client Custom Capes?
Can other players see a custom cape set on one client?
Which versions are supported?
In the catalog
Client Custom Capes is one of 5,392 Social mods on ModsFinder, and one of 4,084 Social mods for Fabric. 17,979 mods support Minecraft 1.21.4.
More from Werea25
Similar mods
What the author says
This client-side mod revolutionizes how capes work in Minecraft, giving you complete control over which players display capes and what designs they use. Unlike traditional cape systems, our solution offers granular customization without requiring server modifications or special permissions. Planned enhancements…
Official listing
- Modrinth page
- modrinth.com/mod/client-custom-capes
- Owner
- Werea25
- Published
- 2025-08-12
- Updated on Modrinth
- 2025-08-12
- Facts verified
- 2026-10-15