# El manual del &kajongg;

## Introducció

### Tipus de joc:

Tauler, arcade

### Nombre de possibles jugadors:

Quatre

El &kajongg; és un joc de taula creat després del famós joc oriental de Mah Jong (del xinès 麻將). El qual és jugat per quatre jugadors. A tot el món s'utilitzen molts jocs de regles diferents. En aquest moment, el &kajongg; admet les regles del xinès clàssic com es juga a Alemanya, finalment seguiran altres jocs de regles principals. És possible personalitzar-los o afegir-ne de nous. Feu-ho i envieu-los a l'autor del programa per a la seva integració!

El &kajongg; es pot utilitzar de dues maneres diferents: dur la puntuació d'un joc manual en què es juga com sempre sense l'ajuda d'un ordinador i s'utilitza el &kajongg; per al càlcul de les puntuacions i per a la comptabilitat. O podeu utilitzar el &kajongg; per a jugar contra qualsevol combinació d'altres jugadors humans o contra l'ordinador.

## La disposició de la pantalla

Una captura de pantalla del &kajongg; Captura de pantalla

Una explicació ràpida de les parts de la pantalla de joc.

Barra d'eines

- La barra d'eines es troba a sota de la barra de menús i conté els botons per a les accions més utilitzades. El contingut de la barra d'eines es pot editar. També podreu fer-la invisible, donant més espai al tauler.

  Depenent de la mida de la pantalla, possiblement voldreu fer que la barra d'eines sigui invisible o moure-la a la part esquerra de la finestra. Podreu fer-ho fent clic amb el &BDR; a sobre de la barra d'eines.

Tauler

- El tauler és la secció més gran de la finestra. Veureu les quatre parets amb una longitud de 18 fitxes (el nombre exacte dependrà de les regles, com emprar o no fitxes de bonificació). Els noms dels jugadors estan escrits a les parets, juntament amb el valor actual de la mà (que se sàpiga) i les seves fitxes de vent. El vent predominant tindrà un fons amb color, a l'est en la captura de pantalla de dalt és a l'est.

  Quan es juga, l'interior de les parets conté les fitxes descartades pels jugadors. Estan col·locades a l'atzar. L'última fitxa descartada tindrà un marc d'enfocament en blau.

  Quan es puntuen les partides manuals, l'interior de les parets tindrà una selecció de totes les fitxes disponibles, el selector central. Podreu assignar-les als jugadors emprant el ratolí o el teclat.

Regió del jugador

- Cada jugador té un interval de pantalla per a les seves fitxes. La fila superior contindrà les fitxes exposades, la fila inferior contindrà les fitxes ocultes. En puntuar els jocs manuals, les fitxes ocultes es mostraran amb una ombra per sobre de tota la fitxa. Les fitxes de bonificació van a l'extrem dret.

Diàleg

- El diàleg presenta les opcions que té el jugador. La majoria de les vegades té un temps d'espera amb una barra de progrés mostrant el temps restant.

Barra d'estat

- La barra d'estat es troba a la part inferior de la pantalla i conté els totals actuals per als jugadors.

## Puntuar un joc manual

En aquest mode, el &kajongg; només s'utilitza per a dur la puntuació. Jugueu com de costum amb persones reals en una taula real i al final d'un joc podreu dir-li al &kajongg; les fitxes que un jugador té a la mà i tota la resta que el &kajongg; necessita saber per a calcular les puntuacions -el qual és el que farà el programa-. De manera alternativa, podreu calcular les puntuacions manualment i introduir-les. El &kajongg; després farà els pagaments entre els jugadors i escriurà els resultats en una base de dades. És possible suspendre un joc, iniciar-ne un altre amb altres jugadors i reprendre jocs antics. Totes les regles es desaran juntament amb els jocs, de manera que es poden jugar jocs diferents amb regles diferents.

- Des del menú, seleccioneu Joc Puntuació manual del joc o premeu &Ctrl;C.

- Ara podreu escollir un joc sense acabar l'existent o començar-ne un de nou. Si en comenceu un de nou, se us demanarà pels jugadors i el joc de regles. El &kajongg; proposarà els mateixos valors utilitzats per al joc anterior. Si no n'hi havia un, proposarà els quatre primers jugadors definits. Recordeu que no podreu canviar el joc de regles ni cap de les seves regles després d'aquesta selecció. Podeu fer-ho abans a l'editor dels jocs de regles.

- Ara apareixerà una finestra nova titulada Puntuació per a aquesta mà. Per a una descripció detallada, llegiu Fer que el &kajongg; calculi la puntuació.

- Una vegada deseu els resultats de la mà, continueu amb la mà següent.

### Introduir els resultats de la mà

#### Puntuacions

Una captura de pantalla del &kajongg; Captura de pantalla

Aquesta és la finestra per a introduir els resultats de les mans. Es mostrarà automàticament quan el &kajongg; cregui que podríeu necessitar-ho. Sempre es pot mostrar o ocultar prement &Ctrl;S o seleccionant l'entrada de menú corresponent.

