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







Importing Resources

by Jon (Updated on 2015-10-12)


  • Introduction
  • The Two Methods
  • Importing Animations
  • Importing Tilesets
  • Importing Backgrounds
  • Importing Sounds
  • Importing Behaviors


Importing resources is a key part of the Stencyl workflow. This article talks about the various ways of pulling in graphics, sounds and other resources into your game.

The Two Methods

In general, you can import resources through one of the following methods.

  1. Picking a file from the file system
  2. Drag and Drop from the file explorer

The remainder of this article links to articles that talk specifically about how you import each resource type.

Importing Animations

Animations are visual states for Actors.

Read our article on Animations to learn how to import them.

Importing Tilesets

Tilesets are collections of Tiles, the building blocks for scenes/levels.

Read our article on Tilesets & Tiles to learn how to import them.

Importing Backgrounds

Backgrounds are large images that usually scroll alongside a scene, either entirely behind or in front of a scene.

Read our article on Backgrounds to learn how to import them.

Importing Sounds

Sounds represent clips of sound effects or entire music tracks.

Read our article on Sounds to learn how to import them.

Importing Behaviors

Besides creating new behaviors on your own, Behaviors can come in from two sources.

  1. Local File System
  2. From our pre-shipped collection

To import Behaviors from your computer, click Import... in the top toolbar and pick out the Behavior. Behaviors are PNG files embedded with metadata.

To import a pre-shipped behaviors, read this article.

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!


Hello i need quickly your help. I make a game, and save from pen drive and hotmail drive. I open the stencyl application and i go to the import games, choose my game, and is loading, when stops loading, nothing happends, and the game dont appear. So i go to the games folder and appears the game.
Sorry for saying that but i bet 100% that could be a stupid error.

1 8 years, 4 months ago
The Lord
how can i make my own tilesets?

0 9 years, 4 months ago
I need to put a game on MY games

1 9 years, 6 months ago
Should the link below "Sounds represent clips of sound effects or entire music tracks." be "Read our article on SOUNDS to learn how to import them."?

0 9 years, 10 months ago
Frequently suggested but not available yet because there are lot of corner cases to think about. For example, if you cross games, what do you do about actors and the behaviors? Do you import the behaviors too? It's a messy design problem.

My sense is that the real question is people wanting to work in teams, working on the same base game and sharing levels between each other. If that's the case, then we have a more targeted and manageable solution for that down the road.

0 10 years, 5 months ago
Is there an easy way to import entire scenes and/or games INTO another game? If not... That would be a wonderful enhancement imo.
0 11 years, 5 months ago

Sign In to Comment