SmoothPlayerAnimations
Creating smoother animations for players
39 config settings
Build 1.0.0+1.21.1 · checked 13 September 2026
Guides
- SmoothPlayerAnimations: Locomotion and Procedural Physics
- SmoothPlayerAnimations: Combat Motions and Custom Item Rules
Config
- Slime Bounce
bouncesmoothplayeranimations— Slime-block bounce animation. - Climb
climbsmoothplayeranimations— Ladder/vine climbing animation. Off = vanilla. - Crawl
crawlsmoothplayeranimations— Crawling animation. Off = vanilla.
Show all 39 settings
- Elytra Glide
elytrasmoothplayeranimations— Elytra gliding pose. Off = vanilla. - Fall
fallsmoothplayeranimations— Falling animation. Off = vanilla. - Basic Movement
groundMovesmoothplayeranimations— Idle, walking and running. Off = vanilla. - Held-Item Idle
heldItemIdlesmoothplayeranimations— Special idle pose while holding certain items (e.g. a poppy). - Horse Riding
horseRidingsmoothplayeranimations— Riding pose on horses. Off = vanilla seat. - Idle Fidgets
idleSpecialsmoothplayeranimations— Occasional random fidget animations while standing still. - Jump
jumpsmoothplayeranimations— Jump animation. Off = vanilla. - Sneak
sneaksmoothplayeranimations— Sneaking animation. Off = vanilla. - Sprint Stop
sprintStopsmoothplayeranimations— Skid animation when stopping a sprint. Off by default. - Step Down
stepDownsmoothplayeranimations— A light step animation when walking off stairs or low ledges. - Swim
swimsmoothplayeranimations— Swimming animation. Off = vanilla. - Walk Backwards
walkBacksmoothplayeranimations— Dedicated animation when walking backwards. - Enable Mod
enabledsmoothplayeranimations— Master switch. When off, the mod stops driving animations entirely and vanilla takes over. - Better Combat Library
betterCombatLibrarysmoothplayeranimations— Which Better Combat to integrate with. AUTO detects it; only override if attacks misbehave: MODERN_PAL = BC 3.x (MC 1.21.8+), LEGACY_KOSMX = BC 2.x (MC 1.21.1). Requires a restart. - Let Other Mods Control Arms
letOthersControlArmssmoothplayeranimations— When another animation mod is driving the player, hand the arms over to it. - Animation Priority
modPrioritysmoothplayeranimations— Animation layer priority. Keep it low so combat mods' weapon poses win over our arms. Requires a game restart. - Animation Smoothness
smoothnesssmoothplayeranimations— Crossfade length between animations (ticks). Higher = smoother but slower. - Landing Jelly
bodyJellysmoothplayeranimations— On touchdown the body squashes and springs back with a little overshoot. Off by default. - Jelly Strength
bodyJellyStrengthsmoothplayeranimations— How strong the landing squash and overshoot are (0-100%). - Body Turn Lean
bodyLeansmoothplayeranimations— Bank the body into turns while moving, like third-person action games. - Lean Angle
bodyLeanDegreessmoothplayeranimations— Maximum lean angle on a hard turn (degrees). - CEM Animation Engine
cemAnimationsmoothplayeranimations— Play the bundled or an installed CEM/EMF (OptiFine-format) animation pack on the base layer. Turning this OFF also disables the bundled HuaXiaoSheng clip set: swings/holds/uses/idles fall back to vanilla, while walk/run/jump/fall revert to Kevin Merrill's MIT animations; to keep the HuaXiaoSheng set… - Axe Swing
axesmoothplayeranimations— Swing with an axe. - Bow Draw
bowsmoothplayeranimations— Bow drawing and aiming animation. - Crossbow Load
crossbowsmoothplayeranimations— Crossbow loading animation. - Hoe Swing
hoesmoothplayeranimations— Swing with a hoe. - Mace Swing
macesmoothplayeranimations— Mace swing animation. Off by default. - Held Map
mapsmoothplayeranimations— Pose while holding an opened map. Off by default. - Pickaxe Swing
pickaxesmoothplayeranimations— Mining swing with a pickaxe. - Punch
punchsmoothplayeranimations— Empty-hand swing animation. - Shield Raise
shieldsmoothplayeranimations— Shield blocking pose. - Shovel Swing
shovelsmoothplayeranimations— Digging swing with a shovel. - Spear Swing
spearsmoothplayeranimations— Spear swing animation. Off by default. - Sword Swing
swordsmoothplayeranimations— Left-click swing with a sword. - Trident Swing
tridentAttacksmoothplayeranimations— Trident melee swing animation. - Trident Throw
tridentThrowsmoothplayeranimations— Trident charge-and-throw animation.
Requires
| Mod | Needed | Versions |
|---|---|---|
player_animation_library |
required | [1.0,) |
cloth_config |
required | [1.0,) |
Frequently Asked Questions
What parts of the character model bend in SmoothPlayerAnimations?
Elbows, knees, and the spine bend dynamically, allowing the character model, armor, and skins to curve smoothly at the joints.
How do you adjust how much your character leans into turns?
Enable "Body Turn Lean" in the procedural animation settings and adjust the maximum banking tilt using the "Lean Angle" slider.
What does the Landing Jelly option do?
When enabled, "Landing Jelly" causes the character model to squash slightly upon landing from a fall and spring back into shape.
Can you assign custom animations to modded weapons?
Yes, using the "Item Animation Rules" editor, you can match modded item IDs and bind them to specific hold, swing, or use animations.
Can individual locomotion animations like crawling or swimming be toggled off?
Yes, the "Animation Toggles" menu allows players to independently toggle animations like "Crawl", "Swim", or "Climb" back to vanilla behavior.