Com sempre, el vent predominant tindrà el seu fons en color.

Podeu introduir manualment les puntuacions de tots els jugadors. De manera alternativa, podreu definir exactament quines fitxes tenia un jugador a la mà. Si trieu fer-ho, el camp corresponent per al valor de la puntuació manual apareixerà atenuat. El &kajongg; calcularà automàticament la puntuació.

Una vegada introduïdes totes les dades rellevants per a una mà, premeu el botó Desa la mà. Els valors de les mans s'introduiran a la base de dades i també es mostraran a la taula de puntuacions. És possible que se us demani que canvieu les posicions dels seients dels jugadors, però podeu optar per no canviar de seient. Actualment, els canvis proposats no es poden personalitzar -si un joc de regles necessita quelcom diferent, ho canviarem-.

Si el jugador podia haver guanyat, s'habilitarà la casella de selecció a la columna Guanyador -feu-hi clic per al guanyador-.

La barra d'estat ara mostrarà els saldos actualitzats per als jugadors, i es podrà continuar amb la mà següent.

##### Introduir manualment la puntuació

Un bon jugador probablement preferirà calcular la seva puntuació ell mateix. En aquest cas, podeu introduir-la directament. Això només és possible quan no se seleccionen fitxes per a aquest jugador.

Si introduïu manualment una puntuació, ja haurà de contenir-ho tot excepte les sancions, no tindreu regles opcionals per a triar. Hi ha una excepció: «Joc perillós». Això no influirà en cap puntuació, tampoc és una infracció. Només vol dir que el pagament entre jugadors serà diferent: l'infractor ho pagarà tot per tothom al guanyador. Els altres dos jugadors no intercanviaran cap pagament. Actualment, això no es pot personalitzar.

##### Fer que el &kajongg; calculi la puntuació

Si li indiqueu explícitament al &kajongg; quines fitxes té un jugador, s'atenuarà la puntuació que introduïu per a aquest jugador en aquesta finestra. En associar les fitxes amb un jugador, veureu com augmenta la seva puntuació, però tan aviat com afegiu la 14a fitxa, la puntuació passarà a zero. Això pot sorprendre, però a menys que la declareu com la mà guanyadora, es reconeixerà com una mà llarga, la qual sempre tindrà zero punts. Aquest comportament està definit pel joc de regles del xinès clàssic, podria ser diferent si es canvien les regles o es fa servir un joc de regles diferent.

Podeu associar les fitxes i les combinacions amb un jugador utilitzant el ratolí o el teclat, o ambdós. Amb el ratolí, senzillament moveu les fitxes arrossegant i deixant-les anar a la regió del jugador. En deixar anar la fitxa, se us demanarà què voleu moure: Individual, Parella, Pung, Kong, Kong reclamat o Chow. La fila superior és per a les fitxes exposades, la fila inferior per a les fitxes ocultes. Les fitxes de bonificació apareixeran a l'extrem dret. També podeu moure les fitxes i les combinacions entre files, jugadors i de tornada al selector central.

Si preferiu utilitzar el teclat, es pot emprar per a moure entre el selector central i les regions dels jugadors. Les tecles eswnESWN mouen una fitxa als jugadors Est, Sud, Oest i Nord. Les tecles xX la tornen al selector central. ESWN la mouen a la fila oculta, eswn la mouen a la fila exposada. Podreu moure el cursor entre les fitxes o les combinacions amb les tecles de fletxa, la fitxa o la combinació actualment seleccionada tindrà un marc blau. Atès que les fletxes de les tecles estan lluny de les lletres del teclat, també podeu utilitzar les lletres hjkl o HJKL per a moure el cursor. hH la mourà a l'esquerra, jJ la mourà cap avall, kK la mourà cap amunt, lL la mourà cap a la dreta. Així és com ho fa l'editor d'Unix `vi`. El navegador &konqueror; del &kde;, així com aquest programa d'ajuda també admeten aquestes tecles de la mateixa forma. Aquestes tecles podrien diferir si utilitzeu un idioma que no sigui l'anglès, però en l'actualitat no és possible configurar-les.

Les opcions Darrera fitxa: i Darrera combinació: són necessàries per a algunes regles com L'última fitxa completa el parell. Només es poden utilitzar per a la mà guanyadora.

A la part dreta de la finestra podreu aplicar manualment algunes regles. Les regles que apareixen en aquesta llista dependran del joc de regles actual i de les fitxes. En l'exemple a la captura de pantalla anterior, els jugadors perdedors poden tenir una opció de «joc perillós» -de nou depenent del joc de regles i de les seves fitxes-. L'objectiu dels desenvolupadors és mantenir aquesta llista de regles seleccionable tan curta com sigui possible. De manera òptima, el &kajongg; sempre hauria de poder determinar automàticament si s'aplica una regla, però de vegades el &kajongg; no té prou informació o coneixement per a decidir.

