As of late 2021, we are in the process of updating Stencylpedia and fixing up outdated & broken content. Thanks for your patience!








by Jon (Updated on 2015-10-20)


  • What are Animations?
  • How To: Importing Animations
  • Frames
  • Collision Data
  • Switching Animations
  • Controlling Playback
  • Design Problem - More Animations vs. More Actor Types
  • Gotchas

What are Animations?

Animations bring actors to life. They represent the visuals of an actor, its collision bounds and the notion of being in a certain "state" - such as running, walking and jumping.

What are examples of animation states?

  • A platformer hero's states (Stand, Walk, Run, Jump)
  • Destructible Objects that "break" when hit by something else (Broken, Not Broken) treasure-chest-animation
  • Treaure Chest (Opened, Not Opened)

What does an Animation Consist of?

Each Animation state consists of 2 separate parts:

  • Frames (how it looks)
  • Collision Bounds (its collision shape)

Frames are like pages in a flipbook. Each frame represents a a different image or "page" in the book. When these images change quickly over a period of time, the result is an animation.


Collision Bounds determine the physical shape(s) that an an actor assumes in a particular Animation state.

How To: Importing Animations

Now that you understand what animations are, let's go over the import process. You can import animations in one of several ways.

  • Pick an image.
  • Drag and Drop.

Method 1: Pick an Image

In this instance, we're assuming you've already got an Actor open in the Actor Editor.

  1. Click on Click here to add frame under the Frames pane.


  2. You'll now see this dialog. Click the Choose an Image... button and pick out the desired image. Want to follow this exact example? Use this image.


  3. Now, configure columns and rows to break up the image, as appropriate depending on how many cells it has in those directions.


  4. If applicable, enter in values for the border and spacing fields. The majority of images do not need to worry about these fields.

  5. Click Add to complete the process. That's it.

After importing frames, you can give the Animation a name, alter frame durations and other properties we described above.

Note: Mobile games have to import images at quadruple their size in order to accomodate larger resolution displays. Read our Scaling article for details.

Method 2: Drag and Drop

You can drag and drop an image into Stencyl while the Actor Editor is open. Doing this will bring up the dialog you see in Step (2) of the standard method.


  • Dragging in an animated GIF will bypass the dialog and immediately import the frames.
  • Dragging in an image to the Dashboard or an editor that is not the Actor Editor will have varying effects, none which will import a new animation for the current Actor.

Working with Animations

Now that you've imported an image, you'll see its details, We'll step through what each part means.



Each animation state is given a name, which you use when you want to switch animations.


Frames can be set to loop or play through just once.


Synchronized animations will animate in at the same time as each other. To put this more concretely, think about the coins in a Mario game. Have you noticed that their animations always look the same no matter what? If this weren't the case, it would look disconcerting.

Origin Point

An Animation can also have a designated origin point. The origin point is used to determine the point by which an actor rotates or scales. By default, this is set to the center point.


Frame Duration

Every frame can be given a different duration (in milliseconds). Double-click each frame's box to edit the duration.


Notes: The minimum duration is 10ms. To edit multiple frame durations at a time, select multiple frames (using SHIFT or CTRL/Command) and click Edit Frame in the bar below.

Editing in an External Editor

Individual animation frames can be edited in an external editor. This is useful for making small tweaks to the graphics, without having to re-import the whole animation.

Double-click a frame's box to bring up its edit dialog. Then, click the Edit Image button to open it up an external editor.

Note: You set the External Editor from Stencyl's Preferences dialog. By default, we use an image editor that we bundle in, but you can set it to any app you like, such as Photoshop, GIMP or Paint.NET.

Collision Bounds

Collision Bounds determine the physical shape(s) that an an actor assumes in a particular Animation state.

To define Collision Bounds, flip to the "Collisions" page of the Actor Editor. There, you will be able to edit your Animation's Collision Bounds on a per-animation basis.


We cover how to define Collision Bounds in our Collisions article.

Switching Animations

All of these blocks are found under Actor > Drawing.

Switch Animation

This block switches the actor's animation to the one you specify.


Note: Do not type in the animation name directly. Instead, use the "as animation" block and type the name into that.

What's the current Animation?

This block returns the animation that is currently playing. Note that this returns the animation, not the textual name of the animation.


Is the current Animation still playing?

Returns true if the current animation is still playing, otherwise it returns false. This is only useful for animations that aren't set to loop.


Controlling Playback

Switch to Frame

This block lets you skip around an animation or reset an animation to its starting frame. Specify the frame index you wish to jump to.


Note: Frame indices are displayed in the gray boxes and start from 0. Switching to an invalid frame leads to nothing happening.

Current Frame Index

