# The &kfouleggs; Handbook

Philip
Rodrigues

    phil.rod@ntlworld.com

Nicolas
Hadacek

    hadacek@kde.org

Developer
Lauri
Watts

    lauri@kde.org

Reviewer
2000
2001
2002
Philip Rodrigues
&FDLNotice;
2002-01-08
2.00.12

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

&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 Game , 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.

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.

#### Appearance Configuration

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.

#### Highscore Configuration

Nickname

  Displays your current nickname and allows you to change it.

Comment

  A comment about yourself. You choose...

World-wide highscores enabled

  If checked, &kfouleggs; connects to the highscore webserver to view &kfouleggs; highscores from around the world.

### 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

&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 Multiplayers 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 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 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

#### The Help Menu

&help.menu.documentation;

## 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

&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 hadacek@kde.org.

&documentation.index;