#### Penalitzacions

Una captura de pantalla del &kajongg; Captura de pantalla

A la finestra per a introduir els resultats de les mans, el botó Penalitzacions obrirà aquesta finestra on podreu introduir les penalitzacions. Això es pot fer en qualsevol moment independentment del mecanisme de puntuació normal.

La selecció Infracció: mostrarà totes les infraccions que poden ser aplicables a les mans que sostenen els jugadors. Trieu entre elles.

Ara podreu adaptar la Penalització total. Aquesta és la suma total que es transferirà des dels pagadors als beneficiaris. Es dividirà uniformement entre ells.

Depenent del tipus d'infracció, el nombre de pagadors i beneficiaris variarà. Es mostra el nombre correcte de jugadors. Si seleccioneu un jugador, el &kajongg; s'assegurarà que aquest jugador només esdevingui un cop adaptant els altres jugadors.

## Jugar

En qualsevol moment, podreu activar o desactivar el mode de demostració. En aquest mode, l'ordinador jugarà per vostè. Si actualment no jugueu cap joc, s'iniciarà un de nou amb l'últim joc de regles utilitzat.

### Jugar contra l'ordinador

Primer obtindreu un diàleg d'inici de sessió. Introduïu el servidor de joc amb el qual voleu connectar i el vostre nom d'usuari. Si escolliu l'entrada especial Joc local, només necessitareu introduir el vostre nom (o acceptar el nom proposat) i el joc de regles desitjat. Això iniciarà immediatament un joc local on jugareu contra 3 jugadors robot. No obstant això, si hi ha jocs suspesos, es mostraran en una llista. A continuació, podreu seleccionar el joc amb el qual voleu continuar o començar-ne un de nou.

### Jugar amb amics

Si voleu jugar contra altres persones reals, necessitareu un servidor de joc on tots els jugadors, inclòs vós, haureu de connectar-vos. Feu-ho seleccionant qualsevol altre amfitrió o introduint manualment un nom nou d'amfitrió i especificant la contrasenya per a aquest. Es proposarà la darrera contrasenya utilitzada.

La manera més senzilla és utilitzar el servidor de joc a `kajongg.org` . El &kajongg; mostrarà aquest a la llista de possibles servidors de joc. Recordeu que aquest servidor només ofereix un servidor de joc, però no una pàgina web ni cap altre servei.

Si no teniu un compte al servidor de joc amb el nom que heu introduït, se us demanarà si voleu obrir un compte. Si dieu que sí, apareixerà un diàleg nou on podreu introduir la contrasenya desitjada dues vegades. El vostre compte es crearà automàticament.

Després d'iniciar la sessió correctament amb el servidor de joc, obtindreu una llista de taules amb seients disponibles en aquest servidor de joc. Uniu-vos a una taula o assigneu una taula nova. Si assigneu una taula nova, espereu fins que els altres jugadors ocupin més seients. En qualsevol moment podreu començar el joc en una taula que hàgiu pres, els seients no ocupats seran ocupats per jugadors robot.

La llista de la taula també mostra el nom del joc de regles que es juga en aquesta taula. El joc de regles i el seu nom són enviats al servidor de joc pel jugador que inicialitza la taula. Si teniu un joc de regles idèntic, la taula mostrarà el seu nom per al joc de regles -això podria ser útil si l'iniciador de la taula parla un altre idioma i ha anomenat el joc de regles d'una manera diferent-. A més, si es mostra el nom del vostre joc de regles local, es mostrarà en negre. No obstant això, si no teniu un joc de regles idèntic, el nom apareixerà en vermell i podreu utilitzar el botó Compara per a comparar-lo amb els vostres propis jocs de regles.

Si no utilitzeu `kajongg.org` o qualsevol altre servidor de joc existent, podreu iniciar el vostre propi servidor de joc del &kajongg; de dues formes diferents:

- connecteu-vos amb el servidor `localhost`. Aquest és el vostre propi ordinador. Si feu això i no s'està executant cap servidor de joc, s'iniciarà automàticament. I quan deixeu de jugar, el servidor també s'aturarà. Això es diferencia de seleccionar Joc local en el fet que aquest últim no permet connexions des d'altres ordinadors.

- inicieu manualment un servidor en qualsevol ordinador que vulgueu. Tot el que heu de fer és anar a una línia d'ordres i iniciar el programa `kajonggserver`. Introduïu `kajonggserver --help` i us mostrarà totes les opcions disponibles, com canviar el port predeterminat. Aquest servidor s'executarà fins que el mateu.

En ambdós casos, haureu de dir als altres jugadors com poden arribar al vostre servidor de joc. Necessitaran l'&URL; o senzillament una adreça IP i el port on està escoltant el servidor. Això podria ser quelcom com `mypc.dyndns.org:8301` , on `8301` és el port. Per descomptat, haureu de configurar el vostre tallafoc de manera que el jugador remot pugui abastar aquest port. La comunicació estarà encriptada.

