Balls on Fire
-------------
by Exile Studios
An entry for the Gamedev compo at Assembly 2007 summer.

http://www.exile-studios.org/bof


Contents of the package
-----------------------

This package contains binary releases for multiple platforms.
The packages are in the release directory.
Choose one that suits your needs and extract it.

For Windows:
- Use ballsonfire_win32.zip
- Run ballsonfire.exe
For Linux 32 bit:
- Use ballsonfire_linux_x86_32.tar.gz
- Use the script 'BallsOnFire' to launch the game
For Linux 64 bit:
- Use ballsonfire_linux_x86_64.tar.gz
- Use the script 'BallsOnFire' to launch the game


How to play
-----------

The purpose of each level is to get the ball in to the bowl
without touching the floor.

Rotate the slabs and test your solution. If it doesn't work
re-adjust the slabs and try again. If the ball reaches the
bowl the level is cleared and you advance to the next level.

Completing the level awards you points depending on the number of
tries and the time spent.

At all times you have four uncleared levels open. By clearing a level
you open one more. The top score for each level is recorded and
you can play an already cleared level again and try to beat the top
score.


Key commands
------------

You can select the bounce slabs and press the various buttons
during the levels with the mouse.

   In main menu:

        Arrow keys: move selection
        Space/Enter: confirm selection
        Esc: quit the game

   In game play:

        (Shift+)Tab: cycle the bounce slab selection
        Arrow keys: rotate the selected bounce slab
        Space/Enter: Toggle between manipulation and simulation modes
        Z, X: rotate view around the level
        Esc: return to main menu


Level Editor
-----------

NOTE: this section is incomplete. Await for more information in the
final release!

One can make own levels with the bundled level editor. The level
can be tested with the game. The level editor & export toolchain 
is integrated to a Blender 3D scene file (see level_editor.blend).
Blender is an Open Source 3D modeling & animation suite and freely
available for anyone to download at http://www.blender3d.org/ .

On Windows you have these keys:
        F2: user level open dialog
        F5: reload user level

With other platforms you can give the command line option --level
followed by the name of the level file.


Copyrights and legal notices
----------------------------

Balls on Fire is Copyright 2007 Exile Studios


Ogre is licensed under LGPL.
OIS is licensed under zlib/libpng license.
DevIL is licensed under LGPL.
FMOD is copyright by Firelight Technologies, Pty, Ltd.

All applicable license texts can be found in the directory 'license'.
