Skip to content

v1.2 - Animated head sprites

Choose a tag to compare

@CaptainParis CaptainParis released this 17 Aug 02:23
· 2 commits to main since this release
4843440

What's new

  • Animated head sprites. A new animation type sits alongside static sprites and sequences. An animation is an ordered list of frames (each frame is a row of one or more heads) played on a loop at a configurable interval. Animations are stored in sprites.yml and authored in the built-in web editor.
  • Chat & MiniMessage tag: use <anim:name> to insert a live, looping animation inline. The <sprite:name> tag also falls back to an animation's first frame when the name matches an animation.
  • PlaceholderAPI: new %headsprites_anim_name% placeholder returns the current animation frame as a JSON text component for Skript/custom chat formats.
  • Commands: /sprite anim list, /sprite anim display <name> (spawns a looping animated TextDisplay in-world), and /sprite anim stop (removes running displays), all with tab completion.
  • Web API: new /api/animation and /api/animation/delete endpoints; animations are included in the editor state.

Install

Drop HeadSprites-1.2.jar into your server's plugins/ folder. Requires Paper 1.21.x and Java 21. PlaceholderAPI is optional (needed only for the Skript/placeholder bridge).