Per a obtenir el número de port, vegeu Ajuda Quant al &kajongg;. La versió del protocol és el número del port. Per al &kajongg; 21.4.1, és el 8301. Si el jugador no introdueix cap port per al servidor de joc desitjat, el client calcularà el port de la mateixa manera. Per tant, si un ordinador executa diversos servidors de joc amb diferents versions de protocol, normalment hauria d'arribar al servidor de joc correcte de manera automàtica. De totes maneres, el servidor de joc i el client s'hauran d'assegurar que les seves versions siguin compatibles i us advertiran el contrari.

Si trobeu possibles errors, possiblement voldreu utilitzar l'opció `kajongg --debug=traffic`. Això us mostrarà, a la consola on s'ha iniciat el servidor de joc, quins missatges flueixen entre el servidor de joc i els clients. Per a obtenir més opcions, vegeu `kajongg --help`

#### Advertències

- Si voleu assegurar-vos que ningú pugui enganyar, cap dels jugadors humans haurà de tenir accés a l'ordinador en la qual s'executa el servidor de joc. Per descomptat, mai podreu evitar que dos jugadors s'ajudin entre si perquè no es pot saber el que en realitat estan fent. Dos jugadors poden ser fins i tot la mateixa persona.

### Les regles del joc

Arreu del món, hi ha moltes variants de joc diferents. Actualment, el &kajongg; admet dues variants del xinès clàssic, una que es juga a Alemanya i una altra que es juga a la Gran Bretanya.

Aquesta descripció no entra en detalls i, com a tal, coincideix amb les dues variants.

No obstant això, la majoria de les regles bàsiques són les mateixes en la majoria de les variants.

Atès que el programa &kajongg; sap com jugar, aquesta descripció només conté coses que podrien no ser òbvies.

Si voleu aprendre Mah Jong amb més detall, consulteu la bibliografia.

#### L'objectiu del joc

Cada jugador intenta recollir les fitxes de manera que obtingui una mà guanyadora. En aconseguir-ho, ell/a cridarà «Mah Jong». En una mà guanyadora, les fitxes normalment s'agruparan en cinc combinacions: quatre combinacions amb tres o quatre fitxes cadascuna i una cinquena combinació que consistirà en dues fitxes iguals. Una combinació normal té tres o quatre fitxes idèntiques (anomenades Pung i Kong respectivament) o tres fitxes successives com Bambú 3, Bambú 4, Bambú 5 (anomenades Chow).

#### El curs del joc

Inicialment, el jugador amb el vent de l'est (com s'indica a la paret) tindrà una fitxa més que els altres jugadors. Aquest començarà descartant una fitxa no desitjada.

Sempre que es descarti una fitxa, els altres jugadors podran reclamar-la dient el que poden completar amb aquesta fitxa (Chow, Pung, Kong, Mah Jong). Només el següent jugador podrà reclamar un Chow -la resta de reclams seran possibles per a tots els jugadors-. S'exposarà una combinació completada per a un reclam -visible per a tots els jugadors-.

Si ningú reclama la fitxa descartada, el jugador següent, Sud (i després Oest i Nord) obtindran una fitxa de la paret i descartaran una fitxa no desitjada.

Hi ha diverses regles sobre quan es pot estendre un Pung a un Kong (reclamant la quarta fitxa o traient-la de la paret) -aquestes regles no s'expliquen aquí-. Però el &kajongg;, per descomptat, les coneix i s'assegura que siguin respectades. Si es declara un Kong, el jugador obtindrà automàticament una fitxa de substitució des de la paret -d'altra manera, no seria possible construir les cinc combinacions com s'ha esmentat anteriorment-.

#### Any, tanda i mà

Quan un jugador reclama Mah Jong o acabem en taules, es completarà una mà. Ara, excepte per als sortejos, els vents giraran entre els jugadors. Això es repetirà fins que cada jugador obtingui una vegada cada vent. Tota aquesta unitat s'anomena tanda. Un joc complet, també anomenat any, consta de quatre tandes d'aquest tipus: tanda de vent de l'est, tanda de vent del sud, tanda de vent de l'oest, tanda de vent del nord. El vent d'una tanda també s'anomena vent predominant, pot resultar en puntuacions més altes.

Llavors, un joc complet (un any) consisteix d'almenys 16 mans. Atès que els vents no giren per a les taules o quan el jugador de l'est diu Mah Jong, normalment es necessitarà un major nombre de mans per a un joc complet.

#### Fitxes de bonificació

Un joc pot contenir 8 fitxes de bonificació (llevat que les regles les excloguin). S'exposen per separat en el costat dret de la regió del jugador, ja que mai s'utilitzen per a construir les combinacions. No obstant això, generen punts de bonificació.

Si un jugador obté una fitxa de bonificació, automàticament també obtindrà una fitxa de substitució des de la paret. I sonarà una campana.

#### Puntuació

