# Manuale di &kajongg;

## Introduzione

### Tipo di gioco:

Da tavolo, arcade

### Numero di possibili giocatori:

Quattro

&kajongg; è un gioco da tavolo creato basandosi sul famoso gioco orientale del Mah Jong (dal Cinese 麻將). Viene giocato da quattro giocatori. Al mondo esistono molte e diverse regole in uso. Al momento &kajongg; supporta le regole classiche cinesi, come giocate in Germania; e seguiranno, eventualmente, altri importanti regole. È possibile personalizzare o aggiungere nuovi schemi di regole. Se lo fate, inviatele cortesemente all'autore del programma per l'integrazione!

&kajongg; può essere usato in due modi differenti: conteggio dei punti di una partita manuale, in cui giochi come tuo solito senza l'aiuto del computer e utilizzi &kajongg; per il conteggio e il mantenimento dei punti; oppure puoi usarlo per giocare contro qualsiasi combinazione di utenti umani e digitali.

## Aspetto della schermata

Schermata di &kajongg; Schermata

Una rapida spiegazione delle parti della schermata di gioco.

Barra degli strumenti

- La barra degli strumenti è posizionata sotto la barra dei menu e contiene i pulsanti per le azioni più utilizzate. Il contenuto della barra degli strumenti può essere modificata. Puoi anche renderla invisibile, dando più spazio al tavoliere.

  A seconda della dimensione del tuo schermo, potresti decidere di far scomparire la barra degli strumenti o di spostarla nel lato sinistro della finestra. Puoi eseguire il comando facendo clic col &RMB; sulla barra degli strumenti.

Tavoliere

