
                          **************************
                          *  HAPPYLAND ADVENTURES  *
                          *     X-MAS  EDITiON     *
                          **************************

                        a game written by Johan Peitz

                     brought to you by Free Lunch Design
 			   www.freelunchdesign.com

                               (c) 2000 - 2003

			    art by Johan Peitz and
                         from Ari Feldman's SpriteLib

                       v1.3 (see end of file for changes)


GENERAL

    Welcome to Happyland Adventures, X-Mas Edition! This game is 
    completely free. You may play it as much as you like without paying 
    a single buck. In exchange for playing it, you are instead asked for a
    small favour. You are encouraged to send any comments you might have
    about this game. 

    This game was originally written for an amateur game programming
    contest at www.gamedev.net. Happyland Adventures won the contest,
    it also got an award for 'best use of SpriteLib'.

    Anyhoot, having recieved heaps of comments about the original
    Happyland Adventures, I decided to release a christmas edition
    and here it is. Enjoy!


DISTRIBUTING

    Happyland Adventures is freeware, anybody may (and should) play it.
    Therefore, you are encouraged to distribute this game (in it's
    original form) like crazy. Upload to every website and bbs you know,
    give a copy to all your friends, etc.. However, this game may not be
    included in a compilation or any other kind of commercial package
    without the permission from the author. See contact near the end of
    this document.
  

DISCLAIMER
                  
    I do not accept responsibility for any effects, adverse or otherwise, 
    that this software may have on you, your computer, your sanity, your 
    dog, or anything else that you can think of. Use it at your own risk. 
    I have, however, never experienced any trouble with it.
                           

DESCRIPTION

    Happyland Adventures, Xmas Edition, is a classic jump'n'run combined
    with original puzzle elements, a game full of surprises. Explore the big
    levels and collect bonus for more points. Help Santa and bring all his
    helpers back to home.


HARDWARE REQUIREMENTS

      * Pentium
      * 8 MB RAM
      * VGA-card/display
      * gamepad  (optional)
      * SB combatible soundcard  (optional)


INSTALLING AND STARTING THE GAME

   Reading this text file you have probably installed the game and it's files
   into a suitable directory, and that is all it take to install the game. If
   not locate HAPPY_INSTALL.EXE and double click it to start the installation 
   process. To start the game, open your start menu and look in the Free Lunch
   Design folder to find the game.

   Upon starting the game you will be presented with a menu with three 
   alternatives. You can choose to play 'Happyland Adventures - Xmas edition',
   'Happyland Adventures (the original)' or create a custom game. Click what
   ever version you want to play.

   If you choose to create a custom game you will be brought to the level-
   selection screen. Here you can add whatever levels you want to play and
   what bonusrooms to use. You can remove maps by clicking on them with 
   the right mouse button. When you're done, click 'PLAY' and the game
   will start.


THE PLOT

   The original Happyland Adventures didn't have much of a plot, neither has 
   this version. But at least there's a small story:

   It was the night before Christmas. Everyone in Happyland was sleeping,
   anticipating the day to come. Everyone, but Santa. The Happylanders
   who usually helped him had gone astray in the dark night and vanished. 
   How were they to survive? And how was he ever to complete all the chores 
   before Christmas without the help of his little friends? Realising that 
   he would need help he called the one who had saved Happyland on several 
   occasions before...

   It's now up to you to help Santa save Christmas. While Santa makes the
   gifts and presents you have to rescue his helpers, or else, Christmas
   will be lost forever!


THE TITLESCREEN

    The titlescreen will present you with a menu of the following format:

      PLAY
      PASSWORD
      OPTIONS
      HELP ME
      EXIT

    Use the arrowkeys to navigate the menu. The current selection is
    indicated by a small creature to the left of the selection. Use enter
    or space to select. EXIT exits the game. HELP ME shows a quick tutorial,
    OPTIONS takes you to another menu where you can customize the game.
    PLAY starts a new game, while PASSWORD let's type in a password and start
    at the appropriate level. PASSWORD can only be seen in the Xmas edition.


THE OPTIONS-SCREEN

    Here you can customize keys and controls. Adjust sound and music output.
    Navigate with up and down arrows and use left and right arrows to adjust
    the highlighted selection. Press enter or space to select.


