What the mod does
Zigy's Player Animator API provides a simple way for mods to start player animations from the server. When a server requests an animation, the mod packages the request into a packet and sends it to the client, which then plays the animation. The same API can also be called directly on the client side.
Who should use it
If you're building a mod that needs to show custom player motions - such as emotes, combat moves, or scripted events - this library gives you a reliable hook. Look, it works for any mod that runs on the supported loaders and Minecraft versions, so you can integrate it into both small utility mods and larger gameplay packs.
Main capabilities
- Play any registered player animation from server code.
- Trigger the same animation locally on the client without extra code.
- Execute animations via a built-in server command, useful for testing or admin control.
- Automatic packet handling means you don't have to write networking code yourself.
Compatibility
The library requires both client and server components to be present. It's released under the MIT License and is available for Neoforge, Fabric, and Forge loaders. Officially supported Minecraft versions are 1.21, 1.20.4, and 1.20.1. No other versions or loaders are guaranteed to work.
Getting started
The project’s GitHub wiki lists all available functions and shows example code for registering and playing animations. You can download the mod from Modrinth or CurseForge and add it to your mod folder like any other library.
Limitations
Because the mod only sends animation packets, it can't create new animation data itself. You need another mod or resource pack that defines the actual animation files. The library also doesn't run on client-only setups; both sides must have the mod installed.