- Il tavoliere è la sezione più ampia della finestra. Puoi vedere i quattro muri della lunghezza di 18 tessere (l'esatto numero dipende dalle regole come usare le tessere bonus o no). I nomi dei giocatori sono scritti sul muro, insieme con il valore corrente della mano (per quanto conosciuta) e le loro tessere di vento. Il vento prevalente ha uno sfondo colorato, Est nella schermata qui sopra.

  Quando si gioca, l'interno dei muri conserva le tessere scartate dai giocatori. Essi sono posizionate a caso. L'ultima tessera scartata è evidenziata con una cornice azzurra.

  Quando si conteggiano partite manuali, l'interno dei muri ha una selezione di tutte le tessere disponibili, il selettore centrale. Puoi assegnarle ai giocatori utilizzando il mouse o la tastiera.

Area del giocatore

- Ciascun giocatore ha un'area di schermata per le proprie tessere. La fila superiore contiene le tessere dichiarate, quella inferiore quelle coperte. Quando si conteggia manualmente una partita, le tessere coperte sono mostrate con un'ombra sopra l'intera tessera. Le tessere bonus vanno all'estrema destra.

Finestra di dialogo

- La finestra di dialogo mostra le scelte che ha il giocatore. Il più delle volte presenta un timer che indica una barra di avanzamento indicante il tempo rimanente.

Barra di stato

- La barra di stato è posizionata in basso nella schermata e contiene i totali correnti per i giocatori.

## Conteggio dei punti di una partita manuale

In questa modalità, &kajongg; viene utilizzato solo per eseguire il conteggio. giochi come al solito con persone vere in un tabellone vero, e alla fine della partita puoi inserire in &kajongg; le tessere che un giocatore ha in mano e qualsiasi altra informazione che &kajongg; necessita per calcolare i punteggi (che è quello che farà il programma). In alternativa, puoi calcolare manualmente i punteggi di mano e inserirli. &kajongg; eseguirà poi i pagamenti tra i giocatori e scriverà i risultati in una banca dati. È possibile interrompere una partita, avviarne una con altri giocatori e riprendere vecchie partite. Tutte le regole saranno salvate con le partite, perciò partite diverse possono essere giocate con regole diverse.

- Dal menu, seleziona Partita Conteggia partita manuale o premi &Ctrl;C.

- Ora puoi sia selezionare una partita esistente non terminata, sia iniziare una nuova partita. Se inizi una nuova partita, ti verranno chieste informazioni sui giocatori e sullo schema di gioco. &kajongg; proporrà gli stessi valori usati per la partita precedente. Se non esistono partite precedenti, proporrà i primi quattro giocatori definiti. Nota che non puoi modificare lo schema di gioco e qualsiasi altra sua regola dopo questa selezione. Puoi farlo anticipatamente nell'editor degli schemi.

- Ora otterrai una nuova finestra intitolata Punteggio per questa mano. Leggi Fare in modo che &kajongg; calcoli il punteggio per una descrizione dettagliata.

- Dopo aver salvato i risultati di mano, continua con la mano successiva.

### Inserire i risultati di mano

#### Punteggi

Schermata di &kajongg; Schermata

Questa è la finestra per l'inserimento dei risultato di mano. Viene mostrata automaticamente quando &kajongg; pensa che tu ne abbia bisogno. Puoi sempre visualizzarla o nasconderla premendo &Ctrl;S o selezionando la voce di menu corrispondente.

Come sempre, il vento prevalente ha lo sfondo colorato.

Qui puoi inserire manualmente i punteggi per tutti i giocatori. In alternativa puoi definire esattamente quali tessere aveva in mano un giocatore. Se scegli questa azione, il campo corrispondente per il punteggio manuale diverrà grigio. &kajongg; calcolerà automaticamente il punteggio.

Dopo aver inserito tutti i dati rilevanti per una mano, premi il pulsante Salva mano. I valori della mano saranno inseriti nella banca dati e anche mostrati nel tabellone del punteggio. Ti potrebbe essere chiesto di cambiare le posizioni dei giocatori, ma puoi scegliere anche di non cambiarle. I posti proposti sono al momento non personalizzabili: se uno schema di gioco necessita qualcosa di diverso, lo cambieremo.

Se il giocatore può aver vinto, sarà attivata la casella nella colonna Vincitore: facci clic sopra per il vincitore.

La barra di stato ora mostrerà il bilancio aggiornato per i giocatori, ed è possibile continuare con la mano successiva.

##### Inserire manualmente il punteggio

Un buon giocatore preferirà probabilmente calcolare il proprio punteggio da sé. In questo caso puoi inserire direttamente il punteggio. Questo non è possibile se non vi è alcuna tessera selezionata per il giocatore.

Se inserisci manualmente un punteggio, esso deve contenere tutto eccetto le penalità, e non vi saranno regole facoltative da cui scegliere. Esiste un'eccezione: Gioco pericoloso. Questo non influenza alcun punteggio, e non è neppure un'irregolarità. Significa solo che il pagamento tra i giocatori è diverso: il giocatore irregolare paga tutto per tutti al vincitore. Gli altri due giocatori non si scambiano pagamenti. Questa opzione al momento non è personalizzabile.

##### Far calcolare il punteggio a &kajongg;

Se indichi esplicitamente a &kajongg; quali tessere possiede un giocatore, l'inserimento dei punteggi in questa finestra saranno disattivati per quel giocatore. Durante l'associazione delle tessere a un giocatore noterai che il punteggio aumenta, ma non appena aggiungi la quattordicesima tessera il punteggio è riportato a zero. Questo può sorprendere ma, a meno di non dichiararla vincitrice, questa mano è riconosciuta come mano morta, che ha sempre zero punti. Questo comportamento è definito dallo schema di regole cinesi classiche, e può differire se cambi le regole o utilizzi uno schema di gioco diverso.

Puoi associare tessere e combinazioni a un giocatore utilizzando il mouse, la tastiera o entrambi. Col mouse basta trascinare e rilasciare le tessere nell'area del giocatore. Quando rilasci la tessera ti verrà chiesto cosa vuoi rilasciare: singolo, coppia, tris, poker, poker dichiarato o scala. La fila superiore è riservata alle tessere scoperte, mentre quella inferiore a quelle coperte. Le tessere bonus appariranno all'estrema destra. Puoi anche muovere le tessere e le combinazioni tra le righe, tra i giocatori o indietro al selettore centrale.

Se preferisci utilizzare la tastiera, puoi usare il tasto per spostarti tra il selettore centrale e le aree dei giocatori. I tasti eswnESWN spostano una tessera ai giocatori Est, Sud, Ovest e Nord. I tasti xX la riportano indietro al selettore centrale. ESWN sposta alla fila delle tessere coperte, eswn sposta a quella delle scoperte. Puoi muovere il cursore tra le tessere o le combinazioni tramite i tasti freccia, e la tessera o la combinazione correntemente selezionata viene evidenziata con un riquadro azzurro. Dato che i tasti freccia stanno abbastanza lontano dalle lettere nella tastiera, puoi usare anche le lettere hjkl o HJKL per lo spostamento del cursore. hH sposta a sinistra, jJ sposta giù, kK sposta su, lL sposta a destra. Questo è il metodo utilizzato dall'editor unix `vi`. Anche il browser &kde; &konqueror; e questo programma di aiuto supportano quei tasti allo stesso modo. Essi possono variare se utilizzi una lingua diversa dall'inglese, ma al momento non è possibile configurarli.

Le opzioni Ultima tessera e Ultima combinazione sono necessarie ad alcune regole come L'ultima tessera completa la coppia. Esse possono essere utilizzate solo per la mano vincente.

Nella parte destra della finestra puoi applicare manualmente alcune regole. Le regole che appaiono in quest'elenco dipendono dallo schema di gioco attivo e dalle tessere. Nell'esempio della schermata in alto, i giocatori perdenti potrebbero avere l'opzione gioco pericoloso: anche in questo caso, essa dipende dallo schema di gioco e dalle sue tessere. Lo scopo degli sviluppatori è mantenere più corto possibile quest'elenco di regole selezionabili manualmente. In una condizione ottimale &kajongg; dovrebbe essere sempre in grado di determinare se una regola è applicabile, ma talvolta non ha abbastanza informazioni o conoscenze per decidere.

#### Penalità

Schermata di &kajongg; Schermata

Nella finestra di inserimento dei risultati della mano, il pulsante Penalità conduce alla finestra in cui inserire le penalità. Questo può essere eseguito in qualsiasi momento indipendentemente dal normale meccanismo di attribuzione del punteggio.

La selezione Irregolarità: mostra tutte le irregolarità che possono essere alle mani che il giocatore possiede. Scegli tra esse.

Ora puoi adattare la Penalità totale. Questa è la somma totale che viene spostata dai paganti ai pagati. Verrà divisa equamente tra di loro.

A seconda del tipo di penalità, il numero di paganti e pagati varia. viene visualizzato l'esatto numero di giocatori. Se selezioni un giocatore, &kajongg; assicura che questi esista solo una volta, adattando gli altri giocatori.

## Giocare

Puoi attivare la modalità Dimostrazione in qualsiasi momento. In questa modalità, il computer giocherà per te. Se non stai giocando alcuna partita, ne verrà iniziata una nuova con l'ultimo schema di gioco usato.

### Gioca contro il computer

In primo luogo ti appare una finestra di accesso. Digita il server di gioco cui vuoi collegarti e il tuo nome utente. Se scegli la voce speciale Partita locale, devi solo digitare il tuo nome (o accettare quello proposto) e lo schema di gioco desiderato. Ciò avvierà immediatamente una partita locale in cui giochi contro tre giocatori robot. Tuttavia, se esistono partite in sospeso, esse saranno visualizzate in un elenco. Puoi dunque selezionare la partita che desideri continuare o iniziarne una nuova.

### Gioca con amici

Se desideri giocare contro persone reali, hai bisogno di un server di gioco a cui tutti i giocatori, incluso tu, devono collegarsi. Esegui questa azione selezionando qualsiasi altro host o digitando manualmente il nome di un nuovo host e specificando la password appropriata. Verrà proposta l'ultima password usata.

Il modo più facile è utilizzare il server di gioco `kajongg.org`. &kajongg; te lo mostrerà nell'elenco dei server di gioco a disposizione. Nota che al momento questo server offre solo un server di gioco e nessuna pagina web o servizi.

Se non hai un account sul server di gioco corrispondente al nome che hai digitato, ti verrà chiesto a aprirne uno. Se rispondi sì, otterrai una nuova finestra di dialogo in cui digitare due volte la password scelta. L'account sarà creato automaticamente.

Dopo aver avuto correttamente accesso al server di gioco cui vuoi collegarti, otterrai un elenco di tavoli con i posti disponibili su quel server. Unisciti a un tavolo o creane uno nuovo. Se ne crei uno nuovo, aspetta fino a quando i posti vengono occupati da altri giocatori. Puoi iniziare la partita in qualsiasi momento nel tavolo da te creato, i posti vuoti verranno occupati da giocatori robot.

L'elenco della tavoliere mostra anche il nome dello schema giocato in quel tavoliere. Lo schema e il suo nome vengono inviati al server di gioco dal giocatore che inizia il tavolo. Se hai uno schema identico, il tavoliere mostra il tuo nome per lo schema: questo può essere utile se chi ha aperto il tavolo parla un'altra lingua e chiama lo schema in modo diverso. Inoltre, il nome del tuo schema locale sarà visualizzato in nero. Tuttavia, se non possiedi lo stesso il nome appare in rosso e puoi premere il pulsante Confronta per confrontarlo con quelli in tuo possesso.

Se non usi `kajongg.org` e nessun altro dei server di gioco esistenti, puoi avviare il tuo server di gioco &kajongg; in due modi differenti:

- collegarti al server `localhost`. questo è il tuo computer. Se fai questa scelta e non è avviato alcun server di gioco, esso sarà avviato automaticamente. Quando finisci di giocare, anche il server viene fermato. Questo è diverso dal selezionare Partita locale, quest'ultimo non permette connessioni con altri computer.

- avviare manualmente un server su un computer di tua scelta. Tutto quello che serve è avviare da riga di comando il programma `kajonggserver`. Se scrivi `kajonggserver --help` ti verranno mostrate le opzioni disponibili, come la modifica della porta predefinita. Questo server rimarrà avviato fino a che non lo termini.

In entrambi i casi devi dire agli altri giocatori come possono raggiungere il tuo server di gioco. Essi hanno bisogno dell'&URL;, o semplicemente di un indirizzo IP e la porta in cui il tuo server è in ascolto. Può essere qualcosa tipo `miopc.dyndns.org:8301`, dove `8301` è la porta. Naturalmente devi configurare il tuo firewall affinché il giocatore remoto possa raggiungere quella porta. La comunicazione sarà cifrata.

Per il numero di porta, vedi Aiuto Informazioni su &kajongg;. La versione del protocollo è il numero di porta. Per &kajongg; 17.04 questo è 8301. Se il giocatore non inserisce alcuna porta per il server di gioco desiderato, il client calcola la porta nello stesso modo. Se, dunque, un computer esegue diversi server di gioco con versioni diverse del protocollo, in genere ti dovresti collegare automaticamente al server corretto. Ad ogni modo, il server e il client di gioco verificheranno mutuamente di possedere versioni compatibili e, in caso contrario, ti avviseranno.

Se ti imbatti in possibili errori, potresti voler utilizzare l'opzione `kajongg --debug=traffic`. Questa ti mostrerà, nella console in cui è stato avviato il server di gioco, quali messaggi vengono scambiati tra il server di gioco e i client. Per altre opzioni, vedi `kajongg --help`

#### Limitazioni

- Se vuoi essere sicuro che nessuno possa imbrogliare, nessuno dei giocatori umani devono avere accesso al computer in cui è avviato il server di gioco. Non puoi, naturalmente, evitare che due giocatori si aiutino a vicenda, perché non puoi sapere cosa realmente stanno facendo. Due giocatori possono essere anche la stessa persona.

### Regole del gioco

Esistono, a livello internazionale, molte varianti del gioco. Attualmente &kajongg; supporta due varianti del Cinese classico, quella giocata in Germania e quella giocata in Gran Bretagna.

Questa descrizione non entra nei dettagli e corrisponde a entrambe le varianti.

La maggior parte delle regole, tuttavia, è comune alla maggioranza delle varianti.

Poiché il programma &kajongg; sa come giocare, questa descrizione contiene solo le cose che potrebbero non essere ovvie.

Se vuoi apprendere il Mah Jong in modo più approfondito, consulta la bibliografia.

#### Scopo del gioco

Ciascun giocatore tenta di raccogliere le tessere in modo da ottenere una mano vincente. Nel riuscirvi, egli chiama il Mah Jong. In una mano vincente le tessere sono normalmente raggruppate in cinque combinazioni: quattro combinazioni con tre o quattro tessere ciascuna e una quinta composta da due tessere uguali. Una combinazione normale contiene tre o quattro tessere identiche (chiamate rispettivamente Tris o Poker) oppure tessere in sequenza come Bambù 3, Bambù 4, Bambù 5 (chiamata Scala).

#### Svolgimento della partita

Inizialmente, il giocatore col vento Est (come indicato sul muro) possiede una tessera in più rispetto agli altri giocatori. Est inizia a scartare una tessera indesiderata.

Ogni volta che viene scartata una tessera, gli altri giocatori possono dichiararla annunciando ciò che con essa possono completare (Scala, Tris, Poker, Mah Jong). Solo il giocatore successivo può dichiarare una scala, mentre le altre dichiarazioni possono essere eseguite da tutti. Una combinazione completata da una dichiarazione verrà esposta, ossia resa visibile a tutti i giocatori.

Se nessuno dichiara la tessera scartata, il giocatore successivo, Sud (e di seguito Ovest e Nord), prende una tessera dal muro e scarta una tessera indesiderata.

Esistono varie regole sul modo in cui un tris può diventare un poker (dichiarando la quarta tessera od ottenendola dal muro): essere non vengono trattate qui. Ma &kajongg; conosce, naturalmente, tali regole e fa in modo che esse siano rispettate. Se viene dichiarato un poker, il giocatore ottiene automaticamente un rimpiazzo di tessera dal muro - diversamente non sarebbe possibile costruire le cinque combinazioni, come affermato sopra.

#### Anno, Giro e Mano

Quando un giocatore dichiara Mah Jong o si termina in parità, viene completata una mano. Ora, ad eccezione delle mani pari, i venti ruotano tra i giocatori. Questo sistema è ripetuto fino a che ciascun giocatore ha ottenuto tutti i venti. Questa unità intera viene chiamata giro. Una partita intera, chiamata anche anno, consiste di quattro giri: vento di giro Est, vento di giro Sud, vento di giro Ovest, vento di giro Nord. Il vento di un giro è anche chiamato vento prevalente, che può determinare anche punteggi superiori.

Dunque una partita completa (un anno) consiste almeno di sedici mani. Dato che i venti non ruotano per le mani pari o quando il giocatore Est dichiara Mah Jong, per portare a termine un'intera partita è necessario normalmente un numero superiore di mani.

#### Tessere bonus

Una partita può contenere otto tessere bonus (a meno che le regole non le escludano). Esse sono esposte separatamente sul lato destro dell'area del giocatore, poiché essere non vengono mai utilizzate per costruire combinazioni. Esse, comunque, generano punti bonus.

Se un giocatore ottiene una tessera bonus, ottiene automaticamente anche una tessera di rimpiazzo dal muro. E suona una campana.

#### Punteggio

Alla fine di una mano, viene calcolato il punteggio per ciascun giocatore. Per primo, i punti base sono conteggiati come due punti per un tris scoperto semplice o 20 punti per una vittoria. Poi, viene applicato un altro gruppo di regole - quelle regole possono raddoppiare i punti, come un punteggio doppio per una combinazione di draghi. Quando il punteggio per ciascuna mano è noto, le differenze sono pagate tra giocatori - mentre il vincitore ottiene il punteggio pieno pagato da tutti gli altri giocatori. Est ottiene e paga sempre due volte il proprio punteggio.

Ovviamente &kajongg; conosce tutte le regole applicabili, ma un buon giocatore sa il punteggio delle varie combinazioni, e ottimizza le proprie giocate. Durante l'apprendimento, è bene attivare la finestra Spiega punteggi.

Le esatte regole di calcolo del punteggio spesso variano - in &kajongg; si è liberi di modificarle con l'editor degli schemi.

L'editor degli schemi mostra anche tutti gli schemi disponibili e il loro significato. Posiziona il mouse sopra di essi: per le regole più particolari apparirà un testo esplicativo.

### Come si gioca a &kajongg;

Ti verrà domandato cosa desideri fare. Questa è una finestrella sulla destra o sulla parte inferiore, a seconda della dimensione della finestra. Puoi renderla più larga che alta, in tal caso essa apparirà a destra. A volte la finestrella è a tempo: una volta scaduto, la prima risposta possibile viene selezionata automaticamente per te. Il tempo è configurabile nell'editor degli schemi, sotto Opzioni, Dichiara il tempo. Tutti i giocatori devono avere lo stesso tempo a disposizione, ecco perché esso fa parte dello schema di gioco.

Se devi selezionare una tessera dalla tua mano, puoi spostarti tra le tessere utilizzando i tasti freccia &Right; e &Left; o le lettere h e l sulla tastiera. Ovviamente puoi usare anche il mouse.

Puoi scaricare una tessera usando sempre la tastiera, per qualsiasi azione. In alternativa, puoi usare il mouse e spostare la tessera dalla tua mano all'interno dell'area di scarto (all'interno delle mura). Il posizionamento della tessera nell'area di scarto verrà ancora eseguito dal computer - poiché il posizionamento deve essere uguale per tutti i giocatori.

Spesso, le finestre di dialogo offrono scelte che non sono veramente applicabili, tipo la chiamata di Tris quando non possiedi le tessere necessarie. Ciò è voluto: proprio come in una partita vera. Ma puoi configurare il programma in modo che non vengano mostrate le scelte non possibili: disabilita Mostra solo le azioni possibili nella pagina Gioca della finestra di dialogo delle impostazioni.

Le tessere scartate sono distribuite casualmente tra i muri. Alcune varianti di gioco definiscono il punto in cui le tessere devono essere posizionate, ma ciò non è ancora configurabile. Quando lo sarà, diventerà parte dello schema di gioco.

## Panoramica dell'interfaccia

### Elementi del menu

&Ctrl;C Partita Conteggia una partita manuale

- Conteggia solo i punti di una partita giocata manualmente.

  Puoi caricare una vecchia partita o iniziarne una nuova. Per impostazione predefinita, solo le partite in corso (ossia quelle non terminate) vengono mostrate nell'elenco di selezione. Facoltativamente, puoi visualizzare tutte le partite, incluse quelle terminate. Qui puoi anche eliminare partite.

&Ctrl;N Partita Gioca

- Gioca con altri (persone e computer).

&Ctrl;W Partita Interrompi partita

- Termina la partita corrente. Se è una partita manuale col solo conteggio dei punti, puoi riprenderla in seguito. Se giochi con &kajongg;, non puoi riprendere la partita.

&Ctrl;Q Partita Esci da &kajongg;

- Esce da &kajongg;.

&Ctrl;H Visualizza Chat

- Chat

  Finestra della chat Finestra della chat

  Ti permette di conversare con gli altri giocatori.

&Ctrl;T Visualizza Bacheca punteggio

- Bacheca punteggio

  Bacheca punteggio Schermata

  Mostra la bacheca del punteggio. La colonna Giro/Mano indica gli attuali giri (Est, Sud, Ovest, Nord) seguiti dal conteggio delle mani giocate in quel giro. I valori del vincitore hanno uno sfondo verde. La colonna Pagamenti mostra quanto il giocatore ha pagato o ricevuto da tutti gli altri giocatori in questa mano. La colonna Bilancio mostra il bilancio attuale di tutti i giocatori. La colona Grafico mostra l'andamento dei valori del bilancio. I suggerimenti offrono maggiori dettagli: mostrano tutte le regole applicate a questa mano. Basta muovere il mouse sul valore cui sei interessato.

  La parte inferiore mostra lo schema di gioco usato. Tra la bacheca del punteggio e lo schema di gioco usato è presente un divisore che ti permette di modificare le relative dimensioni di entrambe le aree.

&Ctrl;E Visualizza Spiega punteggi

- Spiega punteggi

  Bacheca punteggio Bacheca punteggio

  Spiega come è stato calcolato il punteggio per la mano corrente.

&Ctrl;&Shift;F Visualizza Modalità schermo intero

- Alterna le modalità a schermo intero e normale.

Impostazioni Giocatori

- Aggiunge, modifica ed elimina i giocatori.

  Le password in questa tabella sono quelle utilizzate per impostazione predefinita quando si accede a un server di gioco. La modifica della password scelta al principio per il server non è in realtà per niente utile, perché non esiste ancora il modo di cambiare la tua password sul server di gioco. Dovresti chiedere all'amministratore del server di farlo al tuo posto, direttamente nella banca dati.

Impostazioni Schemi di gioco

- Personalizza gli schemi di gioco.

  Usa l'editor degli schemi di gioco per personalizzare gli schemi. Per dettagli, leggi qui.

&Ctrl;G Impostazioni Cambia angolo di visuale

- Cambia in senso antiorario l'angolo di visuale delle tessere.

&Ctrl;D Impostazioni Modalità dimostrazione

- Abilita o disabilita la modalità Dimostrazione. Per dettagli, leggi qui.

In aggiunta, &kajongg; contiene gli elementi di menu Impostazioni e Aiuto, comuni di &kde;, per ulteriori informazioni leggi le sezioni relative al menu Impostazioni e menu Aiuto dei Fondamentali di &kde;.

## Configurazione del gioco

Finestra di configurazione Finestra di configurazione

La voce di menu Impostazioni Configura &kajongg;... apre la finestra di dialogo Configura - &kajongg;.

Se premi qui il pulsante Annulla, tutte le tue modifiche alla configurazione saranno annullate, incluse tutte le modifiche eseguite con l'editor degli schemi di gioco.

Puoi anche selezionare le varie schede con la tastiera: &Ctrl;1 seleziona la prima scheda delle opzioni Gioca, &Ctrl;2 seleziona la seconda, e così via.

### Opzioni di gioco

Mostra ombre delle tessere

- Mostra le tessere con bordi e ombre. C'è anche un po' di spazio tra le file delle tessere e vengono mostrate le tessere del muro, in modo che possa vedere quanto esso è alto (due o tre file di tessere). Se l'opzione è disabilitata, si ottiene una vista più semplice con tessere leggermente più grandi, utile per schermi piccoli.

Ridisponi le tessere coperte in combinazioni

- Raggruppa le combinazioni nella mano. Talvolta il raggruppamento non è come vorresti, e dunque potresti desiderare di non averne alcuno, proprio come nelle partite reali.

Mostra solo le azioni possibili

- Durante la partita, mostra solo le azioni possibili come Nessuna dichiarazione o Tris.

Proponi cosa fare

- Ogni qualvolta sei di fronte ad azioni come dichiarare o no una tessera oppure scegliere quale tessera scartare, &kajongg; ti può aiutare con un suggerimento.

Usa suoni, se disponibili

- Permette di ascoltare gli scarti e le dichiarazioni. Se gli altri giocatori hanno registrato file sonori della propria voce, puoi sentirli.

Permetti agli altri di sentire la mia voce

- Se registri file sonori con la tua voce, questa opzione permette agli altri giocatori di sentire la tua voce quando scarti o dichiari.

Velocità animazione:

- Definisce quanto rapidamente si spostano le tessere. Se sposti l'indicatore completamente verso destra, il movimento delle tessere non viene animato: le tessere cambieranno semplicemente di posto.

#### Suoni

Il gioco fornisce un'esperienza più coinvolgente se ascolti gli altri giocatori mentre dichiarano le tessere e annunciano gli scarti. Rende inoltre il gioco più semplice perché ti permette di concentrarti sulle tue tessere, senza dover osservare gli scarti degli altri.

&kajongg; è fornito con voci per diversi giocatori, e assegna automaticamente le voci. Per ciascuna lingua dovrebbero esserci quattro voci, meglio se due maschili e due femminili. &kajongg; tenta di usare le voci nella stessa lingua in cui è avviato. Se non trova le voci in quella lingua, &kajongg; usa le lingue di ripiego che hai definito per il programma (vedi Aiuto Cambia lingua dell'applicazione). Se non sono presenti file sonori per la tua lingua, sei invitato a registrarli e contribuire al miglioramento di &kajongg;.

- Ecco come generare le voci per tuo conto. Per ogni voce è presente una cartella. Nota che queste cartelle si possono trovare in un'altra posizione all'interno del tuo sistema, esse dipendono da come è stato installato &kde;. Solo la parte che inizia per `kajongg` è sempre uguale. Esistono due gruppi di voci in posti diversi, nel file system:

  - Voci predefinite per ciascuna lingua. Risiedono in una cartella tipo `/usr/share/kajongg/voices/LANG`, dove LANG è il codice della tua lingua. Le cartelle voce sotto `.../kajongg/voices/` sono le versioni inglesi US. Le voci predefinite vengono assegnate ai giocatori casualmente. Esse hanno nomi del tipo `"male1 male2 female1 female2"`, ma è poco importante dato che l'utente non li vedrà mai.

  - Le voci utente sono definibili per un utente specifico. Se &kajongg; usa una di queste voci, la stessa viene trasferita automaticamente agli altri giocatori in Internet. Queste voci risiedono in una cartella tipo `~/.local/share/apps/kajongg/voices/`. Se il tuo nome di accesso è pippo, essa sarà `/home/joe/.local/share/apps/kajongg/voices/pippo/`. La cartella `voices/` potrebbe non esistere; in tal caso va creata.

- Ora che sai dove memorizzare la tua nuova voce, genera per essa una nuova cartella.

- In quella sottocartella puoi memorizzare i file sonori. Essi devono essere codificati col compressore audio Ogg Vorbis e i nomi dei file devono avere l'estensione `.ogg`. Un singolo file ha un nome tipo `s3.ogg` - questo è Pietra («Stone») 3. Devi definire questi file per tutte le pedine, tutte le dichiarazioni e gli annunci. Se un file sonoro non è presente non succede nulla, semplicemente non sentirai il suono. Il ripiego ad altre voci o lingue funziona solo per le voci complete e non per i singoli file sonori.

- Dopo aver definito tutti i file sonori per una voce predefinita, assicurati che il processo di &kajongg; abbia i permessi di scrittura nella nuova cartella voce. Avvia &kajongg; e prova la voce. Dopo aver verificato che tutto sia a posto, puoi revocare il permesso di scrittura (è necessario farlo per le voci predefinite). &kajongg; genererà automaticamente un file di nome `md5sum` che contiene la somma di controllo di tutti i file sonori. Se cambi, aggiungi o elimini un file sonoro per una voce, &kajongg; tenterà di riscrivere il file.

Rendi il suono breve ma parla chiaramente: il gioco può svolgersi molto rapidamente, una volta preso confidenza con esso. Se scrivi un elenco di tutti gli elementi da pronunciare ti renderà più facile il lavoro. Non leggere gli elementi in sequenza ma sforzati di pronunciare ciascuna voce come un elemento isolato e come se stessi giocando. Lascia spazio tra gli elementi. Questo tipo di lettura necessita di un po' di pratica.

Di seguito, un metodo per creare i file sonori:

- Registra un file sonoro col programma `qarecord`, salvalo nel formato WAV. In quest'unico file registra tutti i suoni.

- Modifica il file con l'editor di suoni `audacity`. Nell'editor, usa il mouse per evidenziare un intervallo di suono. L'editor riprodurrà quella porzione. Ripeti fino a quando non selezioni la porzione corretta. Quest'operazione può risultare più semplice con Visualizza Zoom avanti. Usa il comando File Esporta selezione e salvala in formato `.ogg`. Nelle Opzioni, scegli una bassa qualità: questa è sufficiente e anche necessaria, poiché riduce il tempo del trasferimento dei suoni agli altri giocatori.

I seguenti nomi sono i nomi dei file da generare. Associa loro sempre l'estensione `.ogg`:

#### Nomi dei file sonori

&s1; .. &s9; | Da pietra 1 a pietra 9
&b1; .. &b9; | Da bambù 1 a bambù 9
&c1; .. &c9; | Da carattere 1 a carattere 9
&we; &ws; &ww; &wn; | I venti Est, Sud, Ovest, Nord
&db; &dr; &dg; | I dragoni blu/bianchi, rossi, verdi
&chow; &pung; &kong; &mahjongg; | Le dichiarazioni principali
&originalcall; &violatesoriginalcall; | Chiamata originale e sua violazione
&dangerousgame; | Un giocatore rilascia un cannone (gioco pericoloso)
&nochoice; | Un giocatore dichiara di non avere alcuna possibilità se non eseguire un gioco pericoloso

### Opzioni delle tessere

Selettore del set di tessere Selettore del set di tessere

Usa il selettore delle tessere per selezionare le immagini per le tessere.

### Opzioni dello sfondo

Selettore sfondo Selettore sfondo

Usa il selettore dello sfondo per selezionare un'immagine di sfondo per il gioco.

Alcuni sfondi, come il panorama cinese, impiegano del tempo a caricare. Se ritieni che il programma debba avviarsi più rapidamente o che il ridimensionamento della finestra principale impieghi sia troppo lento, puoi provare altri sfondi.

### Editor degli schemi di gioco

Editor schemi di gioco Editor schemi di gioco

Usa l'editor degli schemi per personalizzare gli schemi di gioco. Gli schemi di gioco predefiniti sono mostrati in corsivo, mentre quelli personalizzati in carattere normale. Gli schemi di gioco predefiniti non possono essere modificati in alcun modo dall'utente, ma potrebbe farlo un aggiornamento di &kajongg;. Gli schemi personalizzati non saranno mai modificati da un aggiornamento.

Quando avvi una nuova partita, potrai selezionare per essa uno schema di gioco. Possono essere utilizzati tutti gli schemi di gioco definiti nell'editor degli schemi. Lo schema di gioco è salvato assieme alla partita, così che puoi sempre cambiare le regole al suo interno: le tue modifiche avranno effetto solo sulle partite future.

#### Regola, punti, x2, limiti

Fai doppio clic su ciò che vuoi modificare. Se vengono azzerati tutti i valori, questa regola non avrà influenza sulla partita. Le regole non possono essere eliminate.

#### Copia e rimuovi

Puoi copiare e rimuovere interi schemi di gioco.

Questo può essere eseguito se le partite esistenti usano questo schema di gioco, dato che ogni partita possiede la sua propria copia dello schema. Puoi visualizzare gli schemi di gioco delle vecchie partite: Carica la vecchia partita e mostra la sua bacheca punteggio.

#### Confronta

Comparatore di schemi di gioco Comparatore di schemi di gioco Puoi selezionare questo comando quando è selezionato un intero schema di gioco. Ti consente di confrontare lo schema selezionato con gli altri schemi.

### Combinazioni predefinite della tastiera

Le scorciatoie predefinite della tastiera sono le seguenti:

F1

- Mostra questo manuale.

&Ctrl;C

- Conteggia una partita manuale.

&Ctrl;N

- Gioca una partita con amici o computer.

&Ctrl;W

- Interrompi la partita corrente.

&Ctrl;Q

- Esci dal programma.

&Ctrl;T

- Mostra la bacheca punteggio.

&Ctrl;H

- Mostra una finestra per la chat.

&Ctrl;G

- Cambia l'angolo di visuale.

&Ctrl;D

- Abilita o disabilita la modalità Dimostrazione.

&Shift;F1

- Che cos'è? Aiuto.

&Ctrl;&Shift;F

- Modalità schermo intero.

## Problemi conosciuti

- In modalità gioco, le penalità non sono ancora possibili.

- I giocatori computer sono ancora piuttosto stupidi.

## Caratteristiche future possibili

- Aggiungere altri schemi di gioco. Questo dovrebbe essere fatto da persone che usano regolarmente quegli schemi di gioco.

## Domande ricorrenti

Posso cambiare l'aspetto del gioco?

Sì. Per cambiare l'aspetto di &kajongg;, usa la barra dei menu per aprire l'utilità di configurazione.

Posso usare la tastiera per assegnare tessere ai giocatori?

Sì. Consulta Far calcolare il punteggio a &kajongg;.

## Riconoscimenti e licenza

&kajongg; per &kde;

Copyright del programma © 2009-2017 &Wolfgang.Rohdewald; &Wolfgang.Rohdewald.mail;

Copyright della documentazione © 2009-2017 &Wolfgang.Rohdewald; &Wolfgang.Rohdewald.mail;

Valter Mura valtermura@gmail.com

&underFDL; &underGPL;

## Bibliografia

- Das Chinesische Mah-Jongg-Spiel, di Uwe Martens, 2005, Books on Demand GmbH, Norderstedt. Questo libro è un eccellente testo tedesco che contiene tutto ciò che desideri sapere sulle regole utilizzate in Germania e su molti altri aspetti del gioco.

- The Complete Book of Mah-Jongg, di A. D. Millington, 1977 (con varie edizioni paperback fino al 2003), Weidenfeld & Nicolson, London. Questo è l'ultimissimo testo di consultazione per il Mah Jong cinese classico, così come giocato nel mondo occidentale. Può darti importanti suggerimenti sulle strategie di gioco.

- Mah-Jong, di Gwyn Headley e Yvonne Seeley, 3rd edition, 2008, A & C Black Publishers Ltd., London. Questo libro è un testo di consultazione molto facile da usare, che si concentra sulle regole usate in Gran Bretagna, definite dalla BMJA (The British Mah Jong Association).

## Installazione

Per Linux: la tua distribuzione dovrebbe aver creato il pacchetto per te.

Per Windows: vedi relativamente a un installatore Windows.

Se vuoi scaricare il sorgente e installarlo manualmente:

- `git clone https://invent.kde.org/games/kajongg.git`

- Per Linux: `cd kajongg ; mkdir build ; cd build; cmake .. && make && make install`

- Per Windows: leggi `README.windows`

Kajongg dipende da questi pacchetti: (i nomi dei pacchetti debian sono tra parentesi)

- Python 3.8 o superiore (python3)

- Qt6.5 o superiore (python3-pyqt6 e python3-pyqt6.qtsvg)

- l'interfacciamento python per Qt6 (python3-pyqt6)

- la libreria particolare di python 16.6.0 o superiore (python3-twisted)

- sqlite3 (libsqlite3-0)

&documentation.index;