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








by Justin (Updated on 2018-11-29)


  • What are Regions?
  • Example: Entering a Door
  • Creating Regions
  • Detecting Entry/Exit
  • Region Types
  • Moving Regions
  • Resizing Regions

What are Regions?

Regions are invisible areas of a Scene that detect the entry and exit of Actors. In other words, we use regions when we want to know when certain actors reach certain parts of a scene.

In what situations would regions be useful?

  • Entering doors, pipes and other transportation devices
  • Entering an area that continually heals the player (Healing Zone)
  • Entering an area that continually harms the player (Lava Zone)
  • Stepping on a switch

Example: Entering a Door

Suppose that you are making an adventure game.

Your hero is walking outside, and he comes across a door to a house. You want to program your game so that when your hero walks to the door, he ends up inside the house.

How would you do this?

We want the game to detect that the hero walked on top of the door. When this happens, we want to transition to the house scene.

Regions do exactly what we want. Here's how we'd do this (going with our example scenario).

  1. Inside the Scene Designer, place a Region.

  2. Flip to the scene's Events page. Add a Specific Actor Enters Region event.

  3. Fill out the event with the desired values. In our case, we want to detect when our Hero enters the Door region.

  4. Finally, we add in the scene switch block (under Scene > Game Flow) to change the scene.

That's it! Here's a demo of the game in action. We've drawn the region for you, so you can see exactly where it is.

Creating Regions

Regions can be created in one of two ways.

Method 1: Place Directly

You can place a Region directly into a Scene, as we did in the demo above.

Method 2: Create on the fly

You can create a region on the fly from a Behavior or Event using a block. The block is under Scene > Regions.

If you'd like to refer to this newly created region, use the Last Created Region entry anytime you're asked to Choose Region.

Detecting Actors entering, exiting or being inside Regions

Once you place a Region, you can detect when an Actor enters or exits the Region using an Event.

Alternatively, you can detect if an actor is currently inside a given region.

What's the difference?

  • Event = I entered the house.
  • Is Inside = Are you currently inside your house?

Troubleshooting Tip: Be sure that collisions are enabled for the actor. Regions rely on the collision system to work.

Region Types

Regions come in 3 flavors: Box, Circle and Polygon.

Use the shape that best suits your game. For most games, box regions suffice.

Tip: Hold down SHIFT while placing a box region to force it to become a square.

Moving Regions

You can move regions around to a specific (x,y) coordinate or have a region "follow" an actor, which will reposition the region around the actor's center point.

In both cases, the operation happens instantly. If you wish to have a region continually follow an actor, you must continually move the region using either of these two blocks.

The difference is that the "follow" block centers the region on the target Actor's center point.

Example: Fiery Barrier

Suppose that in an adventure game, one of the hero's special moves is a fiery barrier in which all enemies approaching him within a 100 pixel radius automatically get killed.

(Play the Demo)

This could be implemented by creating a box region and having that region continually follow the Hero. When actors from the Enemy group enter this region, they get killed.

Resizing Regions

You can change the size of a Box or Circular region on the fly. Resizing uses the top-left corner as the origin.

Because boxes and circles are defined differently, you have to use the corresponding block depending on what kind of region you're working with.

If you need to reset a region's size back to its original, use the reset size of [ Region ] block. This block works on both box and circle regions.


  • Regions tell us when actors have reached certain parts of a scene.
  • You can detect when an actor enters, exits or is currently inside a region.
  • You can create regions either by placing them in the scene or creating them from a behavior.
  • You can move and resize regions.

Challenge: Pipes!

One of the signature moves in a Mario game is the ability to enter pipes. Implement this classic mechanic, using Regions.

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'm trying to capture all actors inside a defined region, but the results are not what I expected. I have a square region that can hold multiple actors that I want to loop through using the 'for each [actor inside region]' block. How does it calculate 'inside'? Is it the entire collision/sensor shape of the actor or the origin point? Some actors way outside the Region box are being caught in this loop, and others (mainly lower-right) are not being captured at all. To help picture the interaction, I'm basically doing something like emptying all items in a trash can.
0 3 years, 1 week ago
Is there a way to resize the region once it is placed in the scene? I can't get the corners or sides to resize....
0 7 years, 6 months ago
kade 101
thinks that helps a lot. :)
0 8 years, 10 months ago
Hello Everyone,

Just to make things clearer, you not only have to have collisions enabled but also the physics mode must be in Box2D. To make sure this is the case go to Settings > Advanced. Box2D is the default, so you should be good from the beginning.

0 8 years, 10 months ago
When player enters region.. kill player
0 9 years, 1 month ago
is there a way my character can die when stepping on a region?


1 9 years, 6 months ago
big thank you you helped me hugely
0 9 years, 7 months ago
I am probably missing something but when I test my game, the regions are visible as outlines.
0 10 years, 3 weeks ago
Chupup Games
Where is 'Choose Region' in Stencyl 3.0? I only can set 'Last created Region' or 'Chose Attribute'
0 10 years, 1 month ago
Correct - Regions are built around the physics system and require collisions to be on to work.
2 10 years, 3 months ago

Sign In to Comment