NAME

       cuyo - Tetris-like game with many suprises

SYNOPSIS

       cuyo [-d] [-f] [-g widthxheight] [-h] [-?] [--version versions] [ld-file]

       cuyo -?

DESCRIPTION

       Use  A,  D,  W and S or the arrow keys to move left, move right, turn and drop the falling
       piece.  Try to put blobs of the same color together.  (You don't  need  to  form  rows  or
       columns.   Any  shape  will  do.)  When enough blobs of the same color are connected, they
       explode.  (What "enough" means depends on the level.)  Try to make explosions next to  the
       the  grass  (or  whatever  there  is  in  the  level instead of the grass).  Then, it will
       explode, too.  The level is finished when no grass is left.
       In some levels, you will need a chain reaction to get rid of  the  grass-equivalent.   And
       many other things may happen in other levels.
       In  two-player-mode,  each  time  one  player causes an explosion, the other one gets grey
       things (which explode when something else explodes next to them).  If one player builds  a
       too big tower, the other player may get one of his rows.

OPTIONS

       -d     Debug mode.

       -f     Fullscreen mode.

       -g widthxheight
              Set the window size.

       -h     Print a short help message and exit with status 0.

       -?     Print a short help message and exit with status 1.

       --version versions, --version=versions
              Activate  special  versions  of  levels  and  level  tracks.   versions is a comma-
              separated list of version specifiers.  Version specifiers pertaining to  difficulty
              setting,  numbers  of players, and level tracks can also be set from the main menu.
              See the cual(6) manpage for the relevant  values.   The  other  version  specifiers
              which are actually used in levels are eco and geek.

              eco  makes  a  very few levels less resource-hungry.  In the consequence, they also
              become less beautiful.

       If you're trying to design own levels, you can pass the  name  of  your  .ld  file  (level
       description  file)  to  test  the  level.  If you do that, this will be the only available
       level.

CREATING NEW LEVELS

       The main work is to draw all those  little  icons.   Then  you  have  to  create  a  level
       description  file  which  tells  cuyo how to put everything together.  There is an example
       level with many comments.  Its description file is example.ld.  (It should be part of  the
       cuyo  distribution  and  probably  lies  in  the  same  directory  as the other cuyo level
       description files.)  It is rather outdated but may still be a good starting point.

       Other Sources of information are:

       - Try man cual.  Cual - the Cuyo Animation Language - is the format of  level  description
         files.

       - And  of  course,  there  are  the  level description files of the existing levels (files
         ending in .ld, probably located somewhere like /usr/share/games/cuyo/).

SEE ALSO

       cual(6)

BUGS

       The level description language is still under development.
       In the preferences dialog, some keys are not displayed correctly.
       The AI Player is not very intelligent.  In particular, it doesn't understand most  of  the
       special features of the levels, and so, it sometimes behaves very silly.
       See the TODO file for other bugs.

AUTHORS

       Mainly Immanuel Halupczok <cuyo@karimmi.de>.
       Other contributors to the source code: Bernhard R. Link, Mark Weyer, Bernhard Seckinger.
       Other contributors of levels: Daniela Lipps, Simon Huggenberger.

                                            2012-1-27                                     CUYO(6)