]>

# The KShisen-Sho Handbook

Dirk
Doerflinger

    ddoerflinger@web.de

15/05/2000
1.03.00

This Handbook describes &kshisen; Version 1.3

KDE
kdegames
KShisen
game
shisen-sho

## Introduction

&kshisen; is a single-player-game similar to Mahjongg and uses the same set of tiles as Mahjongg.

The object of the game is to remove all tiles from the field.

## Installation

### How to obtain Shisen-Sho

&kshisen; is written for the KDE project http://www.kde.org by Mario Weilguni mweilguni@sime.com.

&kshisen; can be found in the package kdegames on ftp://ftp.kde.org/pub/kde/, the main ftp site of the KDE project.

### Requirements

In order to successfully compile &kshisen;, you need KDE 2.0 All required libraries as well as &kshisen; itself can be found on ftp://ftp.kde.org/pub/kde/.

### Compilation and installation

In order to compile and install &kshisen on your system, extract the package and type the following in the base directory of the &kshisen; distribution:

    % ./configure
    % make
    % make install

Since Shisen-Sho uses autoconf and automake you should have not trouble compiling it.

## Playing &kshisen;

### Rules

The aim of the game is to remove all tiles from the board. Only two matching tiles can be removed at a time. Two tiles can only be removed if they can be connected with a maximum of three connected lines. Lines can be horizontal or vertical, but not diagonal.

You don't have to draw the lines by yourself, the game does this for you. Just mark two matching tiles on the board, if they can be connected with a maximum of three lines, the lines will be drawn and the tiles are removed.

Remember that lines only may cross the empty border. If you are stuck, you can use the Hint feature to find two tiles which may be removed. Clicking a tile with the right mouse button will show you all corresponding tiles, no matter if they are removable at the moment or not.

The game is over if no moves are possible and some tiles are left on the board (this should not happen if the option No unsolvable games in the Option menu is checked, since for these games there is at least one way to solve it, though it may happen that you choose the wrong way).

### The Game-Menu

The menu Game lets you control the status of the current game, as there are:

CtrlZ Game Undo

  Undo the last step. Same does the back button in the Toolbar.

CtrlD Game Redo

  Redo the last step. Same does the forward button in the toolbar.

CtrlH Game Get Hint

  Show a tip, which two tiles to remove next

CtrlN Game New Game

  Finish the actual game set and start a new session with new tiles.

CtrlR Game Restart Game

  Restart the current game with the same tiles.

Game Pause Game

  Pauses the entire game, especially the timer which is needed for the high score. The menu-entry then turns to Resume Game , which is used for resuming the game.

Game Is game solvable?

  Shows a Dialog which tells you, whether the game is solvable or not. If the menu-entry Disallow unsolvable games in the Options menu is checked, this Box is absolutely useless.

Game Hall of fame

  Shows the (local) Top-Ten-charts of Shisen-Sho.

Some of the menu items can also be controlled by hot-keys. See the section for a list.

## Configuration

### The Options-Menu

&kshisen; has several possibilities to change its behavior. All options can be changed from the menu Options.

The options will be saved automatically.

Options Size

  In the sub-menu Size you can change the number of tiles on the board. The more tiles you have, the harder (and longer) the game will be.

Options Speed

  The sub-menu Speed sets the time for the tiles to disappear when connected correctly.

Options Level

  Choose your game skill in the sub-menu Level.

Options Gravity

  Checking this item makes the game even harder: If a tile is removed, all tiles lying above it will fall down one step.

Options Disallow unsolvable games

  If this menu-item is checked, only solvable games will be created when a new game is started. Note: You may still choose the wrong way and have to try again if you didn't solve the game, but if it's checked, the game will be solvable.

### Key Bindings

Default key bindings are:

- Quit: CtrlQ
- Undo: CtrlZ
- Redo: CtrlD
- New Game: CtrlN
- Restart Game: CtrlR
- Help: F1
- What's this?: ShiftF1

## Credits and License

&kshisen; Copyright 1999 Mario Weilguni mweilguni@sime.com

Documentation Copyright 2000 Dirk Doerflinger ddoerflinger@gmx.net

This program is licensed under the terms of the GNU GPL.