This information is designed to give people a quick and dirty lesson on the PushButton Engine (PBE) and its use in game development. You may not have heard of PBE, but that’s not something you need to worry about. We’ll be guiding you through the top down approach to building your first flash games with this system and give you a great overview of some of the major advantages to this tool.
If you’ve already checked out PBE you will notice that the original articles by them are actually quite similar to what this is going to be discussing and the information it provides. It’s fine to skip this, as this is a gentle overview of the more straightforward parts of tool. This is a start at the beginning, and assumes very little about the person’s experience or understanding of PBE, so the later articles about this topic are likely best.
I’m Dying to Talk About the IDEs
I have always used Flash builder for my IDE, but Professional CS5 or 6 are also just fine for this. If you use another alternative IDE, then there are certainly some options out there for you, but it shouldn’t be too hard to follow this tutorial given that they’re usually quite similar. Given the state of game development today in flash, you’re probably going to spend most of your time in a text editor, which isn’t a problem, since these IDEs always have good editors. For the CS Professional users you’re going to want to stick to the Actionscript editors that come with it, because it integrates directly into tools like Flash Builder anyway. This is likely the best course of action starting out, unless you’re already familiar with these types of interfaces.
You have two major options with Flash Builder: Flex based or Actionscript. You will need to make the decision which to go with, as the majority of setup is the same for both. Multiscreen deployment is a bit tricky, but this is best done with pure Actionscript approaches with Flash Builder, as flex does not typically work across numerous platforms innately. Flex is used for web/desktop/or other specific interfaces, rather than cross targeting many platforms at once. In the present app OS space, it probably makes more sense to do the ActionScript style approach.
Prior to diving headfirst into the development of any apps, I did promise to let you know how to do the most rudimentary parts of this set up. Let’s start out with setting up a “Flex” project.
- Create a new Flex Project in your tool and call it something like “PBE_Tutorial”
- Download and extract the latest version of PushButton. Sadly this interface is no longer directly supported, but the sourcecode and download is on github and elsewhere.
- Naturally, unpack the zip and open the bin folder that’s in the file.
- You should seen something like PBEngine.swc or similar.
- Copy all of this to your library folder as part of your flex project (libs).
If you were doing this in Flash Builder the steps are basically exactly the same, other than needing to generate the library folder yourself. You have to link that folder to your project as a linked SWC folder. In order to do this you simply right click on the project, and select properties.
It’s recommended above that you copy the PBEngine.swc file into the library folder of your project, but this isn’t a strict requirement. Some people just link to it from another folder instead, which could cause an issue if it’s moved from environment to environment in the future. This is fine though, and it will work.
Once you’ve done this and added the SWC file into your project, you will need to update compiler arguments so that all of the metadata tags you need are included. PushButton Engine uses a few unique ones, well relatively unique anyway.
- Once again, right click on the project entry in the Navigator screen
- Select Properties again from the menu
- Select the Flex Compiler
- Under “Additional Compiler Arguments” add in the following “-keepas3-metadata+=TypeHint,EditorData,Embed”
- Click OK, which causes the changes to be applied and close the dialog box
I hope this instruction got you started with PBE and many of the first steps you have to take to start a project in these tools to work with a flash developer tool like this one. It’s a great source. Documentation available on Github from PushButton is incredible and comprehensive. We highly recommend you read through their source code, documentation, guides and other things the coders spent years working on. They have a lot of great ideas, and this tool is incredibly versatile.