Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
70 lines (40 sloc) 4.72 KB

This Project Is No Longer Being Updated

Breakouts is in "archival" mode. The website and repo will remain available, but no updates will be made. We will not accept any new pull requests or contributions at this point.

Thanks for all the help from everyone! If anyone wants to take over the project, please email me at

#Breakouts -- Implementation Guidelines

So you want to contribute another engine to Breakouts? Awesome! Here's how to do it...

Before You Start

I have no idea if Breakouts will take off and become popular. But if it does, maybe contact me first to make sure someone else isn't already working on the engine you had in mind? I'm at or on Twitter

You can also check out the incoming implementations wiki page to see which versions are coming or claimed.

Engines We're Looking For

Currently we are only looking for JavaScript engines that focus on 2D games. It doesn't matter how popular or finished the engine is, as long as you can write the game in JavaScript and come up with an implementation that is on par with the existing ones.

Please don't write your implementation in anything but JavaScript. The point is to get to know the engines, and having implementations in different languages clouds the comparison. So yeah, please no CoffeeScript, TypeScript, anything like that.

On a similar note, we're not yet interested in systems that compile down to JavaScript, like HaXe or XNA to JavaScript compilers. I think we do want to expand into these at some point, and there has been some interest shown to do this. If you have such a system and want to be the guinea pig to see what it means/takes to get a Breakout implementation in for it, please contact me.

Oh and commercial engines are just fine. Just be sure to note they are commercial in your README (see Supply A Good README below).

Target Platforms

The main platforms we are shooting for are desktop machines running modern browsers (IE9 or 10 and better, Chrome, Firefox, Safari, etc). We also really want to hit mobile devices when we can, see the Mobile Devices section below

Implementing The Game

Be sure to use the provided resources

For the most part, if you just check out the existing implementations and make sure to do everything they do, you should be all set. Here are a few details to keep in mind:

  • There are a few sound effects: hitting a brick, the countdown's "blip", etc
  • The game is entirely mouse driven.
  • The background can be prerendered or use tiles (or both). See "The Background" section in the resources README

What about power ups? levels 3 and 4?

When Breakouts first launched, the games had power ups, power downs and 4 levels. We have since decided to simplify the game. So please don't add the power ups, or levels 3 and 4. You may still see these lingering in some versions, we are gradually going through and removing them.

Mobile Devices

If your engine is mobile friendly, please make your implementation work on mobile devices. The Impact version is a good example of this (try it on an iOS or Android device). If there are any limitations for mobile devices, that's fine. For example the Impact version has no sound effects when played on a mobile device.

Take Advantage Of Your Engine

If your engine can do a part of the game in a better way than prescribed, but has the same overall result, please do it. For example, the Impact and Crafty versions use frame animation for when a brick disappears. But the Lime version uses its scaling action to accomplish the same effect, but does it better. Stuff like that is great, please point out the good things your engine can do!


Please don't write tests. Tests really aren't the point of these games and just muddy the comparison.

Supply A Good README

This is important. For your implementation, add a good README file to its root directory. This README should ideally cover:

  • Homepage for the engine, and open source repository location for it (if applicable)
  • How/where/how much to purchase a license for the engine if it's commercial
  • What people need to do to get your implementation up and running on their machine
  • Anything special or unique that this implementation does

And anything else you think is important.

Submitting Your Implementation

Just send us a pull request. We'll go from there.


Thanks for contributing to the project, it's greatly appreciated!