Skip to content

CapesClient cape override mod

Merge Mojang capes with a moderated Uebliche catalog and render the selected public cape in-game.

Capes preview

Overview

Capes is a client-side mod plus shared launcher and API surface for curated cape selection. Mojang capes remain vanilla-native and launcher-local, while public Uebliche capes are uploaded, moderated, selected per account, and resolved by the Public API.

Runtime behavior

  • If a player has an active public uebliche cape selection, the client loads that texture and overrides only the cape layer.
  • If no public uebliche cape is active, the client leaves Mojang or vanilla cape rendering untouched.
  • The launcher skin editor may preview capes and set the active account selection, but it does not persist cape ids inside saved skin projects.

Build

bash
# Fabric
export JAVA_HOME=/Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home
./gradlew :loader-fabric:build -PonlyLoader=fabric

# NeoForge
export JAVA_HOME=/Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home
./gradlew :loader-neoforge:build -PonlyLoader=neoforge

Feature checklist

Track feature progress in the checklist.

Feature highlights

  • Shared cape domain
  • Multi-loader build
  • Mixed-source browser flow
  • Public cape overrides
  • Add feature checklist page to track project progress.
  • Add Capes documentation overview. (#docs)