Games::FrozenBubble(3pm)				User Contributed Perl Documentation				  Games::FrozenBubble(3pm)

NAME

       Games::FrozenBubble - arcade/reflex game - THIS IS A BETA VERSION

TIPS

       During net/lan game choose, there is a chat system. Here are the available keys and tips:

       just type and hit enter to send a message
       page up and page down allow you to view history as in IRC programs
       arrow up and down allow you to recall previous messages you've sent
       the TAB key triggers nick completion on listening players
       in the pre-game chat, the following commands are available:
	       /me <action>: sends an action message instead of sending a regular message
	       /nick <new_nick>: change your nick
	       /server: query the name of the server you're connected to
	       /fs: toggle fullscreen
	       /list: view list of listening players
	       /geolocate: geolocate yourself again
	       /autokick <nick> [<text>]: add/remove that nick to autokick list

       in the in-game chat, the following commands are available:
	       /kick <nick> [<text>]: kick a joiner from your game (if you're
				      creator), optionally with an explanatory text

       During a game, the following default key shortcuts are available:

       TAB: next playlist music (if sound available and when playlist is used)
       F11: toggle music
       F12: toggle sound
       Keypad Minus: lower music/sound volume
       Keypad Plus: raise music/sound volume

       When in multiplayer with 3+ players:

       F1: send malus to top left player
       F2: send malus to top right player
       F3: send malus to bottom left player
       F4: send malus to bottom right player
       F10: send malus to all opponents

       Notice: you can see who you attack because the F1..F4 little text next to the player turns white - you can see who is attacking by the
       presence of the small pinguins of the opponent on the left of your igloo.

TROUBLESHOOTING

   Having problems running Frozen Bubble?
       If you are colourblind, we already have what you're looking for: please use the "-cb"commandline parameter, and bubbles will be printed
       with little geometrical symbols inside.

   Fix your problems
       Most of the problems you can encounter with Frozen-Bubble don't require contacting us directly, and actually we can't fix most of them.

       First, please notice that we have developed this software on the GNU/Linux platform. There are ports to other operating systems, but we
       can't and don't want to support them. If you happen to be using Frozen-Bubble on FreeBSD, NetBSD, Windows or Mac OS X, please contact the
       authors of this "port" if you have trouble installing/running/whatever. Thank you.

       Then, if you use Linux and installed a package provided by your distribution, you have to contact the guys of your distribution. We don't
       know the intrinsics of every Linux distributions and neither the patches they have applied to Frozen-Bubble when packaging.

   Troubleshoot most common problems on GNU/Linux
       First, please notice that we are not a GNU/Linux vendor, we are not Debian, Red Hat, Ubuntu, Mandriva or Gentoo. So if you can't install it
       with apt-get, emerge, urpmi, yum or whatever, or if you managed to install it but it won't start or won't run properly, there are much
       higher chances this is a problem with your vendor, not with us. Try to think before contacting us: is your problem really with our
       software? or with how your vendor compiled/integrated it with the system?

       Now, to ease your life, we provide links to common problems you may encounter.

       "...cannot handle TLS data..." message at startup
	   It seems this is related with buggy or badly installed nvidia drivers. Debian has a bugreport and a fix
	   (http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=223096 <http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=223096>) for this one.

       "Can't locate SDL.pm in @INC..." message at startup
	   Either you didn't install sdlperl, or you installed it at the wrong location.  Check where the file SDL.pm was installed on your system
	   and what is the @INC search path of perl, there are chances they don't match.

	       perl -e 'print join("
", @INC)

       crash with a "SIGILL" when trying to start a new game
	   You're probably using buggy "SDL-1.2.6" on an Intel processor; please update to "SDL-1.2.7" or more recent.

       "Not a HASH reference at /usr/games/frozen-bubble line 310" message at startup
	   It seems that you're using an incompatible (too recent) version of perl-SDL on FB1. Either downgrade or apply this patch.
	   http://www.frozen-bubble.org/perl-SDL.patch <http://www.frozen-bubble.org/perl-SDL.patch>

       If you have more to add, you may want to contact us: "contact2 X frozen-bubble.org",
       <http://sdlperl.ath.cx/projects/SDLPerl/query?component=FrozenBubble>

