# The &kfouleggs; Handbook

&Philip.Rodrigues; &Philip.Rodrigues.mail;
&Nicolas.Hadacek; &Nicolas.Hadacek.mail;
&Lauri.Watts; &Lauri.Watts.mail;
2000-2003 Philip Rodrigues
&FDLNotice;
2003-09-18
2.1.7

&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 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 disappear, 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

&kfouleggs; in Action
A quick explanation of what each of the parts of the game screen are for...

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... , see ) 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 .

On the right hand side, the Next tile box shows what the next tile to fall will be, if you have enabled it in .

## &kfouleggs; Configuration and Default Keybindings

### Configuring Gameplay

The &kfouleggs; configuration is accessed from Settings Configure KFoulEggs.... The options are as follows:

#### Game Configuration

Initial Level

  Set the level which you will play at startup, from 1 (easiest) to 20 (hardest). Default is level one.

Direct drop down

  If checked, pressing the Down Arrow will cause a tile to immediately fall to the bottom of the screen. If unchecked, pressing the Down Arrow only causes the piece to fall until the key is released.

#### Appearance Configuration

Block Size

  Sets the size of the falling blocks.

Enable animations

  If checked, pieces gluing are shown with an animation.

Show piece's shadow

  If checked, a shadow is placed beneath the game board showing where the piece will fall.

Show next piece

  If checked, shows the next tile that will fall onto the game board.

Show detailed "removed lines" field

  If checked, the Puyos counter on the left of the screen shows how many times each number of Puyos have been removed. If unchecked, just the total number removed is shown.

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 Color

  Displays a dialog allowing you to choose the color of the &kfouleggs; background.

#### Colors Configuration

Here you can select the colors used for the tiles in &kfouleggs;.

### 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 Multiplayer 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 Multiplayer and Single Human.

#### Network Multiplayer Games

Multiplayer network games are set up by selecting Multiplayer 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 Multiplayer 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

&Ctrl;N Game New

  Starts a new game.

P Game Pause

  Pauses the game

H Game Show High Scores...

  Displays the high scores.

&Ctrl;Q Game Quit

  Quits &kfouleggs;

#### The Multiplayer Menu

Multiplayer Single Human

  Sets the multiplayer mode to single player

Multiplayer Human vs Human

  Sets the multiplayer mode to two player with two human players.

Multiplayer Human vs Computer

  Sets the multiplayer mode to two player with one human and one computer player.

Multiplayer More...

  Displays the multiplayer options dialog.

#### The Settings Menu

&Ctrl;M Settings Show Menubar

  Shows or hides the Menubar.To return the menubar, right-click anywhere on the gameboard and select Show Menubar.

Settings Configure Shortcuts...

  Displays a standard &kde; key bindings configuration dialog to change the keyboard shortcuts for &kfouleggs;.

Settings Configure Notifications...

  Displays a standard &kde; notifications configuration dialog to change the audio and visual notifications for &kfouleggs;.

Settings Configure Highscores...

  Displays the highscore configuration dialog, in which you can change several settings that affect how &kfouleggs; treats highscores.

Settings Configure &kfouleggs;

  Displays/changes the &kfouleggs; configuration dialog.

#### The Help Menu

&help.menu.documentation;

## Credits and License

&kfouleggs;

Program core engine copyright 1995 Eirik End.

Program copyright 1996-2001 &Nicolas.Hadacek; &Nicolas.Hadacek.mail;.

Documentation copyright 2000-2003 &Philip.Rodrigues; &Philip.Rodrigues.mail;.

&underFDL; &underGPL;

## Installation

### How to obtain &kfouleggs;

&install.intro.documentation;

#### Compilation and Installation

&install.compile.documentation;

Should you run into problems please report them to the &kde; mailing list, or the program maintainer, &Nicolas.Hadacek;, at &Nicolas.Hadacek.mail;.

&documentation.index;