<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&ksnake;">
  <!ENTITY package "kdegames">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE">
]>

<book lang="&language;">
<bookinfo>
<title>The &ksnake; Handbook</title>
<authorgroup>
<author>
<firstname>Michel</firstname>
<surname>Filippi</surname>
</author>
</authorgroup>

<copyright>
<year>2000</year>
<holder>Michel Filippi</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<!-- TRANS:ROLES_OF_TRANSLATORS -->
<date>2003-09-17</date>
<releaseinfo>0.3.1</releaseinfo>

<abstract>
<para>
Snake Race 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!
</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>game</keyword>
<keyword>linux</keyword>
<keyword>race</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title>Introduction</title>

<para>
&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!
</para>

</chapter>

<chapter id="rules-of-the-game">
<title>Rules of the Game</title>

<sect1 id="to-win">
<title>To Win</title>

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

<itemizedlist>
<listitem>
<para>
Each apple you eat makes you grow longer.
</para>
</listitem>
<listitem>
<para>
If you hit a wall, you die.
</para>
</listitem>
<listitem>
<para>
If you hit yourself, you die.
</para>
</listitem>
<listitem>
<para>
If you are hit in the head by a bouncing ball, you die. 
</para>
</listitem>
<listitem>
<para>
If you take too long to eat the apples, more of them appear. 
</para>
</listitem>
</itemizedlist>

</sect1>

<sect1 id="scoring">
<title>Scoring</title>

<sect2>
<title>Before the timer has run out</title>


<para>
Before the timer has run out, you score:
</para>

<itemizedlist>
<listitem>
<para>
1 point for a red apple + a bonus depending on your skill level. 
</para>
</listitem>
<listitem>
<para>
5 points for a gold apple + a bonus for your skill level + 2 points for each
computer snake + 2 points for each bouncing ball.
</para>
</listitem>
<listitem>
<para>
Twice your level number when you exit the room + a bonus depending on your skill
level. 
</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title>After the timer has run out</title>

<para>
After the timer has run out, you score:
</para>

<itemizedlist>
<listitem>
<para>
1 point for a red apple.
</para>
</listitem>
<listitem>
<para>
2 points for a gold apple. 
</para>
</listitem>
<listitem>
<para>
Points equal to your level number when you exit the room + a bonus depending on
your skill level. 
</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title>When the computer snake eats an object</title>

<para>
When the computer snake eats an object you lose:
</para>

<itemizedlist>
<listitem>
<para>
2 points for a red apple. 
</para>
</listitem>
<listitem>
<para>
5 points for a gold apple. 
</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title>Other points</title>

<para>
You score 20 points for killing a computer snake.
</para>

</sect2>

</sect1>
</chapter>

<chapter id="customization">
<title>Customization</title>

<sect1 id="create-your-own-levels">
<title>Create Your Own Levels</title>

<para>
To create your own level, copy one of the levels from <filename
class="directory">$<envar>KDEDIR</envar>/share/apps/ksnake/levels</filename> to
<filename
class="directory">$<envar>HOME</envar>/.kde/share/apps/ksnake</filename> and
edit it with a bitmap editor. You can then select it in
<menuchoice><guimenu>Options</guimenu> <guimenuitem>Starting room</guimenuitem>
</menuchoice>.
</para>

</sect1>

</chapter>

<chapter id="menu-reference">
<title>Menu Reference</title>

<sect1 id="game-menu">
<title>The <guimenu>Game</guimenu> Menu</title>

<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
</shortcut>
<guimenu>Game</guimenu>
<guimenuitem>New</guimenuitem>
</menuchoice></term>
<listitem>
<para>Start a new game</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>P</keycap>
</shortcut>
<guimenu>Game</guimenu>
<guimenuitem>Pause</guimenuitem>
</menuchoice></term>
<listitem>
<para>Pause the game.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>H</keycap></keycombo>
</shortcut>
<guimenu>Game</guimenu>
<guimenuitem>Show Highscores...</guimenuitem>
</menuchoice></term>
<listitem>
<para>Show the High Score dialog.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
</shortcut>
<guimenu>Game</guimenu>
<guimenuitem>Quit</guimenuitem>
</menuchoice></term>
<listitem>
<para>Quits &kappname;.</para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="settings-menu">
<title>The <guimenu>Settings</guimenu> Menu</title>

