Warning, /games/kapman/doc/index.docbook is written in an unsupported language. File is not indexed.

0001 <?xml version="1.0" ?>
0002 <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
0003   <!ENTITY % addindex "IGNORE">
0004   <!ENTITY % English "INCLUDE">
0005 ]>
0006 
0007 <book id="kapman" lang="&language;">
0008 <bookinfo>
0009 <title>The &kapman; Handbook</title>
0010 
0011 <authorgroup>
0012 <author>
0013 <personname>
0014 <firstname>Thomas</firstname>
0015 <surname>Gallinari</surname>
0016 </personname>
0017 <email>tg8187@yahoo.fr</email>
0018 </author>
0019 <!-- TRANS:ROLES_OF_TRANSLATORS -->
0020 </authorgroup>
0021 
0022 <copyright>
0023 <year>2008</year>
0024 <holder>Thomas Gallinari</holder>
0025 </copyright>
0026 <legalnotice>&FDLNotice;</legalnotice>
0027 
0028 <date>2021-06-04</date>
0029 <releaseinfo>KDE Gear 21.04</releaseinfo>
0030 
0031 <abstract>
0032 <para>&kapman; is a clone of the well known game <application>Pac-Man</application>.</para>
0033 </abstract>
0034 
0035 <keywordset>
0036 <keyword>KDE</keyword>
0037 <keyword>kdegames</keyword>
0038 <keyword>Kapman</keyword>
0039 <keyword>arcade</keyword>
0040 <keyword>one player</keyword>
0041 <keyword>pac-man</keyword>
0042 <keyword>pacman</keyword>
0043 <keyword>ghost</keyword>
0044 <keyword>pill</keyword>
0045 <keyword>energizer</keyword>
0046 </keywordset>
0047 
0048 </bookinfo>
0049 
0050 <chapter id="introduction">
0051 <title>Introduction</title>
0052 <note><title>Gametype:</title><para>Arcade</para></note>
0053 <note><title>Number of possible players:</title><para>One</para></note>
0054 <para>
0055 &kapman; is a clone of the well known game <application>Pac-Man</application>. You must go through the levels escaping ghosts in a maze. You lose a life when a ghost eats you, but you can eat the ghosts for a few seconds when eating an energizer. You win points when eating pills, energizers, and bonus, and you win one life for each 10,000 points. When you have eaten all the pills and energizers of a level, you go to the next level, and the player and ghost speeds increase. The game ends when you have lost all your lives.
0056 </para>
0057 <screenshot>
0058 <screeninfo>A &kapman; screenshot</screeninfo>
0059 <mediaobject>
0060 <imageobject>
0061 <imagedata fileref="kapman.png" format="PNG"/>
0062 </imageobject>
0063 <textobject>
0064 <phrase>A &kapman; screenshot</phrase>
0065 </textobject>
0066 </mediaobject>
0067 </screenshot>
0068 </chapter>
0069 
0070 <chapter id="howto">
0071 <title>How to Play</title>
0072 <note><title>Objective:</title><para>Go through the levels by eating all pills and energizers.</para></note>
0073 <para>
0074 &kapman; will load level one once you start the game. To start the game, press an arrow key. You move straight ahead without pressing any key. To turn, press an arrow key. You should not turn at the last moment, but anticipate and you will turn as soon as possible. To eat a pill, an energizer, a bonus, or even a ghost, you must get in touch with it. When all the pills and energizers have been eaten, you move to the next level.
0075 </para>
0076 </chapter>
0077 
0078 <chapter id="rules_and_tips"><title>Game Rules, Strategies and Tips</title>
0079 <sect1 id="rules">
0080 <title>Rules</title>
0081 <para>
0082 <itemizedlist>
0083 <listitem><para>To move to the next level, you must eat every pill and energizer in the maze.</para></listitem>
0084 <listitem><para>A bonus appears when you have eaten 1/3 and 2/3 of the pills and energizers. It disappears after a few seconds (10 seconds at the first level, but it decreases as the level increases) if you have not eaten it.</para></listitem>
0085 <listitem><para>As the level increases, both your speed and the ghosts speed increase. However, the ghosts will be more and more faster than you.</para></listitem>
0086 <listitem><para>If you get in touch with a ghost, you lose a life, and the current level restarts (but the eaten pills and energizer do not reappear).</para></listitem>
0087 <listitem><para>If you are in the line of sight of a ghost (that is to say : no wall between the ghost, and both of you go to the same direction), the ghost will hunt you. Otherwise, the ghosts have a random moving.</para></listitem>
0088 <listitem><para>When you eat an energizer, the ghosts slow down and you can eat them. If you eat a ghost, it goes back to its home and its normal behaviour. After a few seconds (10 seconds at the first level, but it decreases as the level increases), the ghosts that have not been eaten go back to their normal behaviour.</para></listitem>
0089 <listitem><para>You win points when eating an item:</para>
0090 <table>
0091 <title>Item values</title>
0092 <tgroup cols="2">
0093 <tbody>
0094 <row>
0095 <entry>Pill</entry>
0096 <entry>10 points</entry>
0097 </row>
0098 <row>
0099 <entry>Energizer</entry>
0100 <entry>20 points</entry>
0101 </row>
0102 <row>
0103 <entry>Bonus</entry>
0104 <entry>Current level * 100 points</entry>
0105 </row>
0106 <row>
0107 <entry>Ghost</entry>
0108 <entry>It depends on the number of ghosts you have eaten since the last energizer was eaten:
0109 <itemizedlist>
0110 <listitem><para>1st ghost: 100 points</para></listitem>
0111 <listitem><para>2nd ghost: 200 points</para></listitem>
0112 <listitem><para>3rd ghost: 400 points</para></listitem>
0113 <listitem><para>4th ghost: 800 points</para></listitem>
0114 </itemizedlist>
0115 </entry>
0116 </row>
0117 </tbody>
0118 </tgroup>
0119 </table>
0120 </listitem>
0121 <listitem><para>You get a life more every 10,000 points you win.</para></listitem>
0122 </itemizedlist>
0123 </para>
0124 </sect1>
0125 
0126 <sect1 id="tips">
0127 <title>Strategies and Tips</title>
0128 <para>
0129 <itemizedlist>
0130 <listitem><para>To eat an item, you must get it touch with its center, not only a few pixels. So be sure you have really eaten what you wanted, before turning back.</para></listitem>
0131 <listitem><para>At first levels, the bonus does not make a lot of points and ghosts are not very fast, so you should concentrate on eating the most ghosts that you can.</para></listitem>
0132 <listitem><para>After about ten levels, the ghosts are faster and the bonus makes more points, so you should try to eat the bonus when possible. Do not hesitate to eat an energizer when you can see the bonus, to not be disturbed by the ghosts.</para></listitem>
0133 <listitem><para>In the same way, you should try to eat an energizer before going to the dangerous places (like near the ghost home).</para></listitem>
0134 <listitem><para>When the ghosts are too fast, you should avoid to eat them if you are near their home. They could go back faster than you think.</para></listitem>
0135 <listitem><para>Do not hesitate to stay in the same place for a few seconds, waiting for the ghosts to go far away from the place you need to go.</para></listitem>
0136 <listitem><para>You can find cheatcodes from the source code. But be careful: if you make a new high score but have cheated, your high score will not be registered.</para></listitem>
0137 <listitem><para>Last but not least: Have fun !</para></listitem>
0138 </itemizedlist>
0139 </para>
0140 </sect1>
0141 </chapter>
0142 
0143 <chapter id="interface"><title>Interface Overview</title>
0144 <sect1 id="menu">
0145 <title>Menu Items</title>
0146 
0147 <variablelist>
0148 <varlistentry>
0149 <term><menuchoice>
0150 <shortcut><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></shortcut>
0151 <guimenu>Game</guimenu><guimenuitem>New</guimenuitem>
0152 </menuchoice></term>
0153 <listitem><para><action>Starts a new game.</action></para></listitem>
0154 </varlistentry>
0155 <varlistentry>
0156 <term><menuchoice>
0157 <shortcut><keycombo action="simul">&Ctrl;<keycap>H</keycap></keycombo></shortcut>
0158 <guimenu>Game</guimenu><guimenuitem>Show High Scores</guimenuitem>
0159 </menuchoice></term>
0160 <listitem><para><action>Brings up the high scores dialog.</action></para></listitem>
0161 </varlistentry>
0162 <varlistentry>
0163 <term><menuchoice>
0164 <guimenu>Game</guimenu><guimenuitem>Change Level</guimenuitem>
0165 </menuchoice></term>
0166 <listitem><para><action>Brings up the level selection dialog. Be careful: changing the current level will make the game consider you as a cheater, so you will not able to register in the high scores table.</action></para></listitem>
0167 </varlistentry>
0168 <varlistentry>
0169 <term><menuchoice>
0170 <shortcut><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></shortcut>
0171 <guimenu>Game</guimenu><guimenuitem>Quit</guimenuitem>
0172 </menuchoice></term>
0173 <listitem><para><action>Quits</action> &kapman;.</para></listitem>
0174 </varlistentry>
0175 
0176 <varlistentry>
0177 <term><menuchoice>
0178 <guimenu>Settings</guimenu><guimenuitem>Play Sounds</guimenuitem>
0179 </menuchoice></term>
0180 <listitem><para><action>Plays the sounds or mutes.</action></para></listitem>
0181 </varlistentry>
0182 
0183 <varlistentry>
0184 <term><menuchoice>
0185 <guimenu>Settings</guimenu><guisubmenu>Difficulty</guisubmenu>
0186 </menuchoice></term>
0187 <listitem>
0188 <para><action>Adjusts the game difficulty to <guimenuitem>Easy</guimenuitem>,
0189 <guimenuitem>Medium</guimenuitem> or <guimenuitem>Hard</guimenuitem>.</action></para>
0190 </listitem>
0191 </varlistentry>
0192 </variablelist>
0193 <para>
0194 Additionally &kapman; has the common &kde; <guimenu>Settings</guimenu> and <guimenu>Help</guimenu>
0195 menu items, for more information read the sections about the <ulink url="help:/fundamentals/menus.html#menus-settings"
0196 >Settings Menu</ulink> and <ulink url="help:/fundamentals/menus.html#menus-help">Help Menu</ulink>
0197 of the &kde; Fundamentals.
0198 </para>
0199 </sect1>
0200 
0201 <sect1 id="keybindings">
0202 <title>Default Keybindings</title>
0203 <para>
0204 <itemizedlist>
0205 <listitem><para><action>Turn up</action> - &Up; arrow</para></listitem>
0206 <listitem><para><action>Turn down</action> - &Down; arrow</para></listitem>
0207 <listitem><para><action>Turn right</action> - &Right; arrow</para></listitem>
0208 <listitem><para><action>Turn left</action> - &Left; arrow</para></listitem>
0209 <listitem><para><action>Pause</action> - <keycap>P</keycap> or &Esc;</para></listitem>
0210 </itemizedlist>
0211 </para>
0212 </sect1>
0213 </chapter>
0214 
0215 <chapter id="faq">
0216 <title>Questions and Answers</title>
0217 
0218 <qandaset id="faqlist">
0219 <qandaentry>
0220 <question>
0221 <para>I want to change the way this game looks. Can I?</para>
0222 </question>
0223 <answer>
0224 <para>You can select the &kapman; theme in the <menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure &kapman;...</guimenuitem></menuchoice> dialog. See the <link linkend="configuration">Game Configuration</link> chapter for more details.</para>
0225 </answer>
0226 </qandaentry>
0227 <qandaentry>
0228 <question>
0229 <para>Can I skip a level?</para>
0230 </question>
0231 <answer>
0232 <para>There are two ways to change the current level. In both cases, you will be considered as a cheater and you will not be able to register to the high scores. The first way is using a cheatcode. I let you find it. The other way is selecting the level you want from the <menuchoice><guimenu>Game</guimenu><guimenuitem>Change Level</guimenuitem></menuchoice> dialog. See the <link linkend="menu">Menubar</link> section for more details.</para>
0233 </answer>
0234 </qandaentry>
0235 <qandaentry>
0236 <question>
0237 <para>Can I change default keyboard shortcuts?</para>
0238 </question>
0239 <answer>
0240 <para>It is not possible for now. But will be a new feature in a future version of &kapman;. See the <link linkend="keybindings">Default Keybindings</link> section for more details.</para>
0241 </answer>
0242 </qandaentry>
0243 <qandaentry>
0244 <question>
0245 <para>I have to quit the game now, but I am not finished yet. Can I save my progress?</para>
0246 </question>
0247 <answer>
0248 <para>You can not, and it is deliberate. We think that the game would be too easy if you could save the game and reload it as you lose your lives.</para>
0249 </answer>
0250 </qandaentry>
0251 <qandaentry>
0252 <question>
0253 <para>How can I get more lives?</para>
0254 </question>
0255 <answer>
0256 <para>There are two ways to get lives. The first one is using a cheatcode. I let you find it. The other way is winning points. Every 10,000 points, you get a life more. See the <link linkend="rules">Rules</link> section for more details.</para>
0257 </answer>
0258 </qandaentry>
0259 </qandaset>
0260 </chapter>
0261 
0262 <chapter id="configuration"><title>Game Configuration</title>
0263 <para>
0264         You can select the theme you want to play &kapman;. To do that, select <menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure &kapman;...</guimenuitem></menuchoice>. The &kapman; configuration dialog (see below) appears and you can then select the theme. It is immediately changed on validating your choice, no need to restart the game. You can click on the <guibutton>Defaults</guibutton> button to restore the default theme.
0265 </para>
0266 <screenshot>
0267 <screeninfo>The &kapman; configuration dialog</screeninfo>
0268 <mediaobject>
0269 <imageobject>
0270 <imagedata fileref="config.png" format="PNG"/>
0271 </imageobject>
0272 <textobject>
0273 <phrase>The &kapman; configuration dialog</phrase>
0274 </textobject>
0275 </mediaobject>
0276 </screenshot>
0277 </chapter>
0278 
0279 <chapter id="credits"><title>Credits and License</title>
0280 <para>
0281 &kapman;
0282 </para>
0283 <para>
0284 Program copyright 2008 Thomas Gallinari <email>tg8187@yahoo.fr</email>
0285 </para>
0286 <para>
0287 Program copyright 2008 Pierre-Benoit Besse <email>besse.pb@gmail.com</email>
0288 </para>
0289 <para>
0290 Program copyright 2008 Alexandre Galinier <email>blluetroy@hotmail.com</email>
0291 </para>
0292 <para>
0293 Program copyright 2008 Nathalie Liesse <email>nathalie.liesse@gmail.com</email>
0294 </para>
0295 <para>
0296 Graphics copyright 2008 Thomas Gallinari <email>tg8187@yahoo.fr</email>
0297 </para>
0298 <para>
0299 Documentation copyright 2008 Thomas Gallinari <email>tg8187@yahoo.fr</email>
0300 </para>
0301 <!-- TRANS:CREDIT_FOR_TRANSLATORS -->
0302 &underFDL;
0303 &underGPL;
0304 
0305 </chapter>
0306 
0307 &documentation.index;
0308 
0309 </book>
0310 
0311 <!--
0312 Local Variables:
0313 mode: xml
0314 sgml-minimize-attributes:nil
0315 sgml-general-insert-case:lower
0316 sgml-indent-step:0
0317 sgml-indent-data:nil
0318 End:
0319 
0320 vim:tabstop=2:shiftwidth=2:expandtab
0321 kate: space-indent on; indent-width 2; tab-width 2; indent-mode none;
0322 -->