Al final d'una mà, es calcularà la puntuació de cada jugador. Primer, els punts bàsics es compten com 2 punts per un pung exposat senzill o 20 punts per guanyar. A continuació, s'aplicarà un altre joc de regles -aquestes regles poden duplicar els punts com un doble per a una combinació de dracs-. Quan es coneix la puntuació de cada mà, es paguen les diferències entre els jugadors -mentre que el guanyador rep la puntuació completa de tots els altres jugadors-. L'est sempre rebrà i pagarà el doble de la seva puntuació.

Per descomptat, el &kajongg; coneix totes les regles aplicables, però un bon jugador sabrà quines combinacions obtenen quina puntuació per a poder optimitzar. Mentre s'aprèn, es recomana activar la finestra Explica les puntuacions.

Les regles de puntuació exactes sovint varien -en el &kajongg; podreu canviar-les amb l'editor del joc de regles -.

L'editor del joc de regles també mostra totes les regles disponibles i el seu significat. Situeu el ratolí a sobre seu i per a les regles més exòtiques apareixerà un text d'ajuda.

### Com jugar amb el &kajongg;

Se us demanarà què voleu fer. Aquest és un petit diàleg que apareix a la dreta o a la part inferior depenent de la mida de la finestra. Si el feu més ample que alt, el diàleg apareix a la dreta. De vegades, el diàleg tindrà un temps d'espera -quan acabeu, se seleccionarà automàticament la primera resposta possible-. Aquest temps d'espera es pot configurar a l'Editor del joc de regles, a Opcions, S'esgota el temps de reclamació (Claim Timeout). Tots els jugadors hauran de tenir el mateix temps d'espera, per això forma part del joc de regles.

Si heu de seleccionar una fitxa de la vostra mà, podreu moure-us entre les fitxes amb les tecles de &Right; i &Left; o les lletres h i l en el vostre teclat. Per descomptat, també podreu utilitzar el ratolí.

Podreu descartar una fitxa utilitzant el teclat de la mateixa manera que per a totes les accions. De manera alternativa, podreu utilitzar el ratolí i moure la fitxa des de la vostra mà fins a l'àrea de descarts (l'interior de les parets). La ubicació de la fitxa en l'àrea de descarts la realitzarà l'ordinador, perquè la ubicació haurà de ser la mateixa per als jugadors.

Sovint, els diàlegs oferiran opcions que no són realment aplicables, com cridar Pung quan no es tenen les fitxes necessàries. Això està previst, com en un joc real. Però podeu configurar opcions impossibles: Inhabiliteu Mostra només les accions possibles a la pàgina Juga del diàleg de configuració.

Les fitxes rebutjades es col·loquen a l'atzar entre les parets. Algunes variants del joc defineixen a on s'han de col·locar les fitxes, però, això encara no es pot configurar. Quan es torni configurable, formarà part del joc de regles.

## Resum de la interfície

### Elements de menú

&Ctrl;C Joc Puntuació d'un joc manual

- Només anotarà un joc jugat manualment.

  Podeu carregar un joc antic o iniciar-ne un de nou. De manera predeterminada, només els jocs pendents (&ead;, sense finalitzar) es mostren a la llista de selecció. De manera opcional, podreu mostrar tots els jocs, inclosos els finalitzats. Aquí també podreu suprimir jocs.

&Ctrl;N Joc Juga

- Juga amb un altre (persones i ordinadors).

&Ctrl;W Joc Interromp la partida

- Interromp el joc actual. Si era un joc manual únicament amb la puntuació, el podreu reprendre més tard. Si heu jugat emprant el &kajongg;, el joc encara no es pot reprendre.

&Ctrl;Q Joc Surt del &kajongg;

- Surt del &kajongg;.

&Ctrl;H Visualitza Xat

- Xat

  Finestra de xat Finestra de xat

  Permet que feu un xat amb els altres jugadors.

&Ctrl;T Visualitza Taula de puntuacions

- Taula de puntuacions

  Taula de puntuacions Captura de pantalla

  Mostra la taula de puntuació. Tanda/mà són la tanda actual (Est, Sud, Oest, Nord) seguit d'un recompte de les mans jugades en aquesta tanda. La guanyadora té un fons verd per als seus valors. Els pagaments mostren quant ha pagat o rebut el jugador a/de tots els altres jugadors amb aquesta mà. El saldo mostra el saldo actual de tots els jugadors. El gràfic mostra l'evolució dels valors de balanç. Els consells donen més detalls: mostren totes les regles que s'han aplicat a aquesta mà. Senzillament moveu el ratolí a sobre del valor que us interessa.

  La part inferior mostra el joc de regles utilitzat. Entre la taula de puntuacions i el joc de regles utilitzat, trobareu un divisor que permet canviar les mides relatives d'ambdues parts.

&Ctrl;E Visualitza Explica les puntuacions

- Explica les puntuacions

  Taula de puntuacions Taula de puntuacions

  Explica com s'ha calculat la puntuació de la mà actual.

