⚠️ UNOFFICIAL PORT

This is an unofficial community port for Minecraft 1.21.10

• Original Author: KosmX
• Original Project: GitHub | Modrinth
• License: MIT License (Copyright © 2022 KosmX)

The original author is no longer maintaining PlayerAnimator and recommends using PAL instead.

---

What is PlayerAnimator?

PlayerAnimator is a Minecraft library to animate the player while trying to break as few mods as possible.

This port adapts the library to work with Minecraft 1.21.10 (Fabric).

Features

✅ Working

• Complete animation system for player model
• Position, rotation, scale, and bend transformations
• Animation layers with priority system
• JSON animation support (GeckoLib & Emotecraft formats)
• First-person animation mode
• Item in hand animations
• Proper elytra positioning during animations

⚠️ Limitations

• No bendy-lib - Smooth body bending not available (no 1.21.10 version)
  • Animations look less smooth
  • Body parts don't bend in the middle
• Armor visibility - First-person armor visibility may not work correctly

For Players

Just install this mod as a library - it does nothing on its own. Other mods that use PlayerAnimator will enable their animations when this is installed.

For Developers

The API is fully compatible with original PlayerAnimator:

// Get player's animation stack
AnimationStack stack = PlayerAnimationAccess.getPlayerAnimLayer(player);

// Add animation layer
stack.addAnimLayer(new ModifierLayer<>(animation));

// Load animation from JSON
AnimationContainer animation = PlayerAnimationRegistry.getAnimation(
    new Identifier("modid", "animation_name")
);

Gradle Setup

 repositories {
      maven { url 'https://jitpack.io' }
  }

  dependencies {
      modImplementation "com.github.TOSTcRa:playerAnimator-1.21.10:v2.0.1-1.21.10-unofficial"
      include "com.github.TOSTcRa:playerAnimator-1.21.10:v2.0.1-1.21.10-unofficial"
  }

Model Structure

Animations use these body parts:

• head / body (whole player) / torso (chest)
• rightArm / leftArm / rightLeg / leftLeg

Place animations in: assets/modid/player_animation/

Links

• Original GitHub
• Recommended Alternative: PAL
• Port Technical Details

Credits

• KosmX - Original PlayerAnimator creator
• Fabric team for excellent modding tools
• All contributors to the original project