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 email@example.com
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 firstname.lastname@example.org 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
Oh and commercial engines are just fine. Just be sure to note they are commercial in your README (see Supply A Good README below).
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.
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!