&Ctrl;&Maj; F Visualitza Mode de pantalla completa

- Canvia entre els modes de pantalla completa i normal.

Arranjament Jugadors

- Afegeix, modifica i suprimeix els jugadors.

  Les contrasenyes en aquesta taula són les que s'utilitzen de manera predeterminada en iniciar la sessió en un servidor de joc. Canviar la contrasenya triada inicialment per a un servidor de joc encara no és realment útil perquè encara no hi ha manera que també es canviï la contrasenya en el servidor de joc. Hauríeu de demanar-li a l'administrador del servidor de joc que ho faci per vostè directament a la base de dades.

Arranjament Jocs de regles

- Personalitza els jocs de regles.

  Utilitzeu l'Editor dels jocs de regles per a personalitzar-los. Per a obtenir més informació, vegeu aquí.

&Ctrl;G Arranjament Canvia l'angle visual

- Canvia l'angle de visió de les fitxes en sentit antihorari.

&Ctrl;D Arranjament Mode demostració

- Activa o desactiva el mode de demostració. Per a més detalls, vegeu aquí.

De manera addicional, el &kajongg; té la configuració comuna al &kde; i els elements dels menús Arranjament i Ajuda. Per a obtenir més informació, llegiu les seccions sobre El menú Arranjament i El menú Ajuda en els Fonaments del &kde;.

## Configuració del joc

El diàleg de configuració El diàleg de configuració

L'entrada de menú Arranjament Configura el &kajongg;... obre el diàleg Configura - &kajongg;.

Si premeu aquí el botó Cancel·la, tots els canvis de configuració es revertiran, inclosos tots els que heu fet amb l'editor del joc de regles.

També podeu seleccionar les diferents pestanyes amb el teclat: &Ctrl;1 selecciona la primera pestanya d'opcions Juga, &Ctrl;2 selecciona la segona pestanya, i així successivament.

### Opcions del joc

Mostra les ombres

- Mostra les fitxes amb vores i ombres. També hi ha una mica d'espai entre les files de fitxes, i les fitxes de la paret es mostren de manera que veureu que la paret té dues o tres fitxes d'alçada. Llavors, si desactiveu aquesta opció, tindreu una pantalla més senzilla amb fitxes una mica més grans. Això podria ser útil per a pantalles petites.

Reorganitza les fitxes ocultes a les combinacions

- Agrupa les combinacions a la mà. De vegades, és possible que l'agrupació no sigui com la que es vol, i per això és possible que preferiu no tenir cap agrupació, com en un joc del món real.

Mostra només les accions possibles

- Quan es juga, només es mostraran les accions possibles com «No hi ha reclamacions» o «Pung».

Proposa què fer

- Sempre que es tingui una opció d'acció com reclamar o no una fitxa, o triar quina fitxa descartar, el &kajongg; podrà ajudar fent-vos una proposta.

Usa els sons si estan disponibles

- Permet escoltar els descarts i les reclamacions. Si els altres jugadors han enregistrat fitxers de so amb la seva pròpia veu, podreu escoltar-los.

Deixa que els altres escoltin la meva veu

- Si heu enregistrat fitxers de so amb la vostra veu, aquesta opció permetrà que els altres jugadors escoltin els vostres descarts i reclamacions amb la vostra veu.

Velocitat de l'animació:

- Defineix com de ràpid s'hauran de moure les fitxes. Si moveu el control lliscant a la posició més a la dreta, el moviment de les fitxes no s'animarà: les fitxes senzillament canviaran de lloc.

#### So

Jugar brinda una experiència molt millor si escolteu als jugadors reclamar les fitxes i anunciar els descarts. També facilita el joc perquè podreu concentrar-vos en les vostres pròpies fitxes, no haureu de mirar el que descarten els altres.

El &kajongg; ve amb veus per a jugadors diferents. Assigna automàticament les veus als jugadors. Per a cada idioma hi haurà d'haver quatre veus, preferiblement dues masculines i dues femenines. El &kajongg; intentarà utilitzar les veus en el mateix idioma en què s'executa. Si no les troba en aquest idioma, el &kajongg; recorrerà a altres idiomes, utilitzant els mateixos idiomes de suport que heu definit per al &kajongg; (vegeu Ajuda Canvi de l'idioma de l'aplicació). Si encara no existeix cap fitxer de veu per al vostre idioma, se us convida a enregistrar-los i contribuir al &kajongg;.