<variablelist>
<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Beginner</guimenuitem></menuchoice></term><term>
<menuchoice><guimenu>Settings</guimenu>
<guimenuitem>Intermediate</guimenuitem>
</menuchoice>
</term><term>
<menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Advanced</guimenuitem>
</menuchoice></term><term>
<menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Expert</guimenuitem>
</menuchoice></term>
<listitem>
<para>Choose the difficulty level of the game. The
default is <guimenuitem>Intermediate</guimenuitem></para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Settings</guimenu>
<guisubmenu>Balls</guisubmenu></menuchoice>
</term>
<listitem>
<para>Choose how many balls are in play. You can
choose between <guimenuitem>0</guimenuitem>,
<guimenuitem>1</guimenuitem>, <guimenuitem>2</guimenuitem>, or
<guimenuitem>3</guimenuitem>.  The default is one ball.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Settings</guimenu>
<guisubmenu>Balls AI</guisubmenu></menuchoice>
</term>
<listitem>
<para>Select how dangerous the balls are.  You can
choose between <guimenuitem>Dumb</guimenuitem> where the balls show no
intelligence,
<guimenuitem>Killer</guimenuitem>, where the balls try to chase you,
and <guimenuitem>Default</guimenuitem>, which is somewhere in
between.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Settings</guimenu>
<guisubmenu>Snakes</guisubmenu></menuchoice></term>
<listitem><para>Choose how many computer snakes are playing
against you. You can choose from <guimenuitem>0</guimenuitem>,
<guimenuitem>1</guimenuitem>, <guimenuitem>2</guimenuitem>, or
<guimenuitem>3</guimenuitem>.  The default is three snakes.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Settings</guimenu>
<guisubmenu>Snakes AI</guisubmenu></menuchoice></term>
<listitem>
<para>Choose how the snakes act.  The default is
<guimenuitem>Eater</guimenuitem>, where the snakes will try to eat the
apples before you can get to them.  You could also choose
<guimenuitem>Random</guimenuitem>, where the snakes act randomly, or
you could choose <guimenuitem>Killer</guimenuitem> where the computer
snakes try to kill your snake.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Settings</guimenu>
<guisubmenu>Select Background Color</guisubmenu>
</menuchoice></term>
<listitem>
<para>Change the color of the playing area.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Settings</guimenu>
<guisubmenu>Select Background Pixmap</guisubmenu></menuchoice></term>
<listitem>
<para>Choose from several provided pictures as a background,
in place of a single color.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Settings</guimenu>
<guimenuitem>Change Keys...</guimenuitem>
</menuchoice></term>
<listitem>
<para>Customize the keys you use to maneuver your
snake.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Settings</guimenu>
<guimenuitem>Starting Room...</guimenuitem></menuchoice>
</term>
<listitem><para>Select the level you would like to start the
game from. You don't have to replay the early levels if you
are feeling particularly skillful, you can skip ahead to the more
challenging ones.  &ksnake; comes with 25 levels, and you can create
more of your own.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Settings</guimenu>
<guimenuitem>Configure Shortcuts...</guimenuitem></menuchoice>
</term>
<listitem><para>Select this to open a dialog which lets you define shortcuts
for all menu items in &ksnake;.</para></listitem>
</varlistentry>
</variablelist>
</sect1>
</chapter>






<chapter id="credits-and-licenses">
<title>Credits and Licenses</title>

<para>
&ksnake; copyright 2000, Michel Filippi
</para>

<para>
Documentation copyright 2000, Michel Filippi and Robert Williams.
</para>

<!-- TRANS:CREDIT_FOR_TRANSLATORS -->

&underFDL;
&underGPL;

</chapter>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->
