Het handboek van KsirK. Gael Kleag de Chalendar Nemanja Hirsl Vertaler/Nalezer: Freek de Kruijf Vertaler: Ronald Stroethoff

Transcriptie

1 Gael Kleag de Chalendar Nemanja Hirsl Vertaler/Nalezer: Freek de Kruijf Vertaler: Ronald Stroethoff

2 2

3 Inhoudsopgave 1 Inleiding 6 2 KsirK gebruiken KsirK spelen Een spel starten Distributie Vechten Uitkomst van het gevecht Einde van de beurt Overzicht van de opdrachten Het hoofdvenster van KsirK De knoppen Gids voor ontwikkelaars van KsirK 17 5 Nieuwe skins aanmaken 18 6 Vragen en antwoorden 19 7 Dankbetuiging en licentie 20 A Installatie 21 A.1 Hoe KsirK te verkrijgen A.2 Compilatie en installatie A.3 Configuratie

4 Lijst van tabellen 2.1 Bonuspunten voor continenten

5 Samenvatting KsirK is een gecomputeriseerde versie van een bekend strategiespel. Er bestaan commerciële en andere Free Software versies maar ik (Gaël de Chalendar) creëerde aanvankelijk dit spel als een C++ oefening en daarom heb ik het tot hier ontwikkeld (zie de README voor meer details). In de huidige versie kunt u met KsirK over een netwerk spelen en heeft het kunstmatige intelligentie. (zie de TODO voor meer details) Deze handleiding geeft de belangrijkste informatie die u nodig heeft om te kunnen starten met het spel. Lees de hulpballonnen en de berichten in de statusbalk voor extra informatie. Een hoofdstuk geeft uitleg hoe u nieuwe skins voor KsirK kunt creëren. 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 :-)

6 Hoofdstuk 1 Inleiding KsirK is een gecomputeriseerde versie van een bekend strategiespel. Er bestaan commerciële en andere Free Software versies maar ik (Gaël de Chalendar) creëerde aanvankelijk dit spel als een C++ oefening en daarom heb ik het tot hier ontwikkeld (zie de README voor meer details). In de huidige versie kunt u met KsirK over een netwerk spelen en heeft het kunstmatige intelligentie. (zie de TODO voor meer details) Deze handleiding geeft alleen de belangrijkste informatie die u nodig heeft om te kunnen starten met het spel. Lees de hulpballonnen en de berichten in de statusbalk voor extra informatie. 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? :-) 6

7 Hoofdstuk 2 KsirK gebruiken 2.1 KsirK spelen Opmerking vooraf : u kunt de kaart op drie manieren verschuiven: U kunt uw muis vlakbij de rand van het venster plaatsen en het uitzicht zal zich vervolgens over de kaart in die richting verplaatsen U kunt uw muiswiel gebruiken: zonder sneltoetsen, zal verticaal verschuiven; met de Alt-toets ingedrukt, zal het horizontaal verschuiven U kunt de pijltjestoetsen van het toetsenbord gebruiken Een spel starten Wanneer KsirK start krijgt u een hoofdmenu. 7

8 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 Deelnemen aan een spel die door een andere speler is opgestart door gebruik van het Internet protocol suite. Laden Gebruik dit om een eerder opgeslagen spel te laden Afsluiten Misschien wilt u eindelijk stoppen met spelen? Als u op Nieuw lokaal spel drukt dan krijgt u het dialoog Nieuw spel eigenschappen te zien waar u het aantal spelers, het te gebruiken skin (of thema), het speltype (het doel veroveren of een speciaal doel bereiken ) kunt instellen en tenslotte of u het spel met online spelers of puur lokaal wilt spelen. Via de knop Nieuwe skins downloaden kunt u nieuwe skins downloaden. Voor het starten van een TCP/IP netwerkspel, kiest u de optie Nieuw Standaard TCP/IP Netwerkspel in het introductie scherm. Na klikken op deze knop, kunt u de netwerk parameters instellen: aantal lokale spelers en de TCP poort waarop u wacht op verbindingen. 8

9 Vervolgens kunnen netwerspelers een verbinding maken door Deelnemen aan een standaard TCP/IP Netwerkspel op het introductie scherm te kiezen waarna ze de IP of hostnaam en het poortnummer dat u net heeft ingesteld moeten opgeven. Voor elke verbinding krijgt u een nieuwe rij te zien in de tabel met Spelers onder de kaartvoorbeeld. 9

