%ents; ]> The &kfouleggs; Handbook Philip Rodrigues
philip.rodrigues@libertysurf.co.uk
Nicolas Hadacek
hadacek@kde.org
Developer
Lauri Watts
vampyr@atconnex.net
Reviewer
2000 Philip Rodrigues &FDLNotice; 15/12/2000 2.00.05 &kfouleggs; is a clone of the Japanese PuyoPuyo game for the K Desktop Environment. KDE kdegames KFoulEggs PuyoPuyo
Introduction &kfouleggs; is a clone of the Japanese PuyoPuyo game, with advanced features such as multiplayer games against human or AI, and network play. If you have played Tetris, or one of its many clones, you will find &kfouleggs; easy to learn. Game Play Starting a New Game When you start &kfouleggs;, just click on the Press to start button, or select New Game from the Game menu at any time to start a new game. Aim of the Game The aim of the game is to achieve the highest score possible by moving the falling tiles in such a way that tiles of a similar colour are adjacent, and disappear. The more tiles you remove, the higher your score. Playing the Game Use the Left and Right arrow keys to move the falling tile in the relevant direction, and the Up arrow and Return keys to rotate the tile left and right respectively. The Shift key drops the tile down one line, and the Down key drops the tile all the way down - use it as a way of saving time. All of these key bindings can be customized by selecting Configure key bindings from the Settings menu. If two or more tiles of the same colour come to rest horizontally or vertically next to each other, they become glued. If four or more pieces of the same colour come to be glued, they disppear, and any pieces above them fall down according to the law of gravity ;-). If this causes four or more pieces to become glued, then they will also disappear, and so on. Every time you remove 100 tiles, you advance to the next level, where the tiles fall faster, and the game is more difficult. The game ends when the central column fills with tiles, and no more can fall. &kfouleggs; Preferences and Default Keybindings Game preferences The &kfouleggs; preferences are accessed from Settings Preferences. They can be set as follows: Show tile's shadow If checked, a shadow is placed beneath the game board showing where the piece will fall. Show next tile If checked, shows the next tile that will fall onto the game board. Enable animations If checked, pieces gluing are shown with an animation. Block Size Sets the size of the falling blocks. Default keybindings The default keybindings for &kfouleggs; in one-player mode are as follows: Rotate Left Up Arrow Rotate Right Return Move Left Left Arrow Move Right Right Arrow Drop Down Down Arrow Drop One Line Shift Multiplayer and Network Play General Information &kfouleggs; supports two local multiplayer types - Human vs. Human and Human vs. Computer. To play either of these, select it from the Multiplayers menu. Local Multiplayer Games In Human vs. Human or Human vs. Computer mode, two gameboards are shown, one for the first player and one for the second. Each has its own Score, Removed and Level indicator. The keys for the first human player become, by default: Rotate Left E Rotate Right Alt Move Left F Move Right G Drop Down D Drop One Line Space The keys for the second human player are the same as for the player in single player mode. To return to single player mode, select Multiplayers and Single Human. Network Multiplayer Games Multiplayer network games are set up by selecting Multiplayers More... Multiplayer games of &kfouleggs; use the model of a hosted game which other players join. Hosting a game To host a game, select Create a network game in the Multiplayers option dialog, set the port you want to use, and click on the Next button.You then have the option of changing local players' settings, if there are more than one local players. Clicking the Finish button advances the dialog to the waiting for clients stage. When enough clients have joined, Start Game starts the multiplayer game. Joining a game To join a game, select Join a network game in the Multiplayers option dialog. Select the host (Server address) and Port you want to connect to. Make sure that the port you set when joining a game is the same as the port that was set by the host of the game! Clicking Next takes you to the Local players settings dialog (see above), and then Finish connects to the remote game. The game starts when the host chooses - the client has no choice. Command Reference The main &kfouleggs; window The Game Menu CtrlN Game New Starts a new game. H Game High Scores... Displays the high scores. P Game Pause Pauses the game CtrlQ Game Quit Quits &kfouleggs; The <guimenu>Multiplayers</guimenu> Menu Multiplayers Single Human Sets the multiplayer mode to single player Multiplayers Human vs Human Sets the multiplayer mode to two player with two human players. Multiplayers Human vs Computer Sets the multiplayer mode to two player with one human and one computer player. Multiplayers More... Displays the multiplayer options dialog. The <guimenu>Settings</guimenu> Menu Settings Show Menubar Shows or hides the Menubar Settings Configure Key Bindings Displays a standard KDE key bindings configurator. Settings Preferences Displays/changes the &kfouleggs; preferences. Settings Configure AI Displays the &kfouleggs; AI Configurator The <guimenuitem>Help</guimenuitem> Menu F1 HelpContents This invokes the KDE help system starting at the &kfouleggs; help pages (this document). ShiftF1 HelpWhat's This? This changes the mouse cursor to a combination arrow and question mark. Clicking on items within &kfouleggs; with this arrow will open a help window (if one exists for the particular item) explaining the item's function. Help Report Bug Report a bug or a wishlist item to &kfouleggs' authors. HelpAbout Kfouleggs This will displays version and author information HelpAbout KDE This displays the KDE version and other basic information. Credits and License &kfouleggs; Program core engine copyright 1995 Eirik End Program copyright 1996-2000 Nicolas Hadacek hadacek@kde.org Documentation copyright 2000 Philip Rodrigues philip.rodrigues@libertysurf.co.uk &underFDL; &underGPL; Installation How to obtain &kfouleggs; &kfouleggs; is part of the KDE project http://www.kde.org. KFoulEggs can be found in the kdegames package on ftp://ftp.kde.org/pub/kde/, the main ftp site of the KDE project. All required libraries can be found on The KDE ftp site. Compilation and Installation In order to compile and install &kfouleggs; on your system, type the following in the base directory of the kdegames distribution: % ./configure % make % make install Since &kfouleggs; uses autoconf and automake you should have not trouble compiling it. Should you run into problems please report them to the KDE mailing list, or the program maintainer, Nicolas Hadacek, at hadacek@kde.org.