     _____              _          __  _                                   
    /__   \ _ __  __ _ (_) _ __   / _\| |_  ___   _ __   _ __    ___  _ __ 
      / /\/| '__|/ _` || || '_ \  \ \ | __|/ _ \ | '_ \ | '_ \  / _ \| '__|
     / /   | |  | (_| || || | | | _\ \| |_ |(_)| | |_) || |_) ||  __/| |   
     \/    |_|   \__,_||_||_| |_| \__/ \__|\___/ | .__/ | .__/  \___||_|   
    http://www.bafsoft.com/games/trainstop       |_|    |_| (c) BAF 2006   

Welcome to Train Stopper, BAF's TINS06 entry. Train Stopper is a simple
game written in several hours for the TINS 2006 Game Programming
Competition <<http://amarillion.bafsoft.net/tins06>>.

I didn't have enough time to add as many mini-games as I would have liked
to, so there is only a few, but they do their job. :)

 -------------
+ Compilation +
 -------------

Unless you downloaded a binary version of Train Stopper, you will need to
compile it. Compilation is easy, just compile the mini-games and the main
game source code. For example:

Compile the mini-games:
cd minigames
g++ -c *.cpp -I../include
cd ..

Compile the game:
cd source
g++ -c *.cpp -I../include -I../minigames
g++ *.o ../minigames/*.o -o tstop -lalleg

Run the game:
./tstop

Important: Do not compile with optimization (you may even need -O0) - for
some reason, optimization screws up the train track animation.

The above was just a basic outline. The instructions may vary depending on
your platform (for example, replace -lalleg with `allegro-config --libs` on
various *nix platforms).

Note: A Windows binary is included in the source folder for those of you on
Windows. It requires alleg42.dll.


 --------------
+ Plot / Story +
 --------------

The plot of the game is very simple. The game takes place on a speeding
train. An elderly lady has fallen on your train, and is in risk of falling
off. Your mission, should you choose to accept it, is it prevent her from
falling off the train. You have 6 minutes and 6 seconds to play enough
mini-games to bring your train to a stop. When you enter a mini-game (chosen
at random each time) you will have to play through it. While you are playing,
your timer goes down. If you run out of time, she will fall off and you will
fail at your mission. However, if you complete the games in time, you will
stop the train, and she will live - and you win! Each mini-game has a
different gameplay, is worth a differing amount of MPH, and features it's own
help information.


 ----------
+ Gameplay +
 ----------

Gameplay is *very* simple. Once you are in the game, you will see the train
speeding along the track. In the upper right corner you will see your
countdown timer, and how fast the train is moving. To enter a random
mini-game, press the Home button. Each mini-game's gameplay differs, so be
sure to press F1 (note: while the help window is open the timer does not
countdown) and read up on how to play. If you decide you don't want to play a
game, you can press End to return, however you will be given a 30 second
penalty for not finishing the game. If you would like to choose a mini-game,
instead of having a random one, press Tab. If you slow the train down in
time, you will win. However, if you do not, you will lose the game.


 -------------------
+ Rule Conformation +
 -------------------

Genre requirement
**** There will be 1 genre rule

genre rule #56
"Time" should be the theme of your game.
Conformation: Time was the main theme of the game. The goal of the game is to
stop the train before the timer runs out.

Artistic requirement
**** There will be 1 artistical rule

artistical rule #82
the game should feature (a) railway(s) and / or train(s).
Conformation: The game is based around stopping a train before the time runs
out - the train is a main part of the game.

technical requirements
**** There will be 2 technical rules

technical rule #29
Provide a help function, that can be accessed during the game.
Conformation: There is a help function from each mini-game, accessed by
pressing F1

technical rule #14
Provide a good example of ascii-art. 
Conformation: The mini games and the main game itself feature almost no
artwork, most of the graphical interface is provided by regular text.

bonus
**** There will be 1 bonus rule

Bonus rule #1: Act of Dog
Conformation: This bonus rule was not utilized.


 ---------
+ License +
 ---------

Train Stopper is copyright (c) 2006 by Robert A. Ferris III (aka "BAF" or
"Baffles"). Train Stopper is released under the zlib license:

  Train Stopper, version 1.0, March 05, 2006

  Copyright (C) 2006 Robert Ferris

  This software is provided 'as-is', without any express or implied
  warranty.  In no event will the authors be held liable for any damages
  arising from the use of this software.

  Permission is granted to anyone to use this software for any purpose,
  including commercial applications, and to alter it and redistribute it
  freely, subject to the following restrictions:

  1. The origin of this software must not be misrepresented; you must not
     claim that you wrote the original software. If you use this software
     in a product, an acknowledgment in the product documentation would be
     appreciated but is not required.
  2. Altered source versions must be plainly marked as such, and must not be
     misrepresented as being the original software.
  3. This notice may not be removed or altered from any source distribution.

  Robert Ferris baf@bafsoft.com


 ------------
+ Known Bugs +
 ------------

There are no known bugs at this time in Train Stopper.


 -----------
+ Thanks To +
 -----------

The Allegro.CC community for various help / ideas during the competition.
#Allegro / #Allegro-tins for help and/or distraction.


     BAF / BAFSoft 2006 for TINS06 -- baf@bafsoft.com -- AIM: Bobert390
   MSN: webmaster@bafsoft.com -- ICQ: 348828487 -- http://www.bafsoft.com/