Importing Resources

by Jon (Updated on 2014-01-27)


  • Introduction
  • The Three 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.


The Three Methods

In general, you can import resources through three methods.

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


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 Backgrounds to learn how to import them.


Importing Behaviors

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

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

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

For pre-shipped behaviors, we've got an article on them.

For StencylForge, skip to the next section.



StencylForge is our marketplace for user-created (and team-created) resources. StencylForge hosts all of the following kinds of resources.

  • Graphics
  • Sound Effects
  • Music
  • Behaviors
  • Example Games
  • Kits

Read our article on StencylForge to learn how to access it and contribute to it.

Disclaimer: All articles are geared towards Stencyl 3.0 and above. 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!


The Lord
how can i make my own tilesets?

0 6 months, 2 weeks ago
I need to put a game on MY games

0 8 months, 3 weeks 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 1 year, 2 weeks 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 1 year, 8 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 2 years, 7 months ago

Sign In to Comment