# The &ksnake; Handbook

## Introduction

&ksnake; is a game of speed and agility. You are a hungry snake and are trying to eat all the apples in the room before getting out!

## Rules of the Game

### To Win

To win &ksnake; you must eat all the apples in the room and leave through the exit that opens at the top.

- Each apple you eat makes you grow longer.

- If you hit a wall, you die.

- If you hit yourself, you die.

- If you are hit in the head by a bouncing ball, you die.

- If you take too long to eat the apples, more of them appear.

### Scoring

#### Before the timer has run out

Before the timer has run out, you score:

- 1 point for a red apple + a bonus depending on your skill level.

- 5 points for a gold apple + a bonus for your skill level + 2 points for each computer snake + 2 points for each bouncing ball.

- Twice your level number when you exit the room + a bonus depending on your skill level.

#### After the timer has run out

After the timer has run out, you score:

- 1 point for a red apple.

- 2 points for a gold apple.

- Points equal to your level number when you exit the room + a bonus depending on your skill level.

#### When the computer snake eats an object

When the computer snake eats an object you lose:

- 2 points for a red apple.

- 5 points for a gold apple.

#### Other points

You score 20 points for killing a computer snake.

## Customization

### Create Your Own Levels

To create your own level, copy one of the levels from `$`KDEDIR`/share/apps/ksnake/levels` to `$`HOME`/.kde/share/apps/ksnake` and edit it with a bitmap editor. You can then select it in Settings Configure &ksnake;... in the First Level tab.

## Menu Reference

### The Game Menu

&Ctrl;N Game New

- Start a new game

P Game Pause

- Pause the game.

&Ctrl;H Game Show Highscores...

- Show the High Score dialog.

&Ctrl;Q Game Quit

- Quits &kappname;.

### The Settings Menu

Settings Show Statusbar

- Shows or hides the &ksnake; status bar at the bottom of the screen.

Settings Configure Shortcuts...

- Select this to open a dialog which lets you define shortcuts for all menu items in &ksnake;.

Settings Configure &ksnake;...

- Opens the &ksnake; configuration dialog to change &ksnake; settings.

  On the General tab you can set the speed of snakes, choose the number of snakes and balls and their behaviour.

  Select a background color or an image on the Appearance tab.

  Choose a starting level from 1 to 25 on the First Level tab.

### The Help Menu

&help.menu.documentation;

## Credits and Licenses

&ksnake; copyright 2000, Michel Filippi

Documentation copyright 2000, Michel Filippi and Robert Williams.

&underFDL; &underGPL;