Playing Sounds & Music

by Jon (Updated on 2015-10-18)

Sound is a fundamental aspect of almost any game. This section covers the basics of importing music, playing it back and some interesting tidbits that may not be obvious.


  • Importing Sounds
  • Example: Background Music
  • Accepted Formats
  • Music vs. Sound Effects
  • Playing Sounds and Music
  • Channels
  • Known Issues
  • Challenge: Zelda-Style Battle Music
  • Challenge: Smooth Looping

How to: Importing Sounds & Music

  1. Import the clip into the Sound Editor by going to File > Create New > Sound.

  2. Give it a name.

  3. Click the following box to pick and import.

Import Sound

Tip: Alternatively, you can just drag and drop the sound in.

Example: Looping Background Music

Looping "background" music takes just 1 block to do.

Make a Scene Behavior out of this, or stick this directly into the "Events" for a scene.

Loop Music

Exercise: There's a flaw in this approach. Think about what happens when you re-enter this scene... That isn't desirable, is it?

Later in this article, we'll cover all the playback blocks available to you.

Accepted Formats

Stencyl accepts MP3s and OGGs as follows.

Platform Accepted Format
Flash MP3
Windows OGG
Linux OGG
Android OGG

In short, we use OGG for every platform except for Flash. If you're publishing your game to Flash and any of the other platforms, you'll need to import the sound in both formats. (We recommend Audacity for exporting music. It’s free.)

MP3 Troubleshooting

If your game unexpectedly does not export your game to Flash, it’s likely that sounds are the culprit. Ensure that your MP3's meet the following specifications.

  • 44.1 KHz (versus 22 or 11)
  • 16-bit
  • Constant bitrate (versus VBR)
  • No metadata

If you continue to experience issues with MP3s, post your issue to the forums and generate logs.

MP3's and Licensing

For Flash games, licensing is handled by Adobe (the creator of Flash), and as a game developer, you do not have to worry about licensing for your Flash game, even if it makes money.

For desktop and mobile games, we only work with OGG sounds, so the use of MP3's is irrelevant.

Music vs. Sound Effects

Stencyl supports two kinds of sounds: music and sound effects.

Music is streamed (like viewing a YouTube video) since it’s too large to fit into memory. This is best for background music. This incurs a small performance penalty on mobile devices.

Sound Effects are loaded into memory to reduce latency in playback. This is better for short clips that need to be played immediately but consumes memory, particularly on mobile devices.

How to Play Sounds & Music

All sound-related blocks are conveniently located under the Sound category.

Play = Plays to the end once, then stops
Loop = Plays to the end and then repeats

Volume ranges between 0% and 100%, inclusive.

Note: If you’d like to pause and resume a sound, skip down to the Channels section.

A Common Mistake: Looping Music

Looping music does not stop upon switching scenes. A common mistake, however, is to attach a “Background Music” behavior to every scene, causing the music to restart each time you enter a new “room” or "stack up."

How would you solve this? One approach is to create a blank scene prior to the first level which loops the music. Since this scene is not encountered again, the loop behavior runs just once.


Suppose that you’re playing Zelda. The regular tune plays, but when you approach an enemy, and the music switches over to the battle music. Once you defeat the enemy, the regular tune picks up where it left off.

Channels are a simple way to refer back to a playback instance of sounds, so that you can control their volume and pause/resume them in the future.


Channels are referred to by number, starting at index 0, ending at index 31.

32 channels are available in total.

Note: When you play a sound/music without specifying a channel, Stencyl picks the next available channel starting from 0. If none are available, nothing happens.

Known Issues

On the Android target, playing sounds may be delayed by a quarter to half second on some devices. This is due to a bug in Android's sound APIs. As of late 2015, this bug still exists and afflicts all products that use this API.


  • Music = Streamed, Sound Effects = Loaded into Memory
  • Channels let you control playback. They have little to do with the regular meaning of sound channels.
  • Don’t worry about MP3s - Adobe has you covered. On other platforms, we now use OGGs.

Challenge: Zelda-style Battle Music

Suppose that you’re playing Zelda. The regular tune plays, but when you approach an enemy, and the music switches over to the battle music. Once you defeat the enemy, the regular tune picks up where it left off.

How would you build this sound system?

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!


1 7 years, 8 months ago
@Mike - That's precisely the exercise the article puts you through. I've added one approach directly after that question is posed.
0 7 years, 8 months ago
I need some help. I am trying to play background music but every time my actor dies the song plays on top of the song already playing. is there any way to play music with a "when game start" block?
1 8 years, 1 week ago
I'm just gonna ask a small question, so I hope that there's somebody to answer it.
If the music gets streamed, but people download the game (I don't want them to waste time on loading every time they open the game) and play it without an Internet connection, does this mean that the music won't play?

0 8 years, 2 months ago
I've had troubles with playing music for one of my scenes. The music doesn't play but my sound effects does. Ever since i added the camera scroll, my background music hasn't worked.

0 9 years, 1 month ago
Oops, remove that space in the link.
0 9 years, 6 months ago
I'm that user :) and here is my vague attempt at boiling it down. http://shadowlabs.net/stencyldocs/s eamlessmp3.pdf
0 9 years, 6 months ago

Sign In to Comment