This block reports the index that the animation is currently playing.


Tip: This is useful when you want to tie some logic that's triggered when a certain index is reached. In animation terms, this is called a keyframe.

Total Frame Count

This block reports the total number of frames in the current animation.


Design Problem: More Animations or More Actors?

There is no limit to the number of animations an actor may have. However, it's best to consider when it's appropriate to go with more animations or whether it's better to create a brand new actor.

The "Zelda" Dilemma

The "Zelda" Dilemma is a classic game design problem you run into when making an Adventure game and decide how you want to create your Hero character.

So suppose that we start with just the basic animations.

  • Walk
    • Left
    • Right
    • Up
    • Down

Not to bad so far. But Link holds a sword! So we have to add 2 more sets of animations, one for holding the sword and one for slashing it.

  • Walk
    • Left
    • Right
    • Up
    • Down
  • Walk + Sword
    • Left
    • Right
    • Up
    • Down
  • Walk + Slashing Sword
    • Left
    • Right
    • Up
    • Down

But wait, there's more! Link changes swords throughought the game. He can hold the plain sword, the Master Sword and the Golden Sword, and they all look different! That would triple the animation count.


And what about the Bow and Arrow, holding a shield and... you get the picture.

The Bottom Line

In cases like these, it's better to create a new actor rather than add more animations. This is particularly applicable when an actor equips items that don't alter his animation and could be convincingly drawn separately.


There are other benefits to having "attachments" as different actors.

  • Easier to define collision bounds, particularly for weapons.
  • Confines extra behaviors to the separate actor, rather than creating 1 monolithic actor with everything.


It's best if all animations are the same size.

It's often necesary to ensure that all animations of an actor are equal in size. Making animations different sizes, for the same actor, could have a negative impact, especially if the origin point is different in each animation.

Two common scenarios are:

  • The actor magically jumps to a slightly off-center location when you switch animations.
  • The actor's collisions mess up because the new animation has the collision bounds located in a different part of the animation.

Animations, Blocks & Attributes

Note that when using the "switch animation" block, you cannot type text directly into the blank. Instead, you have to wrap that text inside an "as animation" block like the following.


Reminder: All animation-related blocks are located under Actor > Draw.

Actors with No Animations

Actors with no animations at all may crash the game. We'll address this in a future version of Stencyl. Note that this is different from an Actor with a single blank (0 frame) animation, which will work just fine.


  • Animations are states, such as standing, walking and running.
  • Animations consist of frames (how it looks) and collision bounds.
  • Exercise good judgement in deciding whether to go with an actor with many animations versus several actors with fewer animations.

Challenge: Equipment for an Adventure Game

We talked about the "Zelda Dilemma" above. Now's your chance to see this for yourself and do things the right way.

Create a simple walkaround demo in which the character can equip different items that show up in that character. Do this the right way, by making those items each their own actors.


Print Article Edit Article How to Edit an Article
Disclaimer: Use comments to provide feedback and point out issues with the article (typo, wrong info, etc.). If you're seeking help for your game, please ask a question on the forums. Thanks!


I want to change from walking animation to hitting or slashing animation

0 3 years, 8 months ago
Can't find the block [ as animation ] in v4.0.2.
0 3 years, 11 months ago
Chris24XD 2
If you don't find [ as animation ] block, just write it's animation (correctly) instead.
- It works

1 4 years, 3 months ago
I can't seem to find the "as animation" block in the Actors > Draw section.
2 5 years, 5 months ago
I added animation but I cant make it bigger any idea? My animation is 160x32

0 6 years, 7 months ago
Is there (plans for) support for the file types created specifically by animation software? I'm asking as a user of Graphics Gale Free Edition, which uses .gal. In a nut shell, here is the official website, which contains a feature overview: wnload.html.
I'm sorry if this inquiry has been previously answered--please redirect me if so.

0 8 years, 5 months ago
Stencyl Ninja's comments are on the mark.

The point of these embedded challenges and design discussions is to get you to think about common problems you may encounter. Some of these, I've seen with my own eyes when projects came my way (as part of bug reports).

Rather than telling you the answer straight away, we go through the thought process, so that you develop your thinking skills and can tackle new problems for which Stencylpedia has no answer.

If the challenge's solution is obvious, that's great. You can gloss over it. But for many, it isn't.

0 8 years, 9 months ago
I could simply use some pointers on learning how to actually draw and animate our own material, as in what software I should use, etc. That would really help me out.
0 9 years, 6 days ago
kade 101
think you that fixed my problen :)
0 9 years, 1 month ago
There is a typo in the "note" box in the drag and drop. The typo is noting when it is supposed to be nothing.
-1 9 years, 4 months ago

Sign In to Comment