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







Introduction to Behaviors

by Jon (Updated on 2013-01-29)

As a game creator, it’s not enough to add a bunch of resources to a Scene and call it a day; you have to define gameplay that will engage your players and make your game interactive.

To do this, you’ll use Stencyl’s Behavior Designer to build self-contained snippets of logic called Behaviors and attach them to your Actor Types and Scenes.

Note: In response to our readers, we would like to clarify that there is no associated demo/source with this article. Our apologies for the confusion!



  • What are Behaviors?
  • Attaching a Behavior
  • Configuring a Behavior
  • Actor Type vs. Scene Behaviors
  • Peeking under the Hood
  • What are Events?


What are Behaviors?

Behaviors are reusable, configurable “abilities” that you attach to Actor Types or Scenes. Together, they make up the “brains” of a game, handling all interactions that occur in the world.

Say we’re making a vertical shoot 'em up where the player controls a ship that can fire lasers.

Let’s attach a Behavior that will allow the player to fire a laser when the spacebar button is pressed.


Attaching a Behavior

To attach a Behavior, perform the following steps:

  1. Open the desired Actor Type (or Scene).
  2. Click the Behaviors tab.
  3. Click the Add Behavior button.
  4. Find and select the desired Behavior.
  5. Click Choose.


Configuring a Behavior

Behaviors can be reused and configured individually for different Actor Types or Scenes. For example, if you attach a Walking behavior to an Actor Type, you'd like to be able to configure its walking speed.

The customization occurs on the Behaviors tab, by modifying parameters called Attributes.

Let’s configure the Fire Laser Behavior for our ship Actor. First, select the Behavior you want to customize, and then fill in values for each field that’s displayed.

In this ship example, we...

  • Pick a sound effect
  • Pick a “bullet” Actor Type
  • Set the initial directions
  • Set an initial speed of 800 for the laser

Now that the Fire Laser Behavior has now been attached and configured, let's see this in action.


The Demo Game

(Press spacebar to fire the laser)


Actor Type vs. Scene Behaviors

The Behavior we created was an Actor Type Behavior and thus is available to be attached to any Actor Type (e.g., the ship).

We also have the ability to create Scene Behaviors that can get attached to any Scene. An example of this would be a "spawn" Behavior that periodically creates new enemies at the top of the screen.


Peeking under the Hood

Let’s take a look at a typical Behavior.

On the left you see a list of Events that can happen, and on the right, you see the response to the currently selected event. You can click on other events to display their associated responses.

We'll talk much more about what's happening on the right side later in this chapter.


What are Events?

Events are the building blocks of Behaviors. In short, they’re things that happen in your game that can trigger some kind of action, or response.

Returning to our vertical shoot ‘em up example, remember that when the player presses the spacebar, the player’s ship fires a laser.

In this case, hitting the spacebar is the event, and firing the laser is the response. The event and response are related by cause and effect.



  • Behaviors are reusable, configurable “abilities” that you attach to Actor Types or Scenes.
  • The same Behavior can be customized for multiple Actor Types or Scenes by setting Attributes.
  • Behaviors are composed of Events, which are things that happen in your game.
  • Each Event has an associated response, which determines what actions are carried out when the Event occurs.
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!


Couldn't find it either but its not too necessary.
0 11 years, 10 months ago
Hi, where is the source file?
0 11 years, 10 months ago

Sign In to Comment