# Manuale di &ksirk;

## Introduzione

&ksirk; è la versione computerizzata di un famoso gioco di strategia. Esistono una versione commerciale e una libera ma io (Gaël de Chalendar) ho creato questo gioco inizialmente come esercizio per imparare il C++ e poi l'ho sviluppato fino a questo punto (vedi `README` per i dettagli).

Ecco una schermata di &ksirk;. Schermata

Alla versione attuale, &ksirk; è un gioco con funzionalità di rete per più di un giocatore, con una IA di base. (vedi `TODO` per i dettagli)

Questa documentazione fornisce le principali informazioni necessarie per iniziare a giocare. Leggi i suggerimenti e i messaggi della barra di stato per completare le informazioni.

Lo scopo del gioco è semplicemente conquistare il mondo... Lo otterrai attaccando i tuoi vicini con i tuoi eserciti. Pacifista, no? :-)

## Usare &ksirk;

### Giocare a &ksirk;

Nota preliminare - si può navigare la mappa in tre modi:

- puoi portare il puntatore del mouse vicino a uno dei bordi della finestra e la mappa si muoverà in quella direzione;

- puoi usare la rotella del mouse: senza modificatori, muoverà la mappa verticalmente; se premi il tasto &Alt;, si muoverà orizzontalmente;

- puoi usare le frecce della tastiera.

#### Iniziare una partita

Quando &ksirk; si avvia, ti accoglie con il menu principale.

Il menu principale di &ksirk; Menu principale

Nuova partita locale

- Avvia una nuova partita.

Nuova partita su rete standard TCP/IP

- Avvia una nuova partita con i protocolli di Internet.

Partecipa a partita su rete standard TCP/IP

- Entra in una nuova partita creata da un altro utente con i protocolli di Internet.

Carica...

- Usa questo comando per caricare una partita precedentemente salvata.

Esci

- Magari alla fine non vuoi giocare?

Se fai clic su Nuova partita locale, si aprirà la finestra Proprietà della nuova partita dove potrai scegliere il numero di giocatori, il tema da usare, il tipo di partita (conquista o per obiettivi) e infine se giocare la partita in rete o localmente. I nuovi temi si possono scaricare con il pulsante Scarica nuovi temi....

Finestra di nuova partita Finestra di nuova partita

Per avviare una partita in rete TCP/IP, seleziona l'opzione Nuova partita su rete standard TCP/IP sullo schermo introduttivo. Dopo aver premuto questo pulsante, potrai impostare i parametri di rete: numero di giocatori locali e porta TCP su cui aspettare connessioni.

Finestra dei parametri di rete Finestra dei parametri di rete

A quel punto i giocatori in rete potranno connettersi selezionando Partecipa a partita su rete standard TCP/IP nel menu principale e indicando l'IP o l'hostname dell'ospite e il numero della porta che hai precedentemente selezionato.

Finestra di partecipazione a partita in rete Finestra di partecipazione a partita in rete

Ogni connessione è indicata da una nuova riga nella tabella Giocatori sotto la miniatura della mappa.

Riga di nuovo giocatore Riga di nuovo giocatore

Immaginiamo tu mantenga tutte le impostazioni predefinite e selezioni Successivo. Allora imposterai due giocatori, uno dopo l'altro. Per ciascuno dovrai scegliere un nome, una nazionalità e, se vuoi, impostare una password in modo che nessun altro possa utilizzare questo giocatore caricando il salvataggio della partita. Infine puoi scegliere se questo giocatore sarà guidato dal computer o da un essere umano.

Finestra delle impostazioni dei giocatori Finestra delle impostazioni dei giocatori

Quindi, dopo premuto Avvia, se scegli di giocare per obiettivi, l'obiettivo di ogni giocatore locale sarà mostrato preceduto da un messaggio di avviso che consiglia di non far vedere l'obiettivo agli altri giocatori vicino al computer.

Messaggio di avviso Mostra obiettivo Messaggio di avviso Mostra obiettivo Finestra Mostra obiettivo Finestra Mostra obiettivo

#### Distribuzione

All'inizio del gioco, gli stati sono distribuiti a tutti i giocatori. All'inizio ogni stato contiene un'armata (rappresentata da un soldato di fanteria). Ogni giocatore possiede alcune armate da distribuire ai suoi stati nel suo turno (indicato dalla presenza del suo nome e della sua bandiera nella barra di stato). Nota che cinque armate sono rappresentate da un soldato di cavalleria, e dieci da un cannone.

Per mettere un'armata in uno dei tuoi stati, fai clic col &LMB;. Per rimuovere un'armata, fai clic col &RMB;. Nota, come regola generale, che non potrai mai rimuovere un numero di armate superiore a quelle che hai già disposto.

Posizionamento armate Posizionamento armate

Quando un giocatore ha distribuito tutte le proprie armate, il giocatore successivo è selezionato automaticamente per svolgere la stessa procedura. Quando tutti i giocatori avranno finito di distribuire le proprie armate, si potrà scegliere tra due possibilità tramite due pulsanti nel pannello di destra:

Ridistribuzione Ricicla

- Un giocatore vuole cambiare alcune delle sue scelte. Il primo giocatore può quindi rimuovere un'armata che ha messo in uno stato col &RMB;, e metterla in un altro col &LMB;. Quando termina, passa il controllo al giocatore successivo con il pulsante Convalida. Quando tutti i giocatori hanno finito la ridistribuzione, i due pulsanti sono visualizzati di nuovo.

Fine della ridistribuzione Fatto

- La ridistribuzione è terminata e il gioco può continuare.

#### Combatti

Dopo la ridistribuzione, inizia il turno. Ogni giocatore gioca a turno. Può scegliere di:

Prossimo giocatore Prossimo giocatore

