# Het handboek van &ksirk;

Gael Kleag de Chalendar

    Kleag@free.fr

Nemanja Hirsl

    nemhirsl@gmail.com

&ged.vertaald;&Freek.de.Kruijf;
2002-2012 Gael de Chalendar
2013 Nemanja Hirsl
&FDLNotice;
2013-02-17
4.10.0

&ksirk; is a computerized version of a well known strategy game. Commercial and other Free Software versions exist but I (Gaël de Chalendar) created this game initially as a C++ learning exercise and so, I developed it up to this point (see README for details).

In the current version, &ksirk; is a multi-player network-enabled game with an AI. (see TODO for details)

This documentation gives the major information you need to start playing. Please read the tooltips and the status bar messages to complete your information. A chapter explains how to create new skins for &ksirk;

Het doel van het spel is eenvoudig de wereld veroveren... Dit wordt gedaan door uw buren aan te vallen met uw legers. Vredig, vindt u niet :-)

KDE kdegames spel strategie Risk vrij GPL Netwerk AI

## Inleiding

&ksirk; is a computerized version of a well known strategy game. Commercial and other Free Software versions exist but I (Gaël de Chalendar) created this game initially as a C++ learning exercise and so, I developed it up to this point (see README for details).

Hier is een schermafdruk van &ksirk;

Schermafdruk

In the current version, &ksirk; is a multi-player network-enabled game with an AI. (see TODO for details)

This documentation gives only the major information you need to start playing. Please read the tooltips and the status bar messages to complete your information.

Het doel van het spel is eenvoudig de wereld veroveren... Dit wordt gedaan door uw buren aan te vallen met uw legers. Vredig, vindt u niet ? :-)

## &ksirk; gebruiken

### &ksirk; spelen

Preliminary note : the map can be scrolled by three methods:

- You can put your mouse near a border of the window and the map will scroll in that direction

- You can use your mouse wheel: with no modifier, it will scroll vertically; when pressing the &Alt; key, it will scroll horizontally

- You can use the keyboard arrows

#### Een spel starten

Wanneer &ksirk; start krijgt u een hoofdmenu. Het hoofdmenu van &ksirk;

Hoofdmenu

Nieuw lokaal spel

  Start een nieuw spel

&ksirk; spelen over het Jabber-netwerk

  &ksirk; spelen over Jabber. U moet eerst een Jabber-account registreren.

Nieuw standaard TCP/IP netwerkspel

  Begin een nieuw spel met de Internet protocol suite.

Deelnemen aan een standaard TCP/IP netwerkspel

  Join to the created by other user game using Internet protocol suite.

Laden

  Use this to load a previously saved game

Afsluiten

  Maybe you finally don't want to play?

If you hit New Local Game you will be presented with the New game properties dialog where you will be able to choose the number of players, the skin (or theme) to use, the game type (conquer the goal or have a specific goal) and finally if this game will be played with online players or if it is purely local. New skins can be downloaded using Download New Skins button. The New Game dialog

The New Game dialog

To start a TCP/IP network game, choose the New Standard TCP/IP Network Game option on introduction screen. After clicking this button you will be able to choose the network parameters: number of local players and TCP port on which waiting for connections. Network game parameters dialog

Network game parameters dialog

Then, network players will be able to connect by choosing Join Standard TCP/IP Network Game on the introduction screen and by indicating the IP or hostname of the host and the port number you just set. Joining network game dialog

Joining network game dialog

Each connection is indicated by a new row in the Players table below the map thumbnail. New player row

New player row

Let's suppose you keep all the default settings and hit Next. You will then setup two players, one after one. For each one, you'll choose a name, a nationality and, if you want, setup a password such that nobody else than you can reuse this player when reloading this saved game. Lastly, you will here specify if this player is played by the computer or by a human being. The Player Setup dialog

The Player Setup dialog

Then, after clicking Start, if you choose to play with goal, the goal of each local player is displayed, preceded by a warning such that other players looking at the same computer can discreetly turn away while the goal is being viewed. The Goal Display warning message

The Goal Display warning message
The Goal Display dialog
The Goal Display dialog

#### Distributie

At the beginning of the game, countries are distributed to all the players. Each country contains one army (represented by an infantryman) at the start. Each player has some armies to distribute to his countries at their turn (indicated by the presence of their name and their flag in the status bar). Note that five armies are represented by a cavalryman and 10 by a cannon.

To put an army on one of your countries, click on it with the left mouse button. To remove an army, click with the right button. Note, as a general rule, that you will never be able to remove more armies than the number you placed. Placing armies

Placing armies

When a player has distributed all there armies, the next player is automatically selected to do the same task. When all players have finished to distributing their armies, there is two possibilities that can be selected by two buttons showed in the right panel:

