Custom Player Animations

Base Resourcepack

---

📖 Description

Give your Minecraft character the movements they deserve!
"Custom Player Animations" is a comprehensive animation overhaul mod that replaces and enhances vanilla player animations with smooth, natural movements. Using the Player Animation Library API|Player Animator, this mod breathes new life into how your character moves, from simple walking to complex actions like climbing and swimming.

The best part? Every animation is customizable through resource packs and an intuitive config screen, allowing you to tailor the experience to your exact preferences or create entirely new animation sets.

---

🌟 Features

🎬 Over 50 Enhanced Animations

The mod completely overhauls vanilla player animations across three categories:

Category	Animations Included
🟢 Main Animations	Idle (standing/sneaking), walking (forward/backward/sneaking), running, turning (left/right/sneaking), creative flying, falling, climbing (forward/backward/sneaking/idle), crawling (forward/backward/idle), swimming (idle/forward/backward/up/down), mounting (minecart/horse/boat), elytra gliding, sleeping, death
🟡 Overlay Animations	Eating, trident throwing, bow drawing, shield blocking, crossbow charging/holding, tool swings (sword combos, pickaxe, axe, shovel)
🔴 Special Animations	Up-hand gestures, item swapping

All animations are designed to feel smooth and natural while maintaining Minecraft's core gameplay feel.

---

🎨 Full Resource Pack Support

Take complete control of your animations:

• ✅ All animations stored as JSON files in assets/cpa/player_animations
• ✅ Override any animation simply by adding your own files to a resource pack
• ✅ Blockbench integration — .bbmodel files included for easy editing and creation
• ✅ Hot-reload support — see your changes instantly with resource pack reload

Want a steampunk animation set? Medieval movements? Sci-fi actions? Just create or download a resource pack and you're set!

---

⚙️ Extensive Configuration

Fine-tune every aspect through the in-game config screen:

Category	Configurable Options
General	Animation speed multiplier, fade time multiplier, up-hand disable lists
Main Animations	Enable/disable, speed, fade time, and priority for each animation
Overlay Animations	Individual configs for eating, bows, shields, crossbows, and all tool types
Special Animations	Up-hand gestures and item swap settings

Perfect for adjusting animation speeds to match custom resource packs or personal preferences.

---

👨‍💻 Developer API

Fellow modders can easily integrate with CPA:

• Simple, documented API for animation control
• Hooks for custom animations and body part management
• Support for mod compatibility patches

(Full documentation coming soon — check the source code or reach out for help!)

---

⚙️ Compatibility

• Minecraft Versions:

  • 1.20 to 26+

• Modding Platforms:

  • Fabric: ✅ Fully supported!
  • NeoForge: ✅ Fully supported!
  • Forge: ✅ Fully supported!

• Required Dependencies:

  • Player Animation Library | Player Animator
  • Cloth Config API

• Mod Compatibility:

  • Works with most animation-friendly mods
  • Client-side only — no server installation required!

---

📦 Installation

1. Install the modding platform: Fabric, Forge, or NeoForge for your Minecraft version
2. Install dependencies:
   • Player Animation Library | Player Animator
   • Cloth Config API
3. Download CPA: Grab the latest version from CurseForge or Modrinth
4. Add to mods folder: Place the .jar file in your mods folder
5. Launch and configure: Start Minecraft and customize animations via the config screen!

(Optional) Add resource packs to resourcepacks folder to override default animations.

---

💡 Why Use This Mod?

Vanilla Minecraft animations have remained largely unchanged for years. While functional, they lack the fluidity and personality that modern players expect. Custom Player Animations fixes this by:

• Making movements feel more natural and weighty
• Adding variety with sneaking variants, combo attacks, and contextual animations
• Allowing complete customization so you can create the exact look and feel you want
• Supporting resource pack creators with an easy-to-use animation format

Whether you're a player wanting smoother animations or a content creator building a themed pack, CPA gives you the tools to make it happen.

---

🛠️ Contributing & Feedback

Contributions, ideas, and bug reports are always welcome!

• Found a bug? Report it on GitHub
• Have a feature request? Open an issue or suggest it in the comments
• Want to contribute? Fork the repo and submit a pull request
• Created a resource pack? Share it with the community!

---

❤️ Acknowledgments

"Custom Player Animations" was created by RazorPlay01 to bring modern, customizable animations to Minecraft. Huge thanks to:

• The Player Animation Library team for providing the foundation
• The Minecraft modding community for continued support and feedback
• You, for downloading and using the mod!

If you enjoy CPA, please consider leaving a review or starring the project on GitHub — it really helps!

---

🌐 CurseForge • Modrinth • GitHub

---

"Finally, my character walks like they've actually been adventuring, not just slideshowing across the world!" 🎮