Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
39 lines (29 sloc) 2.03 KB

Discontinued! For a reworked version with lots of improvements by Degranon, see:


LuAnimator is a tech mod that allows you to use custom character animations. Any images under a set size limit will work, and will be multiplayer-compatible. Animations are made through an application, which is also included in this repository.

Table of Contents


  • Crop game assets into separate frames.
  • Create custom animations from frames.
  • Animations can be set for the following actions: standing still, walking, crouching (sleep), swimming, jumping and falling.
  • Toggle custom animations on and off in-game using a tech.
  • Sit on players and other entities, following them around automatically.


The Wiki covers about everything you need to know and do to use the LuAnimator.


No additional features planned yet. Feel free to suggest them [on the discussion page]!

Potential Issues

  • Any other calls to the tech.setParentDirectives(directives) will overwrite the changes made by the LuAnimator tech. This can be worked around by removing the function calls that aren't found inside /scripts/luanimator.lua, but this may not be what you want.
  • Using a low interval and high frame dimensions can easily cause performance issues for you, other players or the server you're playing on.
  • To avoid Chucklefish patching the LuAnimator out, please try to keep frames as small as they need to be. If players around you are experiencing performance issues because of the animations, please stop using the LuAnimator around them or switch to smaller animations or longer intervals.


If you have any suggestions or feedback that might help improve this mod, please do post them [on the discussion page]! You can also create pull requests and contribute directly to the mod!