Redistribution
Recycleren

  One player wants to change some of his choices. The first player can then remove an army he just put in a country with the right mouse button and put it in another one with the left mouse button. When he finishes, he gives control to next player with the Valid button. When all players have finished their redistribution, the two buttons are displayed again.

End of redistribution
Gereed

  The redistribution is finished and the game can continue.

#### Fight

After the redistribution, a turn starts. Each player plays at his turn. He has the choice to:

Volgende speler
Volgende speler

  The turn of the current player finishes and it's the turn of the next one.

Aanval 1
Attack 2
Attack 3
Attack with one, two or three armies
Auto attack
Auto attack

  To attack, drag with the mouse from the attacking country and drop to the attacked one. You will then be presented with a contextual menu showing the above entries. Attack menu

  Attack menu
  For a country X to attack a country Y with x armies, 2 conditions must be fulfilled:

  - the two countries must be neighbors;

  - country X must have at least x+1 armies before the attack.

  If the attack is valid, a dialog is displayed if necessary for the defender to choose if he wants to defend with one or two armies or let the computer decide.

  When the defenders choice is done, the fight will occur and be completed. This will described below. Defense dialog

  Defense dialog
Legers verplaatsen
Move Armies from one country to another

  This is the last action of a player's turn. It gives the possibility to move some armies from one of his country to another, neighboring the first one. To choose the two countries, please drag and drop like you use during an attack. When both countries are selected, a slider is displayed on which you can choose how many armies there will be on each country afterwards.

#### Solution of the fight

For each army in the fight there is a corresponding die cast. The player who rolls a higher number on the dice, whether being from the attacker or defender, wins and the one to roll a smaller number on the dice loses armies according to the number of dice thrown. Attack result displayed

Attack result displayed

If the number of armies in the defender country reaches 0, the ownership of this country changes to the attacker: his flag is set up and one of his attacking armies is installed in his new country. The "Move armies" slider is displayed as for the moves of the end of the turn. Invasion slider

Invasion slider

#### End of the turn

To finish your current turn, if you don't want to move armies, you can hit the Next Player button in the toolbar.

When everybody has played, the turn is finished. Some armies are distributed to the players, in function of the countries they own: 1 for each group of three countries, with a minimum of 3. There is also a bonus for players that own a complete continent, different for each one. The values of the bonuses for the default skin are:

Bonus due to the continents

Continent | Bonus
--- | ---
Noord Amerika | 5
Zuid-Amerika | 2
Europa | 5
Afrika | 3
Azië | 7
Pacific Area | 2

When a player has finished distributing his armies, he clicks the Valid button to allow the next player to distribute his bonus armies. As for the initial distribution, when all player have placed their armies, they can start a new redistribution cycle or start a new turn...

## Overzicht van de opdrachten

### The main &ksirk; window

#### De knoppen

Quit Game
Afsluiten

  Causes the program to quit.

Nieuw spel
Nieuw spel

  Starts a new game. It will cause the displaying of a dialog asking the number of players. After that, each player will be asked its name with another dialog.

## Developer's Guide to &ksirk;

Please refer to http://api.kde.org/ for the documentation of the API. It was quite complete but is currently a little bit outdated. There are no comments in the `.cpp` implementation files.

Note that I originally developed this game under &Windows; with Borland C++ and WinG. I ported it to &Java; before converting back to C++ and &kde;. At the beginning I used French or a mix of French and English to name the identifiers (classnames, methods, members, &etc;). I also used French for the comments. When I decided to distribute this game, I decided to convert all to english... but I am clearly not a native English speaker: please suggest or make and submit corrections, to the code comments or to this documentation

## Creating new skins

&ksirk; comes with a skin editor, named ksirkskineditor(!), that allows to edit all skin data, as soon as graphics (map, sprites, &etc;) are available in a SVG file. Please see the ksirkskineditor manual for further details.

## Vragen en antwoorden

&reporting.bugs; &updating.documentation;

## Dankbetuiging en licentie

&ksirk;

Programma copyright 2002-2012 Gael de Chalendar kleag@free.fr

Program copyright 2013 Nemanja Hirsl nemhirsl@gmail.com

Medewerkers: Robin Doer, Albert Astals Cid, Michal Golunski (Poolse vertaling).

Documentatie copyright 2002-2008 Gael de Chalendar kleag@free.fr

&meld.fouten;&vertaling.freek; &underFDL; &underGPL;

## Installatie

### Hoe &ksirk; te verkrijgen

&install.intro.documentation;

### Compilatie en installatie

&install.compile.documentation;

### Configuratie

The settings menu entry opens a dialog that allows you to : Preferences dialog

Preferences dialog

- enable or disable the sounds ;

- set the speed of the sprites (from slow to immediate) ;

- enable or disable the contextual helps displayed in popups ;

- show or hide the number of armies on each country. The following snapshot shows the map when the number of armies are displayed. Display of the number of armies

  Display of the number of armies

&documentation.index;