PushButton Engine v1 Manual

Welcome to the PushButton Engine! PushButton Engine is an open source Flash game framework.

This manual covers the basics of developing with the PushButton Engine. The various sections linked on this page cover different parts of the engine. Everything from lessons on how to get started to video talks about the engine to references on many subsystems in the engine are included.

The most important part of PushButton Engine is its community. Be sure to visit our community page to see what's going on in the forums, what the latest PBE games are, and more.

First Steps: PBE In 30 Seconds

Here is everything you need to know about PBE in a short list:

1. Download PBE here, or get it from our Google Code SVN.
2. The engine code is in src/. The SWC is in bin/ (if you downloaded a zip).
3. Here is the API reference.
4. See Lesson #1 for details on how to get started with using PBE, including how to set it up with your favorite Flash tool/IDE.
5. Visit our community forums, and IRC.

If you like more verbose explanations, we have an overview that explains what PushButton Engine all about, what component are, and how everything fits together.

Community

Our community is built around teaching people how to build great Flash games using PushButton Engine. We expect PBE users to have some programming background, but if you run into problems, please visit our forums and let us know. We are always improving.

The best place to get involved in our community is on the PushButton Engine community page and on our IRC channel (#pbengine on freenode.net).

PBE community member Mas runs the MakeYourFlashGame blog where you can find a series of good articles and tutorials on PBE.

Lessons

Lessons are short tutorials on how to perform tasks with the engine. New lessons will be posted as they are completed.

• Lesson #1: How To Set Up Your IDE
• FlashDevelop
  How to set up your build environment for FlashDevelop
• Flash CS4
  How to set up your build environment for Flash CS4
• Flex Builder
  How to set up your build environment with Flex/Flash Builder.
• Lesson #2: Adding a Simple Shape
  How to create a simple shape.
• Lesson #3: Adding Control with a Custom Component
  How to move a shape with a custom component.
• Lesson #4: Keyboard Input for Player Control
  How to extend the control component to respond to keyboard input.
• Lesson #5: Using and Embedding Images
  How to embed and display graphics assets.

Video Talks

We've prepared several videos discussing different parts of the engine. Most of them are short, around 5 minutes in length. They cover various important high level pieces of the engine.

• Understanding Components which explains what components are, and why they are a good approach for building gameplay.
• Resources which discusses how resources are managed in PBE.
• User Interfaces which talks about how to use Rendering2D with your user interfaces.
• Using the Profiler which talks about how to use PBE's built in profiler to optimize your game.

Reference

These sections go into detail on how specific parts of the engine work.

• Components
  How to write and use components.
• Levels and Serialization
  How our level files are laid out; details on the serialization system. How to manage levels and build your game on them.
• Resource Manager
  How to load and use images, XML, sounds, and add your own resource types.
• Style Guide
  How code ought to be written.
• Flow Of Execution
  What code is run when? How do you hook into PushButton Engine's time-related callbacks?
• Handling Input
  How is input handled by the engine? In addition, a list of the names of all the keys that can be used in an InputMap.
• Rendering2D
  A framework for componentized 2d rendering. How to extend and use it.
• Names
  How to name entities and components. How to find them by name.
• Metadata
  Supported metadata and what it means.