- Finisce il turno dell'attuale giocatore e tocca al successivo.

Attacca 1 Attacca 2 Attacca 3 Attacca con una, due o tre armate Attacco automatico Attacco automatico

- Per attaccare trascina le armate dallo stato che attacca a quello attaccato. Ti sarà mostrato un menu contestuale con le seguenti voci.

  Menu Attacco Menu Attacco

  Affinché lo stato X possa attaccare lo stato Y con x armate, devono essere soddisfatte due condizioni:

  - i due stati devono confinare;

  - lo stato X deve avere almeno x+1 armate prima dell'attacco.

  Se l'attacco è valido, viene mostrata al difensore una finestra che chiede se vuole difendere con una o due armate o lasciar decidere al computer.

  Dopo la scelta del difensore avrà luogo la battaglia. Quest'ultimo è descritto in seguito.

  Finestra di difesa Finestra di difesa

Muovi armate Muove le armate da uno stato ad un altro

- Questa è l'ultima azione del turno di un giocatore. Dà la possibilità di muovere alcune armate da uno dei propri stati a un altro, confinante con il primo. Per scegliere i due paesi, fai clic e trascina come per un attacco. Quando entrambe le nazioni sono selezionate, appare un cursore con cui scegliere quante armate vorrai avere in ogni stato.

#### Esito del combattimento

Per ogni armata coinvolta si lancerà un dado. Il giocatore che otterrà il numero maggiore sul dado, sia esso l'attaccante o il difensore, vince e quello con il numero più basso perde un numero di armate basato sul numero di dadi lanciati.

Riepilogo attacco Riepilogo attacco

Se il numero delle armate nello stato del difensore raggiunge lo 0, lo stato diventa di proprietà dell'attaccante: viene impostata la sua bandiera e una delle sue armate si installa nel suo nuovo stato. Viene allora mostrato il cursore «Muovi armate» come alla fine del turno.

Cursore invasione Cursore invasione

#### Fine del turno

Per concludere il turno attuale, se non vuoi muovere armate, puoi fare clic sul pulsante Prossimo giocatore nella barra degli strumenti.

Quando tutti hanno giocato, la mano finisce. Vengono distribuite alcune armate ai giocatori, a seconda degli stati che possiedono: 1 per ogni gruppo di stati, con un minimo di tre. Inoltre c'è un bonus per i giocatori che possiedono un intero continente, ognuno differente. I valori dei bonus per il tema attuale sono:

#### Bonus per i continenti

Continente | Bonus
Nord America | 5
Sud America | 2
Europa | 5
Africa | 3
Asia | 7
Area del Pacifico | 2

Quando un giocatore termina di distribuire le proprie armate, fa clic su Convalida per permettere al giocatore seguente di distribuire le sue armate bonus. Come per la distribuzione iniziale, quando tutti i giocatori hanno disposto tutte le loro armate, possono iniziare un ulteriore giro di ridistribuzione o iniziare una nuova mano...

## Guida ai Comandi

### La finestra principale di &ksirk;

#### I pulsanti

Esci Esci

- Fa terminare il programma.

Nuova partita Nuova partita

- Inizia un nuovo gioco. Verrà visualizzata una finestra dove inserire il numero di giocatori. Dopodiché, verrà chiesto il nome di ogni giocatore in un'altra finestra.

## Guida degli sviluppatori di &ksirk;

Si prega di fare riferimento a https://api.kde.org/, la documentazione di KDoc per le API. Era piuttosto completa, ma è attualmente un po' datata. Non ci sono commenti nei file di implementazione `.cpp`.

Nota che ho sviluppato originariamente questo gioco in &Windows; con Borland C++ e WinG. L'ho portato in &Java; per poi riconvertirlo in C++ e &kde;. All'inizio ho usato il francese o un misto di francese e inglese per nominare gli identificatori (classi, metodi, membri, &etc;). Ho anche usato il francese per i commenti. Quando ho deciso di distribuire questo gioco, ho scelto di convertirlo tutto in inglese... ma chiaramente non sono un madrelingua: per piacere suggeriscimi oppure fai e invia le correzioni, ai commenti del codice o a questa documentazione.

## Creare nuovi temi

&ksirk; include un editor di temi, chiamato `ksirkskineditor`, che permette di modificare tutti i dati dei temi, basta che la grafica (mappa, sprite, ecc.) sia disponibile in formato &SVG;. Vedi il manuale di &i18n-ksirkskineditor; per maggiori dettagli.

## Domande e Risposte

&reporting.bugs; &updating.documentation;

## Riconoscimenti e licenza

&ksirk;

Copyright del programma 2002-2012 di Gaël de Chalendar kleag@free.fr

Copyright del programma 2013 di Nemanja Hirsl nemhirsl@gmail.com

Contributi di: Robin Doer, &Albert.Astals.Cid;, Michal Golunski (traduzione in polacco).

Copyright della documentazione 2002-2008 Gaël de Chalendar kleag@free.fr

Traduzione: Valter Mura valtermura@gmail.com

Traduzione: Vincenzo Reale smart2128vr@gmail.com

Traduzione: Federico Zenith federico.zenith@member.fsf.org, Dario Panico e Martino Barbon

&underFDL; &underGPL;

## Installazione

### Configurazione

L'elemento di menu Impostazioni Configura &ksirk;... apre una finestra che permette di:

Finestra delle preferenze Finestra delle preferenze

- abilita o disabilita i suoni:

- imposta la velocità delle entità (da lenta a immediata):

- abilita o disabilita l'aiuto contestuale mostrato nelle finestre a comparsa:

- mostra o nasconde il numero di armate per stato. La schermata seguente mostra la mappa quando il numero di armate è visualizzato.

  Mostra il numero di armate Mostra il numero di armate

&documentation.index;