NAME

       xbubble - an X Window based puzzle bubble clone

SYNOPSIS

       xbubble [OPTION]

DESCRIPTION

       XBubble  is  a Puzzle Bubble (PB) / Bust-A-Move (BAM) clone for Unix/X11 platforms. It was
       written from scratch with no real intent to exactly reproduce the original game.

OPTIONS

       -d DISPLAY
              Set X display to DISPLAY.

       -s <scale>
              Set game window size (between 5  and  100).   The  game  window  size  is  normally
              automatically  scaled to your screen size.  This option is useful to reduce load on
              slow/loaded systems. See also the -f option.

       -f <framerate>
              Adjust frame rate (in frames per second). Usual values are 100 (default),  50,  33,
              25,  etc.  The  actual  frame  rate  may  be  different from the one you specified,
              depending on system timer resolution. You can use this option  to  reduce  load  on
              slow/loaded systems (e.g. if sprite animation is jerky). See also the -s option.

       -r <resource path>
              Tell   XBubble   to   look  for  its  graphics  files,  fonts,  etc.  in  directory
              <resourcepath>.

       -t <theme name>
              Use the given theme (possible values are: plain, frozen, fancy).

PLAYING

       The goal is to clear all bubbles from your board and avoid bubbles dropping below the line
       at  the  bottom  of  the  screen.  You  can  rotate and fire a canon that launches colored
       bubbles. Bubbles bounce against the walls until they get stuck to another bubble.  If  you
       get  three  or  more adjacent bubbles of the same color they all explode, while any bubble
       left hanging free falls down.

       In single player mode, the ceiling goes down every 12 launches so that you must clear  the
       board before the ceiling touches the ground.

       In multi-player mode, the ceiling does not move but a fresh row of bubbles is added on top
       of the board while all bubbles are lowered by one row. Additionally, each time you explode
       three  or  more bubbles, all extra bubbles are sent (with random colors) to your opponent,
       as well all falling bubbles.  You win the round when  your  opponent  loses  (has  bubbles
       dropping across the bottom line).

       After  a few seconds delay, your canon launches its bubble anyway. You can tune this delay
       when selecting your handicap.  The higher the handicap, the shorter the delay.

GAME CONTROL

       The game is entirely controlled using the keyboard:

       Player 1

              Left arrow / Keypad 4   =  Rotate canon left

              Right arrow / Keypad 6  =  Rotate canon right

              Up arrow / Keypad 5     =  Launch bubble

       Player 2

              x  =  Rotate canon left

              v  =  Rotate canon right

              c  =  Launch bubble

       General

              Up arrow / Keypad 8    =  Menu navigate up

              Down arrow / Keypad 2  =  Menu navigate down

              p                      =  Pause

              Escape / q             =  Abort

              There is no command-line option for changing control keys yet.

PLAYER VS COMPUTER MODE

       You can choose between 5 levels of difficulty.  Beware of the highest level if you have  a
       slow machine, as it is quite CPU consuming.

BUGS

       Please report any bugs you find to one of the authors whom address in indicated below.

LICENSE

       xbubble is covered by the GNU General Public License (GPL).

SEE ALSO

       frozen-bubble(6).

AUTHORS

        Ivan Djelic <ivan@savannah.gnu.org>
        Martin Quinson <martin.quinson@tuxfamily.org>

                                                                                       XBUBBLE(6)