Copyright © 2000, 2001, 2002 Philip Rodrigues
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".
KFoulEggs is a clone of the Japanese PuyoPuyo game for the K Desktop Environment.
Table of Contents
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
When you start KFoulEggs, just click on the Press to start button, or select New 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 the same color 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 color come to rest horizontally or vertically next to each other, they become “glued”. If four or more pieces of the same color 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.
The Game Screen
Along the left hand side, from top to bottom:
- Score
Shows your current score.
- Puyos
Keeps track of the number of times you have removed each amount of consecutive Puyos. For example, every time you remove one set of pieces, the counter for 0 increments, every time two sets of pieces are removed in one go, the counter for 1 increments, and so on. The final counter records any removals of more than three sets of pieces.
- Level
Shows the number of the level you are currently on. The first, easiest level is level one, progressing to the last, hardest level, 20.
In the center is the area where the action takes place. The tiles fall through the rectangle (whose properties can be changed in >Settings->Configure KFoulEggs+Game, see the section called “Game Configuration”) until reaching the bottom. The two small black rectangles under the main one are the tile's “shadow” which show where it will land. You can toggle the tile's shadow in the section called “Game Configuration”.
On the right hand side, the Next tile box shows what the next tile to fall will be, if you have enabled it in the section called “Game Configuration”.
KFoulEggs Configuration and Default Keybindings
The KFoulEggs configuration is accessed from Settings->Configure KFoulEggs. The options are as follows:
- Initial Level
Set the level which you will play at startup, from 1 (easiest) to 20 (hardest). Default is level one.
- 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.
- Block Size
Sets the size of the falling blocks.
- Enable animations
If checked, pieces gluing are shown with an animation.
- Fade Strength
Controls the fade balance between the desktop background and the KFoulEggs background. A setting of zero makes the KFoulEggs background completely transparent, and a setting of one makes the KFoulEggs background completely opaque.
- Fade Colour
Displays a dialog allowing you to choose the colour of the KFoulEggs background.
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
KFoulEggs supports two local multiplayer types - Human vs. Human and Human vs. Computer. To play either of these, select it from the Multiplayers menu.
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.
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.
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.
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.
Tip
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
- Game->New (Ctrl+N)
Starts a new game.
- Game->Pause (P)
Pauses the game
- Game->Show High Scores... (H)
Displays the high scores.
- Game->Quit (Ctrl+Q)
Quits KFoulEggs
- 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.
- Settings->Show Menubar (Ctrl+M)
Shows or hides the Menubar.To return the menubar, right-click anywhere on the gameboard and select Show Menubar.
- Settings->Configure Key Bindings
Displays a standard KDE key bindings configurator.
- Settings->Configure KFoulEggs
Displays/changes the KFoulEggs configuration.
- Settings->Configure AI...
Displays the KFoulEggs AI Configurator
- Help->Contents... (F1)
Invokes the KDE Help system starting at the KFoulEggs help pages. (this document).
- Help->What's This? (Shift+F1)
Changes the mouse cursor to a combination arrow and question mark. Clicking on items within KFoulEggs will open a help window (if one exists for the particular item) explaining the item's function.
- Help->Report Bug...
Opens the Bug report dialog where you can report a bug or request a “wishlist” feature.
- Help->About KFoulEggs
This will display version and author information.
- Help->About KDE
This displays the KDE version and other basic information.
Credits and License
KFoulEggs
Program core engine copyright 1995 Eirik End <>
Program copyright 1996-2001 Nicolas Hadacek <hadacek@kde.org>
Documentation copyright 2000, 2001, Philip Rodrigues <phil.rod@ntlworld.com>
This documentation is licensed under the terms of the GNU Free Documentation License.
This program is licensed under the terms of the GNU General Public License.
Installation
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.
In order to compile and install KFoulEggs on your system, type the following in the base directory of the KFoulEggs distribution:
% ./configure % make % make install
Since KFoulEggs uses autoconf and automake you should have no trouble compiling it. Should you run into problems please report them to the KDE mailing lists.
Should you run into problems please report them to the KDE mailing list, or the program maintainer, Nicolas Hadacek, at <hadacek@kde.org>.