CONTROLS

    Default keys are as follows:

      Action      Key

      Left        LEFT ARROW 
      Right       RIGHT ARROW 
      Slide       DOWN ARROW 
      Jump        LEFT ALT
      Talk        LEFT CTRL

      Screenshot  F12
      Pause       PAUSE / ESC
      Quit        ESC

    Screenshots will be stored as HAPPY???.PCX, where ??? is the number
    of the screenshot taken.

    If you want to use a gamepad (recommended). Simply press the button
    or direction on it instead of a key during the control setup.


PLAYING

    The goal of each level is to save the Santa's helpers scattered over the
    level. When you have saved enough helpers the level exit will open.
    The number of helpers the you must save is shown in the top right
    corner of the screen, just below the time indicator.

    If you save _all_ helpers on a level, enemies will turn into coins.

    Tip! There is often more to do on a level even if you have opened the
    door. Ie, don't exit immediately. :)  Some levels has more than one exit, 
    try finding them all. They are often cleverly hidden, holding bonuses if 
    you find it.

    Each level must be completed within a specified amount of time. You can
    see how much time is left in the top right corner of the screen. 

    Old wise men also inhabit Happyland. Make sure you talk to them. They
    might give you useful hints.

    Picking up bonus items will help you earn extra lives. If you pickup 250
    bonus items you will be rewarded with an extra life. You can see how many
    bonus items you have at the centre at the top of the screen. Most levels
    also hold magic spheres. If you find 5 of these blue balls you will be 
    given a password if you complete the level.


PICKUPS

    Most items you can pickup will only give you points. There are however a
    few that give you special powers or more points.

        STAR            more points
        DIAMONDS        even more points
        HEART           increases your energy
        TIMEGLASS       recieve extra time
        COIN            collect all to access bonusroom
        BLUE POTION     invunerability for a short while
        LOW-G SHOES     jump higher and farther
        BLUE SPHERES	find five and you get a password


TROUBLESHOOTING / FAQ

    Q: The game runs in a really tiny window, how do I get full screen?
    A: Press 'W' in the first menu (where you select custom, normal or xmas).
       
    Q: There's no sound!
    A: The sound should autodetect. Something might be wrong.

    Q: Can I load levels I made for the original Happyland game into 
       Happyland Adventures - Xmas Edition?
    A: Of course you can! They will work perfectly.

    Q: I want more levels!
    A: Take a look at the following adress:
       http://www.freelunchdesign.com/happyland.shtml
       Any new levels can be found there.       

    Q: Will there be a sequel (triquel)?
    A: Nope. As it looks now, the Happyland series are finished.
       
    Q: What is all this mumbo jumbo about the original?
    A: I wrote the original game to a contest at gamedev.net (which
       I won). Xmas Edition is only a sequel.

    Q: Have you written any other free games?
    A: Take a look at the following adress:
       http://www.freelunchdesign.com
       You will find lots more there.

   The latest version of this FAQ can be found at www.freelunchdesign.com. 


AUTHORS & CONTACT

    Happyland Adventures is coded and designed by Johan Peitz. Johan Peitz also
    drew the xmas graphics, the rest of the graphics are from Ari Feldman's
    Spritelib.

    Levels in the XMas Edition were made by Johan Peitz and Mark Hickford.

    Free Lunch Design is an independent game developer from Sweden. Our aim
    is to create small, high quality games, where gameplay is in focus.

    Visit us on the web: http://www.freelunchdesign.com

    If you have comments, bug reports, or just want to ask something
    you can contact Free Lunch Design by e-mail. I do however get a lot of 
    mail and it might take a while before I answer, so if you have a question 
    please check the online faqs and forums first.

      E-Mail: info (at) freelunchdesign (dot) com

    If you want to support Free Lunch Design in monetary ways, please enter 
	our website (see documentation) and click our sponsors a few times. :) 
	You can also donate money through PayPal.


SPECIAL THANKS

    I would like to thank the following people:

    Ari Feldman for SpriteLib
    Shawn Hargreavers for Allegro
    Ivan Baldo for PPCOL
    Mark Hickford again for making tricky levels
    Arnon Yaari for beta testing


WHAT's NEW IN VERSION 1.3

    * Fixed some erros in some of the levels.
    * Fixed some bugs in maped.
    * Screenshots are now readable.
    * Possible to stretch the screen for higher resolutions.
    * The path is remembered when adding maps (CUSTOM GAME).
    * Added the Rolling Hills levels to the MAPS directory.
    * Minor touch ups in custom game creation.
    * Small fixes here and there.
    * Updated readme.txt and maped.txt


EXTRAS

    My SpriteLib license number is: 129.16.30.119-952518357



                                - The End-