- Així és com podreu generar les veus vós mateix. Hi ha una carpeta separada per a cada veu. Recordeu que aquestes carpetes poden estar en un altre lloc al sistema, depenen de com es va instal·lar el &kde;. Només la part que comença amb `kajongg` és sempre la mateixa. Hi ha dos grups de veus amb diferents llocs en el sistema de fitxers:

  - Veus predefinides per a cada idioma. Resideixen en una carpeta com `/usr/share/kajongg/voices/LANG` on LANG és el codi per al vostre idioma. Els directoris de veu directament sota `.../kajongg/voices/` són les versions en anglès dels EUA. Les veus predefinides s'assignaran de forma aleatòria als jugadors. Aquestes veus tenen noms com «`male1 male2 female1 female2` », però aquests noms no importen, l'usuari mai els veurà.

  - Les veus d'usuari es poden definir per a un usuari específic. Si el &kajongg; fa ús d'aquesta veu, es podrà transferir automàticament a altres jugadors a través d'Internet. Aquestes veus resideixen en una carpeta com `~/.local/share/apps/kajongg/voices/` . De manera que, si el vostre nom d'inici de sessió és jordi, aquest podria ser `/home/jordi/.local/share/apps/kajongg/voices/jordi/` . És possible que la carpeta `voices/` encara no existeixi, si és així, creeu-la.

- Ara que sabeu on col·locar la vostra veu nova, genereu una carpeta nova per a ella.

- En aquesta subcarpeta, podreu ubicar els fitxers de so. Hauran d'estar codificats amb el compressor d'àudio Ogg Vorbis, els noms dels fitxers hauran de tenir l'extensió `.ogg`. Un sol fitxer té un nom com `s3.ogg` -aquest és Stone 3 (pedra)-. Haureu de definir aquests fitxers per a totes les fitxes i per a totes les reclamacions i els anuncis. Però si cal un fitxer de so, no passa res, senzillament no el sentireu. El recurs per a altres veus o idiomes només funciona per a les veus completes, no per a fitxers de so individuals.

- Una vegada s'han definit tots els fitxers de so per a una veu predefinida, assegureu-vos que el procés del &kajongg; tingui permís d'escriptura en la carpeta nova de veus. Inicieu el &kajongg; i proveu la veu. Una vegada tot estigui bé, podreu revocar el permís d'escriptura (i s'ha de fer per a les veus predefinides). El &kajongg; generarà automàticament un fitxer anomenat `md5sum` que contindrà una suma de verificació sobre tots els fitxers de so. Sempre que es canviï, afegeixi o suprimeixi un fitxer de so per a una veu, el &kajongg; intentarà reescriure aquest fitxer.

Si us plau, reduïu la durada del so, però parleu amb claredat -aquest joc es pot jugar molt de pressa una vegada hi esteu acostumat-. És més fàcil si primer escriviu una llista amb tot el que s'ha de pronunciar. No ho llegiu com una seqüència d'elements, mireu de pronunciar cada element com si fos únic i com ho faríeu en jugar. Deixeu espai entre els elements. Llegir-ho requereix una mica de pràctica.

Aquesta és només una possibilitat per a crear els fitxers de so:

- Enregistreu un fitxer de so amb el programa `qarecord`, deseu-lo en el format WAV. En aquest únic fitxer de so, pronuncieu tots els sons.

- Editeu aquest fitxer amb l'editor de so `audacity`. En aquest editor, utilitzeu el ratolí per a marcar un interval d'ones sonores. L'editor reproduirà aquesta part. Repetiu-ho fins que hàgiu seleccionat la part correcta. Això pot ser més fàcil si feu Visualitza Apropa. Utilitzeu l'element de menú Fitxer Exporta la selecció i deseu-la en el format `.ogg`. A Opcions, escolliu qualitat baixa -això serà suficient i fins i tot desitjable perquè redueix el temps per a transferir els sons als altres jugadors-.

Els següents són els noms dels fitxers que heu de generar. Afegiu sempre l'extensió `.ogg`:

#### Noms dels fitxers de so

&s1; .. &s9; | Pedra 1 a Pedra 9
&b1; .. &b9; | Bambú 1 a Bambú 9
&c1; .. &c9; | Caràcter 1 a Caràcter 9
&we; &ws; &ww; &wn; | Els vents de l'est, sud, oest, nord
&db; &dr; &dg; | Els dracs blau/blanc, vermell, verd
&chow; &pung; &kong; &mahjongg; | Les reclamacions principals
&originalcall; &violatesoriginalcall; | Crida original i la seva infracció
&dangerousgame; | Un jugador deixa anar un canó (joc perillós)
&nochoice; | Un jugador declara que no té més remei que jugar un joc perillós

### Opcions de les fitxes

Selector de fitxes Selector de fitxes

Utilitzeu el selector de Fitxes per a seleccionar els gràfics per a les fitxes.

### Opcions del fons

Selector del fons Selector del fons

Utilitzeu el selector de Fons per a seleccionar un gràfic de fons per al joc.

Alguns fons com el paisatge xinès necessiten una mica de temps per a carregar-se. Si creieu que el programa hauria d'iniciar-se més ràpid o canviar la mida de la finestra principal triga massa temps, proveu amb un altre fons.

### Editor del joc de regles

Editor del joc de regles Editor del joc de regles

