# Animation docs

**URL:** <https://forum.makecode.com/t/animation-docs/1652>\
**Category:** Help\
**Created:** [April 9, 2020, 9:56pm UTC](https://forum.makecode.com/t/animation-docs/1652 "2020-04-09T21:56:32Z")\
**Posts on this page:** 9\
**Page:** 1

<div class="post-metadata">

**Author:** ![joshmarinacci](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/joshmarinacci/32/768_2.png) [@joshmarinacci](https://forum.makecode.com/u/joshmarinacci)\
**Post date:** [April 9, 2020, 9:56pm UTC](https://forum.makecode.com/t/animation-docs/1652/1 "2020-04-09T21:56:32Z")

</div>

Are there docs for the new animation API? I can find tutorials and docs for the older api, called “legacy”, but not the new (current?) api. I’d prefer to use the new api since it provides the animated sprite editor.

In particular I want to change animation loops when my character changes direction or moves, similar to the classic Adafruit example.

Thanks.

---

<div class="post-metadata">

**Author:** ![jwunderl](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/jwunderl/32/5308_2.png) [@jwunderl](https://forum.makecode.com/u/jwunderl)\
**Post date:** [April 9, 2020, 10:41pm UTC](https://forum.makecode.com/t/animation-docs/1652/2 "2020-04-09T22:41:13Z")

</div>

Yes, if you right click on the block and click “help” it will open up a reference page in the side docs. (Ideally we have those for all blocks, but sometimes a few slip through as it’s a manual process.

 ![opening side docs](https://us1.discourse-cdn.com/flex020/uploads/makecode/original/1X/6f511bc85e3d92b3e5da1e9bfd1b9524d1cea641.gif) )

I will note though that I have personally had better luck using the legacy apis when switching between animation states like that (walking left to walking right, etc), as the kind helps keep state within the animations themselves; that may be because I’ve used those ones more though, and can be accomplished with an extra variable keeping track either way.

---

<div class="post-metadata">

**Author:** ![joshmarinacci](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/joshmarinacci/32/768_2.png) [@joshmarinacci](https://forum.makecode.com/u/joshmarinacci)\
**Post date:** [April 9, 2020, 11:04pm UTC](https://forum.makecode.com/t/animation-docs/1652/3 "2020-04-09T23:04:12Z")

</div>

thanks. Yeah, I don’t see anything equivalent to `activate animation` from the legacy APIs. Too bad I can’t use the sprite anim editor w/ the old apis. Are the new ones still under active development?

---

<div class="post-metadata">

**Author:** ![jwunderl](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/jwunderl/32/5308_2.png) [@jwunderl](https://forum.makecode.com/u/jwunderl)\
**Post date:** [April 9, 2020, 11:15pm UTC](https://forum.makecode.com/t/animation-docs/1652/4 "2020-04-09T23:15:40Z")

</div>

I personally think there could be a coat of paint on them, ideally w/ the two being made interoperable (e.g. letting the create animation block take an optional parameter of the frames, so the first block is the simple case / for one off animations and the others are for when you want more detailed control).

I’m not sure I would say active development, but making apis more usable in general is being thought about for sure / if you have a particular ideal set of APIs / specific blocks you need for the animation category I’d love to see them

---

<div class="post-metadata">

**Author:** ![joshmarinacci](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/joshmarinacci/32/768_2.png) [@joshmarinacci](https://forum.makecode.com/u/joshmarinacci)\
**Post date:** [April 14, 2020, 7:28pm UTC](https://forum.makecode.com/t/animation-docs/1652/5 "2020-04-14T19:28:24Z")

</div>

I’d like to see a way to pause an animation and to switch between animation sets. It will be common to do things like

- animate the player moving left, then switch to right or up or down
- switch animations when jumping
- make a slow animation like a lamp that only flickers every few seconds
- make a tileset with animated tiles, like a fireplace.

---

<div class="post-metadata">

**Author:** ![GameGod](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/gamegod/32/2756_2.png) [@GameGod](https://forum.makecode.com/u/GameGod)\
**Post date:** [June 30, 2020, 6:45pm UTC](https://forum.makecode.com/t/animation-docs/1652/6 "2020-06-30T18:45:03Z")

</div>

There is a stop animation block

---

<div class="post-metadata">

**Author:** ![shakao](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/shakao/32/113_2.png) [@shakao](https://forum.makecode.com/u/shakao)\
**Post date:** [June 30, 2020, 10:54pm UTC](https://forum.makecode.com/t/animation-docs/1652/7 "2020-06-30T22:54:25Z")

</div>

In case folks are looking, recently @riknoll has also been working on an extension to make character animations easier that you can find here [https://github.com/riknoll/character-animations](https://github.com/riknoll/character-animations)!

---

<div class="post-metadata">

**Author:** ![GameGod](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/gamegod/32/2756_2.png) [@GameGod](https://forum.makecode.com/u/GameGod)\
**Post date:** [September 16, 2020, 12:49am UTC](https://forum.makecode.com/t/animation-docs/1652/8 "2020-09-16T00:49:56Z")

</div>

> **[The best game](https://arcade.makecode.com/75352-21699-90311-41293)**
>
> Made with ❤️ in Microsoft MakeCode Arcade.

---

<div class="post-metadata">

**Author:** ![GameGod](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/gamegod/32/2756_2.png) [@GameGod](https://forum.makecode.com/u/GameGod)\
**Post date:** [September 16, 2020, 12:51am UTC](https://forum.makecode.com/t/animation-docs/1652/9 "2020-09-16T00:51:15Z")

</div>

[![](https://media1.tenor.com/images/57037bfeee2c76ff11b9885507844d9a/tenor.gif?itemid=17171068) ](https://media1.tenor.com/images/57037bfeee2c76ff11b9885507844d9a/tenor.gif?itemid=17171068)
