Cape physics and animation
Default Minecraft renders player capes as flat, rigid slabs. Wavey Capes changes this behavior by rendering the cape as a flexible piece that bends and moves naturally with your character. It calculates physics for movement, turns, and wind to make the cloth flow instead of sticking straight out.
You don't need anything installed on the server to see these effects. The mod is purely visual and client-side. That means you can join any multiplayer server and keep your cape animations active.
Available visual styles
You can adjust the mod through an in-game config screen found in your mod list. The menu lets you tweak wind effects, adjust physics settings, and pick between four distinct rendering styles.
Simulation V2 is the default choice. It adds left and right swaying, improved bending angles, and reworked resistance while underwater. If you prefer the older look, the standard Simulation style brings back earlier physics calculations. Classic style adds a simple bend into the cape without complex motion. Dungeons style replicates the cape behavior from Minecraft Dungeons.
Mod compatibility
This mod doesn't give you a cape. You must already have a Mojang cape, or you can use a supported third-party cosmetic mod to display one.
Several popular cosmetic and animation mods work out of the box. Fabric Capes, MinecraftCapes, Essential, Shoulder Surfing Reloaded, and Ears are fully supported. Here's the thing, player Animator is supported too, including mods built on it like Better Combat and Emotecraft. Wynntils works on Fabric and NeoForge for version 1.21.11. LabyMod works if you open its cosmetics settings and change the cloak animation option to Wavey Capes.
Some mods have limited or absent support. More Banner Features only supports the older style. Lunar Client isn't supported.
Limitations and modpacks
A few visual quirks can happen during gameplay. In Simulation V2 style, swimming or crawling can cause the cape to fold the wrong way. Custom inventory slots like Curios are ignored for cape offsets. The mod also ignores mods that hide chestplates, like Show my Skin, when calculating the cape offset.
The project uses the tr7zw Protective License. You can include it in modpacks hosted on CurseForge or Modrinth without asking for permission. Redistributing the jar files elsewhere isn't allowed.
