# The &ksame; Handbook

## Introduction

&ksame; is a simple game. It is played by one player, so there is only one winner :-) You play for fun and against the high score. It has been inspired by SameGame, which is only really famous on the Macintosh.

In 1997 Stephan Kulow and Marcus Kreutzberger wrote Probiere (a German pun). It was their first attempt to write a X11 application. They decided that it would be a good idea to port it to KDE, and here we are.

## Using &ksame;

A very simple premise. There are a bunch of marbles. Get rid of them all. ;-)

You can erase same marbles when they are connected vertically or horizontally when you click them. If there are pieces over the erased ones, they will drop down. If all of the pieces on the vertical line are erased, all pieces on the right side will slide to the left.

The score is calculated as follows:

Subtract 2 from the number of marbles erased, and square the result.

As an example, if you erase 7 balls, then you get 25 points (7 minus 2 = 5. 5 squared is 25 points).If you erase 8 balls, then you get 36 points (8 minus 2 = 6. 6 squared is 36 points.

Get as many of the same pieces as you can, and then erase them in one click. That way you will get a higher score. The game is over when there are no pieces that can be erased.

The score will then be decreased according to the number of remaining pieces. If you erase all pieces 1,000 bonus points will be added to the final score.

### More &ksame; features

&ksame; is wonderful in that it will allow you to kill 5 minutes while you wait for that program to compile.

Or, if nothing else, it will allow you to kill 5 minutes.

## Command Reference

### The main &ksame; window

There is a large area with lots of marbles. Underneath is the status bar. Above is the menu bar.

#### The Game Menu

&Ctrl;N Game New

- Starts a new game.

&Ctrl;H Game Show highscore

- Displays the high score table

&Ctrl;Q Game Quit

- Quits &ksame;

#### The Edit Menu

&Ctrl;Z Edit Undo

- This will undo the last move.

#### The Settings Menu

Settings Random Board

- Nothing. Leave it on, otherwise it just brings up a blank window.

#### The Help Menu

&help.menu.documentation;

## Credits and License

&ksame;

Program copyright 1997 Marcus Kreutzberger kreutzbe@informatik.mu-luebeck.de

Contributors:

- Stephen Kulow

Documentation copyright 2000 Nicholas R. Robbins logik9000@home.com

&underFDL; &underGPL;

## Installation

### How to obtain &ksame;

&install.intro.documentation;

### Requirements

In order to successfully use &ksame;, you need &kde; 3.0. Or at least the kdelibs package.

### Compilation and Installation

&install.compile.documentation;
&documentation.index;