10 Laten we aannemen dat u de standaard-instellingen gebruikt en op de knop Volgende heeft gedrukt. U zal dan twee spelers instellen, de een na de ander. Voor elke kiest u een naam, een nationaliteit en, als u dat wilt, een paswoord zodat bij het opnieuw laden van een opgeslagen spel niemand anders deze speler kan gebruiken. Tenslotte moet u opgeven of het een computer dan wel een menselijke speler is. Vervolgens zal na het klikken op Start, als u heeft gekozen om met een doel te spelen, het doel van elke speler worden getoond, voorafgegaan door een waarschuwing zodat andere spelers die op dezelfde computer meekijken tijdens het tonen van het doel discreet de andere kant uit kunnen kijken. 10

11 2.1.2 Distributie Bij het begin van het spel worden de landen verdeelt over alle spelers. Bij de start heeft elk land een leger (voorgesteld door een infanterist). Elke speler heeft daarnaast nog enkele legers die hij (als hij aan de beurt is) kan verdelen over zijn landen (aangegeven door hun naam en bijbehorende vlag in de statusbalk). Merk op dat een cavalerist vijf legers voorstelt en een kanon 10 legers. Om een leger in een van uw landen te plaatsen, klikt u erop met de linkermuisknop. Om een leger te verwijderen, klikt u erop met de rechtermuisknop, Als algemene regel geldt dat u nooit meer legers kunt verwijderen dan dat u heeft geplaatst. 11

12 Als een speler al zijn legers heeft verdeelt, dan is de volgende speler automatisch geselecteerd om dezelfde taak uit te voeren. Als alle spelers klaar zijn met het verdelen van hun legers, zijn er twee mogelijkheden die u kunt selecteren via twee knoppen op het rechter paneel: Recycleren Een speler wilt enkele van zijn keuzes wijzigen. De eerste speler kan dan een leger dat hij juist in een land heeft geplaatst weer met de rechtermuisknop verwijderen en het in een ander land met de linkermuisknop weer plaatsen. Als hij klaar is, dan geeft hij de controle aan de volgende speler met de knop Geldig. Als alle spelers klaar zijn met hun herverdeling, dan komen de twee knoppen weer zichtbaar. Gereed Het opnieuw verdelen is gereed en het spel kan verdergaan Vechten Na het herverdelen, start het spel. Elke speler mag spelen als hij aan de beurt is. Hij heeft de keuze uit: Volgende speler De beurt van de huidige speler eindigt en de volgende komt aan de beurt. Aanval met een, twee of drie legers Auto-aanval Om aan te vallen, sleept u met de muis van het aanvallende land en laat het los op het aangevallen land. U krijgt dan een contextmenu met de bovengenoemde items. 12

13 Om een land X het land Y te laten aanvallen met x legers, moeten 2 condities voldaan zijn: de twee landen moeten buren zijn; land X moet voor de aanval tenminste x+1 legers hebben. Als de aanval geldig is, dan krijgt de verdediger indien nodig een dialoog te zien waarin hij kan kiezen of hij met een of twee legers wilt verdedigen dan wel dat hij de computer laat beslissen. Als de keuze voor de verdediging is gemaakt, dan zal gevecht losbarsten en weer tot een einde komen. Zoals hieronder beschreven. Verplaatst legers van een land naar een andere land 13

14 Dit is het laatste wat een speler in een beurt kan doen. Het geeft de mogelijkheid om enkele legers van het ene land naar een andere land te verplaatsen, dat naast het eerste land moet liggen. Voor het kiezen van de twee landen, gebruikt u het verslepen en loslaten op dezelfde manier als u dat met een aanval doet. Nadat u beide landen heeft geselecteerd, krijgt u een schuifknop te zien waarmee u een keuze kan maken hoeveel legers daarna in elk land zijn Uitkomst van het gevecht Voor elk vechtend leger is een bijbehorende sterfte kans. De speler die een hoger getal op de dobbelsteen trekt, onafhankelijk of het de aanvaller of de verdediger is, wint en diegene die een kleiner getal trekt verliest legers overeenkomstig het getrokken getal op de dobbelsteen. Als het aantal legers van het verdedigend land 0 wordt, dan gaat het land over naar de aanvaller: zijn vlag wordt daar gehesen en een van de aanvallende legers zal in zijn nieuwe land worden geïnstalleerd. De schuifknop voor Leger verplaatsen is weer te zien voor de verplaatsingen aan het eind van de beurt. 14