Utilitzeu l'editor del joc de regles per a personalitzar-los. Els jocs de regles predefinits es mostren en cursiva, els jocs de regles personalitzats tenen una lletra normal. L'usuari no podrà canviar de cap manera els jocs de regles predefinits, però, una actualització del &kajongg; podria fer-ho. Els jocs de regles personalitzats mai es veuran afectats per una actualització.

Quan s'inicia un joc nou, podreu seleccionar un joc de regles per a aquest joc. Es poden utilitzar tots els jocs de regles definits en l'editor del joc de regles. El joc de regles es desa juntament amb el joc, de manera que sempre el podreu canviar aquí -els vostres canvis només afectaran els jocs futurs-.

#### Regla, punts, x2, límits

Senzillament, feu doble clic sobre la que voleu canviar. Si es netegen tots els valors, aquesta regla no tindrà cap influència en el joc. Les regles no es poden suprimir.

#### Copiar i eliminar

Podeu copiar i eliminar jocs de regles sencers.

De nou, això es pot fer fins i tot si els jocs existents utilitzen aquest joc de regles, ja que cada joc té la seva pròpia còpia del joc de regles. Es poden veure els jocs de regles per als jocs antics: carregar el joc antic i mostrar la seva taula de puntuacions.

#### Comparar

Comparador dels jocs de regles Comparador dels jocs de regles Podeu seleccionar aquesta ordre quan se selecciona un joc de regles sencer. Permet comparar el joc de regles seleccionat amb qualsevol altre joc de regles.

### Dreceres predeterminades

Les dreceres predeterminades són les següents:

F1

- Mostra aquest manual.

&Ctrl;C

- Permet dur la puntuació d'un joc manual.

&Ctrl;N

- Juga un joc amb amics o jugadors d'ordinador.

&Ctrl;W

- Interromp la partida actual.

&Ctrl;Q

- Surt del programa.

&Ctrl;T

- Mostra la taula de puntuacions.

&Ctrl;H

- Mostra una finestra de xat.

&Ctrl;G

- Canvia l'angle de visió.

&Ctrl;D

- Activa o desactiva el mode de demostració.

&Maj;F1

- L'ajuda «Què és això?».

&Ctrl;&Maj;F

- Mode de pantalla completa.

## Problemes coneguts

- En el mode de joc, encara no són possibles les penalitzacions.

- Els jugadors de l'ordinador segueixen sent força estúpids.

## Possibles característiques futures

- Afegir més jocs de regles. De manera opcional, això hauria de ser realitzat per persones que utilitzin aquests jocs de regles amb regularitat.

## Preguntes més freqüents

Vull canviar l'aparença d'aquest joc. Puc fer-ho?

Sí. Per a canviar l'aparença del &kajongg;, empreu la barra de menús per a obrir la utilitat de configuració.

Puc utilitzar el teclat per a assignar fitxes als jugadors?

Sí. Vegeu Fer que el &kajongg; calculi la puntuació.

## Crèdits i llicència

&kajongg; per al &kde;

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

Copyright de la documentació © 2009-2017 &Wolfgang.Rohdewald; &Wolfgang.Rohdewald.mail;

Traductor de la documentació: &credits.Antoni.Bella;

&underFDL; &underGPL;

## Bibliografia

- «Das Chinesische Mah-Jongg-Spiel» per en Uwe Martens el 2005, «Books on Demand» de GmbH, Norderstedt. Aquest llibre és una excel·lent referència en alemany que conté tot el que voldreu saber sobre les regles emprades a Alemanya i molts altres aspectes del joc.

- «The Complete Book of Mah-Jongg» per en A. D. Millington el 1977 (amb diverses edicions de butxaca fins al 2003), «Weidenfeld & Nicolson», Londres. Aquesta és la màxima referència per al Mah Jong de xinès clàssic tal com es juga en el món occidental. Ofereix valuosos consells sobre les estratègies de joc.

- «Mah-Jong» per en Gwyn Headley i na Yvonne Seeley, tercera edició, 2008, «A & C Black Publishers Ltd», Londres. Aquest llibre és una referència molt fàcil d'emprar, es concentra en les regles que s'utilitzen a la Gran Bretanya, definides per la BMJA (l'associació britànica de Mah Jong).

## Instal·lació

Per a Linux: La vostra distribució ja l'hauria de tenir empaquetat.

Per a Windows: per a obtenir un instal·lador de Windows, vegeu https://www.linux-apps.com/p/1109453/.

Si voleu descarregar el codi font i instal·lar-lo manualment:

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

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

- Per a Windows: llegiu el fitxer `README.windows`

El &kajongg; depèn d'aquests paquets: (noms de paquets entre parèntesis de la Debian)

- Python 3.8 o superior (python3)

- Qt6.5 o superior (python3-pyqt6 i python3-pyqt6.qtsvg)

- els lligams de Python per a les Qt6 (python3-pyqt6)

- la biblioteca twisted de Python 16.6.0 o superior (python3-twisted)

- sqlite3 (libsqlite3-0)

&documentation.index;