# The &kfouleggs; Handbook

## Introduction

&kfouleggs; is a clone of the Japanese PuyoPuyo game, with advanced features such as multiplayer games against human or AI. 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 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 shortcuts can be customized by selecting Configure Shortcuts... 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

- Shows the number of removed 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 game-config) 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 game-config.

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

## &kfouleggs; Configuration and Default Shortcuts

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

Enable animations

- If checked, pieces are shown with an animation (a small rebound effect), when they touch the bottom.

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.

Background

- Select the color and the opacity for &kfouleggs; background. An opacity of zero makes the &kfouleggs; background completely transparent, and a setting of one makes the &kfouleggs; background completely opaque.

#### Colors Configuration

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

#### A.I. Configuration

Here you can configure the A.I. in &kfouleggs;.

### Configuring Highscores

The configuration is accessed from Settings Configure Highscores.... The options are as follows:

#### The Main Tab

Nickname:

- Displays your current nickname and allows you to change it.

Comment

- A comment about yourself. You choose...

World-wide highscores enabled

- If checked and if you are connected to the Internet, &kfouleggs; will send your score automatically at the end of the game to the highscore web server (kfouleggs.sf.net).

#### The Advanced Tab

This tab displays your Registration Data on kfouleggs.sf.net:

Nickname:

- Displays your current nickname from the Main tab.

Key:

- This key was generated when you registered on kfouleggs.sf.net by selecting World-wide highscores enabled the first time. The registration key is used in conjunction with the nickname to identify uniquely users, but users cannot have the same nickname. Click on the Remove button to delete you from the world highscores list.

### Default Shortcuts

The default shortcuts for &kfouleggs; in all player modes are as follows:

New | &Ctrl;N
Pause | P
Quit | &Ctrl;Q
Zoom In | &Ctrl;+
Zoom Out | &Ctrl;-
Show Highscores | &Ctrl;H
Show Menubar | &Ctrl;M
&kfouleggs; Handbook | F1
What's This? | &Shift;F1

The default shortcuts for &kfouleggs; in one-player mode are as follows:

Rotate Left | Up Arrow
Rotate Right | Return
Move Left | Left Arrow
Move Right | Right Arrow
Move to Left Column | &Ctrl;Left Arrow
Move to Right Column | &Ctrl;Right Arrow
Drop Down | Down Arrow

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

#### 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, Puyos and Level indicator. The keys for the first human player become, by default:

Rotate Left | E
Rotate Right | C
Move Left | F
Move Right | G
Move to Left Column | &Shift;F
Move to Right Column | &Shift;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.

## Command Reference

### The Main &kfouleggs; window

#### The Game Menu

&Ctrl;N Game New

- Starts a new game.

P Game Pause

- Pauses or resumes the game

&Ctrl;H Game Show Highscores

- Opens a dialog that displays different high score tables. Clicking on the links below the tables downloads world-wide scores.

&Ctrl;Q Game Quit

- Quits &kfouleggs;

#### The View Menu

&Ctrl;+ View Zoom In

- Enlarges the game board

&Ctrl;- View Zoom Out

- Reduces the game board size

#### 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 settings 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 high score configuration dialog, in which you can change several settings that affect how &kfouleggs; treats highscores.

Settings Configure &kfouleggs;...

- Displays 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;