15 2.1.5 Einde van de beurt Om een eind te maken aan uw beurt, als u geen legers meer wilt verplaatsen, dan kan u op de knop Volgende Speler in de werkbalk drukken. Als iedereen aan de beurt is geweest en de speelronde is voltooid, worden enkele legers verdeelt over de spelers, afhankelijk van de landen die ze bezitten: 1 voor elke groep van drie landen, met een minimum van 3. Spelers die een compleet continent bezitten krijgen een bonus, die voor elk continent verschillend is. De bonuspunten voor de standaard skin zijn: Continent Bonus Noord Amerika 5 Zuid-Amerika 2 Europa 5 Afrika 3 Azië 7 Pacific Gebied 2 Tabel 2.1: Bonuspunten voor continenten Als een speler klaar is met het verdelen van zijn legers, dan klikt hij op de knop Geldig zodat de volgende speler zijn bonus-legers kan verdelen. Na de eerste distributie, als alle spelers hun legers hebben geplaatst, kunnen ze een nieuwe herverdeling-ronde of een nieuwe speelronde starten... 15

16 Hoofdstuk 3 Overzicht van de opdrachten 3.1 Het hoofdvenster van KsirK De knoppen Afsluiten Zal het programma afsluiten. Nieuw spel Start een nieuw spel. Het opent een dialoog waarin u het aantal spelers kan instellen. In een volgend dialoog kunnen alle spelers hun naam invoeren. 16

17 Hoofdstuk 4 Gids voor ontwikkelaars van KsirK Ga naar voor de documentatie van de API. Het was vrij compleet maar het kan op dit moment een beetje verouderd zijn. Er is geen commentaar aanwezig in de.cpp bronbestanden. Vergeet niet dat ik dit spel eerst onder Windows met Borland C++ en WinG heb ontwikkelt. Ik zette het vervolgens over naar Java voordat ik het weer terug zette naar C++ en KDE. In het begin gebruikte ik een mix van Frans of een mix van Frans en Engels voor de namen van identifiers (classnames, methods, members, etc.). Ik gebruikte ook Frans voor de comments. Toen ik besloot om dit spel te verspreiden, besloot ik om alles om te zetten naar het Engels... maar ik ben duidelijk geen geboren spreker van Engels: geef a.u.b. suggesties of maak en en geef correcties, voor het commentaar in de code of voor deze documentatie. 17

18 Hoofdstuk 5 Nieuwe skins aanmaken KsirK komt met een skin-editor, genaamd ksirkskineditor(!), waarmee u alle skin data kan bewerken, zodra illustraties (kaart, sprites, etc.) beschikbaar zijn in een SVG-bestand. Lees de handleiding van de ksirkskineditor voor meer informatie. 18

19 Hoofdstuk 6 Vragen en antwoorden Problemen en suggesties kunnen op de website gemeld worden. Deze handleiding kan inmiddels vernieuwd zijn. De meest recente versie van het handboek van KsirK is te vinden op 19

20 Hoofdstuk 7 Dankbetuiging en licentie KsirK Programma copyright Gael de Chalendar kleag@free.fr Auteursrecht programma 2013 Nemanja Hirsl nemhirsl@gmail.com Medewerkers: Robin Doer, Albert Astals Cid, Michal Golunski (Poolse vertaling). Documentatie copyright Gael de Chalendar kleag@free.fr Op- of aanmerkingen over de vertalingen van de toepassing en haar documentatie kunt u melden op Dit document is vertaald in het Nederlands door Freek de Kruijf freekdekruijf@kde.nl. Dit document is vertaald in het Nederlands door Ronald Stroethoff stroet43@zonnet.nl. Deze documentatie valt onder de bepalingen van de GNU vrije-documentatie-licentie. Deze toepassing valt onder de bepalingen van de GNU General Public License. 20

21 Bijlage A Installatie A.1 Hoe KsirK te verkrijgen KsirK is een onderdeel van het KDE-project KsirK is een onderdeel van de module kdegames. Deze module kunt u vinden op de FTP-site van het KDE-project: ftp://ftp.kde.org/pub/kde/. A.2 Compilatie en installatie Er zijn een aantal stappen nodig om KsirK op uw systeem te compileren en te installeren. Voer de volgende commando s uit in de hoofdmap van de broncode van KsirK: %./ configure % make % make install Aangezien KsirK autoconf en automake gebruikt, zouden er bij de compilatie geen problemen mogen voorkomen. Indien u toch problemen tegenkomt, meldt u ze dan in de betreffende KD inglists. A.3 Configuratie Het menu Instellingen opent een dialoog waarin u : 21

22 het geluid in-/uitschakelen ; de snelheid van de sprites instellen (van langzaam tot onmiddellijk) ; de in popups getoonde contexthelp in-/uitschakelen ; indien ingeschakeld wordt het aantal legers voor elk land getoond. De volgende schermafdruk toont de kaart met daarin zichtbaar het aantal legers. 22