# Manuale di &kappname;

Gaël Kleag de Chalendar

    Kleag@free.fr

Federico Zenith

    federico.zenith@member.fsf.org

Manutenzione della traduzione
Dario Panico Traduzione in italiano
Martino Barbon Traduzione in italiano
2002-2008 Gaël de Chalendar
&FDLNotice;
18/09/2008
4.1.2

&kappname; è 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).

Alla versione attuale, &kappname; è 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. Un capitolo spiega come creare nuovi temi per &kappname;

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

KDE giochi kde gioco strategia Risiko libero GPL Rete IA

## Introduzione

&kappname; è 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 &kappname;.

Schermata

Alla versione attuale, &kappname; è 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 &kappname;

### Giocare a &kappname;

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 &kappname; si avvia, ti accoglie con il menu principale. Il menu principale di &kappname;

Menu principale

Nuova partita

  Avvia una nuova partita

Partecipa

  Permette di partecipare a una partita in rete

Carica

  Usa questo per caricare una partita precedentemente salvata

Esci

  Magari alla fine non vuoi giocare?

Se fai clic su Nuova partita, ti si aprirà la finestra di dialogo Proprietà 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. Finestra di dialogo Nuova partita

Finestra di dialogo Nuova partita

Per avviare una partita in rete, seleziona la casella Partita in rete sulla destra della casella numerica del numero dei giocatori. Dopo aver fatto clic su Ok, potrai impostare i parametri di rete: numero di giocatori in rete e porta TCP su cui aspettare connessioni. Finestra di dialogo Parametri di rete

Finestra di dialogo Parametri di rete

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

Finestra di dialogo Partecipa a partita in rete

Ogni connessione è indicata dal messaggio nella barra di stato. Messaggio di connessione

Messaggio di connessione

Immaginiamo tu mantenga tutte le impostazioni predefinite e selezioni Ok. 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 di dialogo Impostazioni giocatore

Finestra di dialogo Impostazioni giocatore

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. Finestra di dialogo Mostra obiettivo

Finestra di dialogo Mostra obiettivo
Messaggio di avviso Mostra obiettivo
Messaggio di avviso 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 con il pulsante sinistro del mouse. Per rimuovere un'armata, fai clic con il tasto destro. 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 con il tasto destro del mouse, e metterla in un altro con il tasto sinistro. 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:

Giocatore Successivo
Giocatore Successivo

  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 di attacco

  Menu di attacco
  Affinché uno stato X attacchi uno stato Y con x armate, due condizioni devono essere verificate:

  - 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 di dialogo 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 dialogo Difesa

  Finestra di dialogo 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 ad 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.

#### Risoluzione 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...

#### Inviare messaggi agli altri giocatori

Se vuoi comunicare con gli altri giocatori in una partita in locale, beh, parla (a meno che tu non abbia problemi di accessibilità)... Ma se stai partecipando ad una partita in rete, puoi usare lo spazio di chat sul fondo della finestra (può essere nascosto o mostrato usando le frecce). Inserisci il tuo messaggio e premi &Enter;. Inviare messaggi

Inviare messaggi

## Guida ai Comandi

### La finestra principale di &kappname;

#### I pulsanti

Esci
Esci

  Fa terminare il programma.

Nuova partita
Nuova partita

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

## Guida degli Sviluppatori di &kappname;

Si prega di fare riferimento a http://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

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

## Domande e Risposte

&reporting.bugs; &updating.documentation;

## Riconoscimenti e licenza

&kappname;

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

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 di Federico Zenithfederico.zenith@member.fsf.org, Dario Panico e Martino Barbon

&underFDL; &underGPL;

## Installazione

### Come ottenere &kappname;

&install.intro.documentation;

### Compilazione e installazione

&install.compile.documentation;

### Configurazione

La voce menu impostazioni apre una finestra di dialogo che ti permette di: Finestra di dialogo Preferenze

Finestra di dialogo 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;