<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
  <!ENTITY % English "INCLUDE" >
  <!ENTITY % addindex "IGNORE">
]>

<book id="kollision" lang="&language;">
<bookinfo>
        <title>The &kollision; Handbook</title>
<authorgroup>
        <author>
                <firstname>Paolo</firstname>
                <surname>Capriotti</surname>
                <affiliation>
                        <address><email>p.capriotti@gmail.com</email></address>
                </affiliation>
        </author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
<legalnotice>&FDLNotice;</legalnotice>

<date>2021-08-07</date>
<releaseinfo>0.3 (KDE Gear 21.08)</releaseinfo>
<abstract>
        <para>This documentation describes the game of &kollision; version 0.3</para>
</abstract>

<keywordset>
        <keyword>KDE</keyword>
        <keyword>kdegames</keyword>
        <keyword>game</keyword>
        <keyword>Kollision</keyword>
        <keyword>arcade</keyword>
        <keyword>one player</keyword>
</keywordset>
</bookinfo>
<chapter id="introduction"><title>Introduction</title>
        <note><title>Gametype:</title><para>Arcade</para></note>
        <note><title>Number of possible players:</title><para>One</para></note>
        <para>
	  A simple ball dodging game.
        </para>
</chapter>

<chapter id="howto"><title>How to play</title>
        <note><title>Objective:</title><para>Let the blue ball move in the field without touching the red balls.</para></note>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="gameboard.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>&kollision; Game Board</phrase>
</textobject>
</mediaobject>
</screenshot>

        <para>
Click on the empty field to start a game: a blue ball immediately replaces your mouse cursor, and a number of red balls start to fade into the field.
        </para>
        <para>
When the red balls finish materializing, they move at a random speed in a random direction, and you have to promptly dodge them moving the blue ball inside the field with your mouse.  After some time, other red balls will appear, fading in as before and then starting to move. Be prepared to avoid them, too.
        </para>
        <para>
You can choose the game difficulty level on the right of the status bar. The higher the difficulty level, the faster red balls move, and the more balls will appear on the play field.
        </para>
</chapter>

<chapter id="rules_and_tips"><title>Game Rules, Strategies and Tips</title>
        <para>Game Rules, Strategies and Tips</para>
        <sect1 id="rules"><title>Game Rules</title>
        <itemizedlist>
            <listitem><para>Red balls move with constant speed on the game field bouncing off walls until colliding with another ball, which causes the speed and direction of both balls to change.</para></listitem>
            <listitem><para>The blue ball can be freely moved inside the field with the mouse.</para></listitem>
            <listitem><para>The blue ball cannot escape the field. If the cursor is moved out, the ball stays on the edge, until the cursor returns.</para></listitem>
            <listitem><para>The score is directly proportional to the time the game has lasted.</para></listitem>
            <listitem><para>Pausing the game subtracts a (cumulative) 5 seconds penalty from the total time.</para></listitem>
        </itemizedlist>
        </sect1>
        <sect1 id="strattips"><title>Strategies and Tips</title>
        <itemizedlist>
            <listitem><para>Move the blue ball gently and slowly. Swinging across the field will make collisions with other balls more likely.</para></listitem>
            <listitem><para>Moving the cursor out of the field can be used as an elegant trick to come out of a screwed situation. Use it wisely.</para></listitem>
            <listitem><para>Do not pause the game unless absolutely necessary.</para></listitem>
        </itemizedlist>
        </sect1>
</chapter>


<chapter id="interface"><title>Interface Overview</title>

<sect1 id="menu">
<title>Menu Items</title>

<variablelist>

<varlistentry>
<term><menuchoice>
<guimenu>Game</guimenu>
<guimenuitem>End game</guimenuitem></menuchoice></term>
<listitem><para>End a game and return to the welcome screen.</para></listitem>
</varlistentry>

<varlistentry id="game-pause">
<term>
<menuchoice><shortcut>
<keycap>P</keycap></shortcut>
<guimenu>Game</guimenu>
<guimenuitem>Pause</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>Pauses or resumes the game.</action></para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">&Ctrl;<keycap>H</keycap></keycombo>
</shortcut>
<guimenu>Game</guimenu>
<guimenuitem>Show High Scores</guimenuitem></menuchoice></term>
<listitem><para>This will show the best scores for the current level.</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>Selecting this item will end your current game, and exit &kollision;.</para></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Play Sounds</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Toggle whether sound effects should be played.</action> The default is off.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Increase Ball Size</guimenuitem>
</menuchoice></term>
<listitem><para><action>Toggle to make the balls bigger.</action> The default is off.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Settings</guimenu>
<guisubmenu>Difficulty</guisubmenu></menuchoice></term>
<listitem><para>Allows you to select a difficulty <guilabel>Easy</guilabel>, <guilabel>Medium</guilabel>,
<guilabel>Hard</guilabel> for the game.</para></listitem>
</varlistentry>

</variablelist>

<para>
Additionally &kollision; has the common &kde; <guimenu>Settings</guimenu> and <guimenu>Help</guimenu>
menu items, for more information read the sections about the <ulink url="help:/fundamentals/menus.html#menus-settings"
>Settings Menu</ulink> and <ulink url="help:/fundamentals/menus.html#menus-help">Help Menu</ulink>
of the &kde; Fundamentals.
</para>

</sect1>

</chapter>

<chapter id="faq"><title>Frequently asked questions</title>
<qandaset>
<qandaentry>
 <question><para>I want to change the way this game looks. Can I? </para></question>
 <answer><para>No.</para></answer>
</qandaentry>
<qandaentry>
 <question><para>Can I use the keyboard to play the game? </para></question>
 <answer><para>No. &kollision; can only be played with a mouse.</para></answer>
</qandaentry>
<qandaentry>
 <question><para>I cannot figure out what to do here! Are there hints? </para></question>
 <answer><para>&kollision; does not have a <quote>Hint</quote> feature.</para></answer>
</qandaentry>
<qandaentry>
 <question><para>I have to quit the game now, but I am not finished yet. Can I save my progress?</para></question>
  <answer><para>You cannot save games in &kollision;.</para></answer>
</qandaentry>
</qandaset>
</chapter>

<chapter id="credits"><title>Credits and License</title>
<para>
&kollision;
</para>
<para>
Copyright 2007-2008 Paolo Capriotti <email>p.capriotti@gmail.com</email>
</para>
<para>
Copyright 2007-2008 Dmitri Suzdalev <email>dimsuz@gmail.com</email>
</para>
<para>
Documentation copyright 2008 Paolo Capriotti <email>p.capriotti@gmail.com</email>
</para>

<!-- TRANS:CREDIT_FOR_TRANSLATORS -->

&underFDL;
&underGPL;

</chapter>

&documentation.index;
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-omittag:t
sgml-shorttag:t
sgml-namecase-general:t
sgml-always-quote-attributes:t
sgml-indent-step:0
sgml-indent-data:nil
sgml-parent-document:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