FREQUENTLY ASKED QUESTIONS

   Help! I am unable to download Frozen-Bubble from your website!
       Uh, the downloads page (http://www.frozen-bubble.org/downloads/ <http://www.frozen-bubble.org/downloads/>) should be fairly understandableX

       If you're using Windows, or Mac OS X, read the Ports section of the downloads page (http://www.frozen-bubble.org/downloads/#Ports
       <http://www.frozen-bubble.org/downloads/#Ports>)!  man, you can do it, I am sure you can, don't quit trying so fast!

   Help! Frozen-Bubble doesn't work!
       Easy, go to the troubleshooting page (http://www.frozen-bubble.org/troubleshooting/ <http://www.frozen-bubble.org/troubleshooting/>).  And
       don't forget we don't know your system or distribution, help yourself or ask your vendor.

   Hey, why not porting Frozen-Bubble to <my favorite phone or whatever>?
       Simple! Because we aren't interested in this. Ask the authors of other ports, maybe they will be. But no use emailing us about it.  Thanks.

   I'd suggest adding mouse aiming to the game
       Yes, but, see, it would not be fair to players using keyboard, because mouse aiming is analog-based, whereas keys are not. So, no mouse,
       sorry.

   My joystick doesn't work!
       If you're not using Linux, sorry we don't know and support your system.

       If you're using Linux, maybe we can help. When trying to use your joystick in Frozen-Bubble, if nothing comes up, most probably your
       joystick isn't configured correctly (or supported in Linux), use "--joysticks-info" commandline parameter to verify that FB detects your
       joystick properly: if it does, information about your joystick(s) will be printed in console on startup, and you should have no problem
       using your joystick in FB - just trigger a direction or a button in the "change keys" dialog; if not, try to load the proper kernel modules
       etc - for example, the kernel module "joydev" is needed for all joysticks, but it is sometimes not automatically loaded when plugging in a
       joystick (even in modern distros and with USB joysticks) - after loading this kernel module, retry in FB.

   Special keys
       In the 3p/4p/5p network game, you can see F1, F2, F3 and F4 printed in the game screen - one function key per remote player. These keys
       allow you to aim at a particular remote player instead of everyone at the same time. Indeed, by default, when you create malus bubbles to
       be sent to your opponents (by exploding a larger group or when bubbles were sticked to exploding bubbles), they are distributed evenly
       among all of the (living) opponents. If you hit the, say, F2 key before (you can verify you did because F2 is then printed in white on the
       game screen), next time you will create malus bubbles, they will all be sent to the top-right opponent. This feature can allow you to team
       up or to aim at the strongest opponent. You can hit F10 to request back an evenly distribution. Notice that when using at least version
       2.1.0, you can see who's attacking you at any time by looking at at pinguins left to your igloo
       (http://www.frozen-bubble.org/data/fb2.1-attackmaterialized.png <http://www.frozen-bubble.org/data/fb2.1-attackmaterialized.png>).

       The keys F11 and F12 are also useful (version 2.1.0 minimum): F11 allows one to toggle the music, and F12 allows one to toggle the sound
       (music plus sound effects).  Additionally, keypad's minus and plus keys allow to alter sound volume.

   It is a shame, I cannot toggle sound in the game!
       Easy, read the "Special keys" FAQ item.

   Why not 2 or more players on the same computer, and still a 3/4/5 player game in network?
       Because in 3p/4p/5p game, there is room for only one player with full size graphics. For the other players, the graphics are smaller
       (http://www.frozen-bubble.org/downloads/data/fb2-5p.png <http://www.frozen-bubble.org/downloads/data/fb2-5p.png>), so more than one local
       player is not possible.

   What are chain reactions?
       When you pop some bubbles, and another bubble was being held up by the bubbles you popped, that other bubble falls and becomes a malus
       bubble.	In chain reaction mode, that other bubble can also rise up and pop some other bubbles, if you have a pair of bubbles on your
       screen that are the same color as it with a free position next to it.  This might, in turn, release more bubbles, which can also rise up
       and pop pairs of their own color, in a big chain reaction. Let's illustrate that:

       1. First, you pop some bubbles of the same color, yellow in our example, which release some extra bubbles of a different color (black and
       purple).
	   http://www.frozen-bubble.org/data/cr1-0.png <http://www.frozen-bubble.org/data/cr1-0.png>

       2. The purple bubble just falls.  The black bubble would fall too, but this is chain-reaction mode.  So instead of falling, the black
       bubble sees a group of other black bubble with a free position next to it, and swoops back up to be with them.
	   http://www.frozen-bubble.org/data/cr1-1.png <http://www.frozen-bubble.org/data/cr1-1.png>

       3. The black bubbles pop, releasing several other bubbles.  The orange bubble sees a group of other orange bubbles with a free position
       next to it, and swoops back up to be with them.
	   http://www.frozen-bubble.org/data/cr1-2.png <http://www.frozen-bubble.org/data/cr1-2.png>

       4. The orange bubbles pop, releasing a couple of other bubbles.
	   http://www.frozen-bubble.org/data/cr1-3.png <http://www.frozen-bubble.org/data/cr1-3.png>

       5. But there are no more groups for these bubbles, so the chain reaction is over.
	   http://www.frozen-bubble.org/data/cr1-4.png <http://www.frozen-bubble.org/data/cr1-4.png>

   What's single player targetting?
       Easy, read the "Special keys" FAQ item.

   Can I meet the game designers or other players on IRC?
       Sure! Please join the IRC channel "#fb2-en" for English, or "#fb2-fr" for French, on irc.freenode.net (<http://freenode.net/>) - though
       we're rarely there. Best is to send a mail.

CONTRIBUTE

       Talk to FROGGS or kthakore on #sdl irc.perl.org.

       Fork and hack on http://github.com/kthakore/frozen-bubble <http://github.com/kthakore/frozen-bubble>

perl v5.14.2							    2012-06-21						  Games::FrozenBubble(3pm)