# Handbok &kajongg;

## Inledning

### Speltyp:

Brädspel, spelhall

### Antal möjliga spelare:

Fyra

&kajongg; är ett brädspel skapat efter det berömda orientaliska spelet Mah Jong (från kinesiskans 麻將). Det spelas av fyra spelare. Det finns många olika regeluppsättningar runt om i världen. För närvarande stöder &kajongg; de klassiska kinesiska reglerna, som de tillämpas i Tyskland. I framtiden kommer ytterligare huvudregler att följa. Det är möjligt att anpassa eller lägga till nya regeluppsättningar. Gör gärna det och skicka dem till programmets upphovsman för integrering.

&kajongg; kan användas på två olika sätt: Poängsätta ett manuellt spel där du spelar som vanligt utan hjälp av en dator och använder &kajongg; för att beräkna poäng och bokföring. Eller kan du använda &kajongg; för att spela mot vilken kombination som helst av mänskliga eller datorspelare.

## Skärmutläggningen

En skärmbild av &kajongg; Skärmbild

En kort förklaring av spelplanens delar.

Verktygsrad

- Verktygsraden finns under menyraden och innehåller knappar för de oftast använda åtgärderna. Verktygsradens innehåll kan redigeras. Du kan också göra den osynlig, vilket ger större utrymme på skärmen för brädet.

  Beroende på din skärmstorlek kanske du vill göra verktygsraden osynlig, eller flytta den till fönstrets vänstra sida. Du åstadkommer det genom att klicka med höger musknapp på verktygsraden.

Bräde

- Brädet är den största delen av fönstret. De fyra mursidorna med längden 18 brickor syns (det exakta antalet beror på reglerna, som om bonusbrickor används eller inte). Spelarnas namn är skrivna på mursidorna, tillsammans med handens aktuella värde (så långt det är känt) och deras vindbrickor. Den rådande vinden har en färgad bakgrund. I skärmbilden ovan är det Östan.

  Under spelet samlas brickorna som spelarna kastar innanför murarna. De placeras slumpmässigt. Den senast kastade brickan har en blå fokusram.

  När manuella spel poängsätts, finns ett urval av alla tillgängliga brickor innanför muren, det centrala urvalet. Du kan tilldela dem till spelarna med musen eller tangentbordet.

Spelarens område

- Varje spelare har ett område på skärmen för sina brickor. Den övre raden innehåller öppna brickor, den under raden dolda. Vid poängsättning av manuella spel visas dolda brickor med en skugga över hela brickan. Bonusbrickor hamnar längst till höger.

Dialogruta

- Dialogrutan visar valen som spelaren har. Oftast har den en tidsgräns, med en förloppsrad som visar återstående tid.

Statusrad

- Statusraden finns längst ner på skärmen, och innehåller spelarnas aktuella behållning.

## Poängsätta ett manuellt spel

I detta läge används &kajongg; bara för att göra poängberäkningen. Du spelar som vanligt mot verkliga personer på ett verkligt bord, och i slutet av spelet kan du tala om för &kajongg; vilka brickor en spelare har i sin hand och allt annat som &kajongg; behöver veta för att beräkna poängen, vilket är vad programmet gör. Som alternativ kan du beräkna händernas poäng manuellt och skriva in dem. &kajongg; fördelar därefter betalningar mellan spelarna och skriver in resultaten i en databas. Det är möjligt att tillfälligt avbryta ett spel, starta ett annat spel med andra spelare, och återuppta gamla spel. Alla regler sparas tillsammans med spelen, så olika spel kan spelas med olika regler.

- Välj Spel Poängsätt spel manuellt i menyn, eller tryck på &Ctrl;C.

- Nu kan du antingen välja ett befintligt inte färdigt spel eller starta ett nytt spel. Om du startar ett nytt spel, blir du tillfrågad om spelarna och regeluppsättningen. &kajongg; föreslår samma värden som användes i det förra spelet. Om det inte finns något föregående spel, föreslås de första fyra definierade spelarna. Observera att du inte kan ändra regeluppsättningen eller någon av dess regler efter detta val. Du kan göra det i förväg i inställningsverktyget.

- Nu får du ett nytt fönster som heter Skriv in omgångens resultat. Läs Låt &kajongg; beräkna poängen för en detaljerad beskrivning.

- Efter att ha sparat handens resultat, fortsätt med nästa hand.

### Skriva in omgångsresultat

#### Poäng

En skärmbild av &kajongg; Skärmbild

Det här är fönstret där händernas resultat skrivs in. Det visas automatiskt när &kajongg; tror att det behövs. Du kan alltid visa eller dölja det genom att trycka på &Ctrl;S eller genom att använda motsvarande menyalternativ.

Som alltid har rådande vind sin bakgrund färgad.

Här kan du manuellt mata in poäng för alla spelare. Som ett alternativ kan du exakt definiera vilka brickor en spelare hade i handen. Om du väljer att göra det, inaktiveras motsvarande fält för det manuella poängvärdet. &kajongg; beräknar automatiskt poängen.

Efter att ha skrivit in all relevant data för en hand, klicka på knappen Spara hand. Handens värden skrivs in i databasen, och de visas också i poängtabellen. Du kan bli tillfrågad om att ändra spelarnas platser, men du kan välja att inte göra det. De föreslagna ändringarna går för närvarande inte att anpassa. Om någon regeluppsättning behöver något annorlunda, kommer vi att ändra det.

Om spelaren kan ha vunnit, är kryssrutan i kolumnen Vinnare aktiverad. Klicka på den för vinnaren.

Statusraden visar nu spelarnas uppdaterade behållning, och du kan fortsätta med nästa omgång.

##### Skriv in poängen för hand

En bra spelare föredrar troligen att beräkna sina egna poäng. I detta fall kan du skriva in det direkt. Det är bara möjligt när inga brickor är valda för spelaren.

Om du skriver in poäng för hand, måste de redan innehålla allt utom straff. Du får inga valfria regler att välja bland. Det finns ett undantag: Farligt spel. Det påverkar inte några poäng, och ger heller inget straff. Det betyder bara att betalning mellan spelare är annorlunda: Den bestraffade betalar allt för allt till vinnaren. De övriga två spelarna gör inga betalningar. Det är för närvarande inte möjligt att anpassa.

##### Låt &kajongg; beräkna poängen

Om du uttryckligen talar om för &kajongg; vilka brickor en spelare har, blir inmatningen av poäng inaktiverad för spelaren i det här fönstret. Medan brickor tilldelas en spelare, ser du hur poängen ökar, men så fort du lägger till den 14:e brickan blir resultatet noll. Det kan förvåna dig, men om du inte deklarerar handen som vinnare, betraktas den som en lång hand som alltid har noll poäng. Beteendet definieras av de klassiska kinesiska reglerna, och kan vara annorlunda om du ändrar reglerna eller använder en annan regeluppsättning.

Du kan definiera brickor och kombinationer för en spelare med musen, tangentbordet, eller båda. Flytta helt enkelt brickor med musen genom att dra och släppa dem i spelarens område. När brickan släpps, blir du tillfrågad om vad du vill flytta: Ensam, par, pong, kong, kungjord kong eller chi. Den övre raden är till för öppna brickor, och den undre raden för dolda brickor. Bonusbrickorna visas längst till höger. Du kan också flytta brickor och kombinationer mellan rader, mellan spelare och tillbaka till det centrala urvalet.

Om du föredrar att använda tangentbordet, kan du använda tabulator för att gå mellan det centrala urvalet och spelarnas händer. Tangenterna ösvnÖSVN flyttar en bricka till spelarna östan, sunnan, västan och nordan. Tangenterna xX flyttar tillbaka den till det centrala urvalet. ÖSVN flyttar till den dolda raden, medan ösvn flyttar till den öppna raden. Du kan flytta markören mellan brickor eller kombinationer med piltangenterna, och brickan eller kombinationen som för närvarande är markerad har en blå ram. Eftersom piltangenterna är långt bort från bokstäverna på tangentbordet, kan du också använda bokstäverna hjkl eller HJKL för att flytta markören. hH går åt vänster, jJ går neråt, kK går uppåt och lL går åt höger. Det är sättet som Unix-editorn `vi` använder. &kde;:s webbläsare &konqueror; och även det här hjälpprogrammet stöder tangenterna på samma sätt. Tangenterna kan vara annorlunda om du använder ett annat språk än engelska, men det är för närvarande inte möjligt att ställa in dem.

Alternativen Sista brickan och Sista kombinationen behövs av vissa regler som Sista brickan bildar par. De kan bara användas för vinnarens hand.

På höger sida av fönstret kan du verkställa vissa regler manuellt. Vilka regler som visas i listan beror på aktuell regeluppsättning och på brickorna. I exemplet från skärmbilden ovan, kan spelarna som förlorar ha alternativet Farligt spel, återigen beroende på regeluppsättning och på deras brickor. Det är utvecklarnas mål att hålla den här listan med manuellt valda regler så kort som möjligt. I bästa fall ska &kajongg; alltid automatiskt kunna bestämma om en regel gäller, men ibland har inte &kajongg; tillräckligt med information eller kunskap för att kunna bestämma.

#### Straff

En skärmbild av &kajongg; Skärmbild

I fönstret för att skriva in omgångsresultat, visas det här fönstret där du kan skriva in straff av knappen Straff

Rutan Regelbrott: visar alla regelbrott som kan gälla för händerna som spelarna har. Välj bland dem.

Nu kan du anpassa Totalt straff. Det är den totala summan som flyttas från betalarna till betalningsmottagarna. Den kommer att delas jämnt mellan dem.

Beroende på typ av regelbrott, varierar antal betalare och betalningsmottagare. Det rätta antalet spelare visas. Om du väljer en spelare, försäkrar sig &kajongg; om att spelaren bara finns en gång, genom att anpassa övriga spelare.

## Att spela

Du kan när som helst aktivera eller inaktivera demonstrationsläget. I demonstrationsläget spelar datorn åt dig. Om inget spel för närvarande pågår, startas ett nytt spel med den senast använda regeluppsättningen.

### Spela mot datorn

Först visas en dialogruta för inloggning. Skriv in spelservern du vill ansluta till och ditt användarnamn. Om du väljer det särskilda värdet Lokalt spel behöver du bara skriva in ditt namn (eller acceptera det föreslagna namnet) och önskad regeluppsättning. Det påbörjar omedelbart ett lokalt spel där du spelar mot tre robotspelare.

### Spela med vänner

Om du vill spela mot andra människor, behövs en spelserver som alla spelare, inklusive du själv, måste ansluta till. Gör det genom att välja vilken annan värddator som helst, eller manuellt skriva in ett nytt värddatornamn och ange lösenord för den värddatorn. Det senast använda lösenordet föreslås.

Det enklaste sättet är att använda spelservern på `kajongg.org`. &kajongg; visar den i listan med möjliga spelservrar. Observera att för tillfället erbjuder den bara en spelserver, men ingen webbsida eller några andra tjänster.

Om du inte har ett konto på spelservern med namnet du skrev in, blir du tillfrågad om du vill öppna ett konto. Om du svarar ja, visas en ny dialogruta där du kan skriva in önskat lösenord två gånger. Ditt konto skapas automatiskt.

Efter att ha lyckats logga in på spelservern, får du en lista över bord med tillgängliga platser på spelservern. Gå med ett bord eller reservera ett nytt bord. Om du reserverar ett nytt bord, vänta till flera platser är tagna av andra spelare. Du kan starta spelet på ett bord du reserverat när som helst, så tilldelas platserna som inte är tagna till robotspelare.

Bordlistan visar också namnet på regeluppsättningen som spelas på bordet. Regeluppsättningen och dess namn skickas till spelservern av spelaren som påbörjar bordet. Om du har en identisk regeluppsättning visar bordet ditt namn på regeluppsättningen: det kan vara till hjälp om den som påbörjat bordet talar ett annat språk och har namngett regeluppsättningen på ett annat sätt. Om namnet på din lokala regeluppsättning visas, visas det dessutom i svart. Om du dock inte har någon identisk regeluppsättning visas namnet i rött, och du kan använda knappen Jämför för att jämföra den med dina egna regeluppsättningar.

Om du inte använder `kajongg.org` eller någon annan befintlig spelserver, kan du starta en egen &kajongg; spelserver på två olika sätt:

- anslut till servern `localhost`. Det är din egen dator. Om du gör det och ingen spelserver kör, startas den automatiskt. Och när du slutar spela stoppas också servern. Det skiljer sig från Lokalt spel, det senare tillåter inte anslutning från andra datorer.

- manuellt starta en server på vilken dator du vill. Allt du behöver göra är att gå till kommandoraden och starta programmet `kajonggserver`. Att skriva in `kajonggserver --help` visar alla tillgängliga väljare, som att ändra standardporten. Servern kör till du dödar den.

I båda fallen måste du tala om för dem hur de kan nå din spelserver. De behöver webbadressen, eller helt enkelt en IP-adress och porten servern lyssnar på. Det kan vara någonting som liknar `minpc.dyndns.se:8301`, där `8301` är porten. Du måste förstås ställa in brandväggen så att fjärrspelare kan nå porten. Kommunikationen krypteras.

Se Hjälp Om &kajongg; om portnummer. Protokollversionen är portnumret. För &kajongg; 17.04 är det 8301. Om spelaren inte skriver in någon port för önskad spelserver, beräknar klienten porten på samma sätt. Så om en dator kör flera spelservrar med olika protokollversioner, bör du automatiskt nå rätt spelserver. Hur som helst, ser spelservern och klienten till att deras versioner är kompatibla och varnar dig annars.

Om du stöder på möjliga fel, bör du kanske använda väljaren `kajongg --debug=traffic`. Den visar dig vilka meddelanden som skickas mellan spelservern och klienterna, i terminalen där servern startades. För fler väljare, se `kajongg --help`.

#### Problemområden

- Om du vill försäkra dig om att ingen kan fuska, får ingen av de mänskliga spelarna komma åt datorn som spelservern kör på. Du kan naturligtvis aldrig undvika att två spelare hjälper varandra, eftersom du inte kan veta vad de verkligen gör. Två spelare kan till och med vara en och samma person.

### Spelregler

Det finns många olika spelvarianter över hela världen. För närvarande stöder &kajongg; två versioner av de klassiska kinesiska regler som de spelas i Tyskland och i Storbritannien.

Den här beskrivningen går inte in på detaljer, och stämmer därigenom för båda varianterna.

Dock är de flesta grundreglerna likadana i de flesta varianter.

Eftersom programmet &kajongg; vet hur man spelar, innehåller den här berskrivningen bara sådant som inte kanske är självklart.

Om du vill lära dig Mah Jong mer ingående, se bibliografin.

#### Spelets mål

Varje spelare försöker samla brickor för en vinnande hand. När det har uppnåtts, kungör spelaren Mah Jong. Brickorna i en vinnande hand är normalt grupperade i fem kombinationer: Fyra kombinationer med tre eller fyra brickor vardera, och en femte kombination som består av två likadana brickor. En normal kombination har tre eller fyra identiska brickor (som kallas pong eller kong), eller tre brickor i följd som bambu 3, bambu 4, bambu 5 (som kallas chi).

#### Spelets gång

Från början har spelaren med östanvinden (angivet av muren) en bricka mer än övriga spelare. Östan börjar med att kasta en oönskad bricka.

Så snart en bricka har kastats, kan övriga spelare begära den genom att kungöra vad de kan komplettera med brickan (chi, pong, kong, Mah Jong). Bara nästa spelare kan kungöra en chi, medan de övriga är möjliga för alla spelare. En kombination som färdigställs av en kungörelse är öppen - synlig för alla spelare.

Om ingen begär den kastade brickan, tar sunnan (och därefter västan och nordan) en bricka från muren, och kastar en oönskad bricka.

Det finns flera regler om när en pong kan utökas till en kong (genom att begära den fjärde brickan eller få den från muren). Reglerna förklaras inte här, men &kajongg; känner förstås till dem och försäkrar sig om att de följs. Om en kong kungörs, får spelaren automatiskt en ersättningsbricka från muren - annars skulle det inte vara möjligt att skapa de fem ovannämnda kombinationerna.

#### År, omgång och hand

När en spelare kungör Mah Jong eller det blir oavgjort, är handen fullständig. Förutom vid oavgjort, roteras nu vindarna mellan spelarna. Det upprepas till varje spelare har haft alla vindar. Hela denna följd kallas en omgång. Ett helt spel, som också kallas ett år, består av fyra omgångar: Östan-, sunnan-, västan- och nordan-omgången. En omgångs vind kallas också den rådande vinden, och kan ge högre poäng.

Ett fullständigt spel (ett år) består av minst 16 händer. Eftersom vindarna inte roteras vid oavgjort eller när östan kungör Mah Jong, behövs normalt fler händer för ett fullständigt spel.

#### Bonusbrickor

Ett spel kan innehålla åtta bonusbrickor (om inte reglerna utesluter det). De visas separat på höger sida om spelområdet, eftersom de aldrig används för att skapa kombinationer. De ger dock bonuspoäng.

Om en spelare får en bonusbricka, ges också en ersättningsbricka automatiskt från muren, och en klocka ringer.

#### Poängsättning

När en hand är färdig beräknas poäng för varje spelare. För det första räknas baspoäng som 2 poäng för en enkel öppen pong, eller 20 poäng vid vinst. Därefter tillämpas en annan uppsättning regler, som kan dubbla antal poäng såsom en dubblering för en kombination med drakar. När poängen för varje hand är känd, betalas skillnader mellan spelarna, medan vinnaren får hela sin poäng betald från alla övriga spelare. Östan får och betalar alltid dubbla poängen.

Naturligtvis känner &kajongg; till alla tillämpliga regler, men en god spelare känner till vilka kombinationer som får vilka poäng, och kan optimera. Under inlärning rekommenderas att fönstret Förklara poäng aktiveras.

De exakta poängreglerna varierar ofta - i &kajongg; har man möjlighet att ändra dem med regeluppsättningseditorn.

Regeluppsättningseditorn visar också alla tillgängliga regler och deras betydelse. Håll musen över dem så visas en hjälptext för de mer ovanliga.

### Hur man spelar med &kajongg;

Du blir tillfrågad om vad du vill göra. Det är en liten dialogruta som antingen dyker upp till höger eller längst ner, beroende på fönstrets storlek. Om du gör det bredare än högt, visas dialogrutan till höger. Ibland har dialogrutan en tidsgräns - när den har gått ut väljes automatiskt det första möjliga svaret åt dig. Tidsgränsen går att ställa in i regeluppsättningseditorn, under Alternativ, Tidsgräns för kungörelse. Alla spelare ska ha samma tidsgräns, det är därför den är en del av regeluppsättningen.

Om du måste välja en bricka från handen, kan du gå mellan brickorna med högerpil och vänsterpil, eller bokstäverna h och l på tangentbordet. Du kan naturligtvis också använda musen.

Du kan slänga en bricka genom att använda tangentbordet på samma sätt som för åtgärder. Som ett alternativ, kan musen användas för att flytta brickan från handen till högern (innanför muren). Placeringen av brickan i högen görs fortfarande av datorn, eftersom placeringen ska vara samma för alla spelare.

Ofta erbjuder dialogrutorna val som inte egentligen är möjliga, som att kungöra Pong när du inte har de nödvändiga brickorna. Det är med avsikt, precis som i ett riktigt spel. Men du kan ställa in att omöjliga val tas bort: Inaktivera Visa bara möjliga åtgärder på sidan Spela i inställningsdialogrutan.

Kastade brickor placeras slumpmässigt mellan murarna. Vissa spelversioner definierar var brickorna ska placeras, men det är dock inte ännu inställningsbart. När det blir inställningsbart, kommer det att ingå i regeluppsättningen.

## Översikt av gränssnittet

### Menyalternativ

&Ctrl;C Spel Poängsätt spel manuellt

- Poängsätt bara ett manuellt spelat spel.

  Du kan ladda ett gammalt spel eller starta ett nytt. Normalt visas bara väntande (dvs. inte färdiga) spel i urvalslistan. Du kan valfritt visa alla spel, inklusive färdiga. Här kan du också ta bort spel.

&Ctrl;N Spel Spela

- Spela med andra (personer och datorer).

&Ctrl;W Spel Avbryt spel

- Avbryt pågående spel. Om det var ett manuellt spel, enbart med poängsättning, kan du återuppta det senare. Om du spelar med användning av &kajongg;, kan spel ännu inte återupptas.

&Ctrl;Q Spel Avsluta &kajongg;

- Avslutar &kajongg;.

&Ctrl;H Visa Chatta

- Chatt

  Chattfönster Chattfönster

  Låter dig chatta med övriga spelare.

&Ctrl;T Visa Poängtabell

- Poängsättningstabell

  Poängsättningstabell Skärmbild

  Visa poängsättningstabellen. Omgång/hand är den pågående ronden (Öst, Syd, Väst, Nord) följd av antal omgångar som har spelats i ronden. Vinnaren har en grön bakgrund för sina värden. Utbetalningar visar hur mycket spelaren betalade ut till eller tog emot från alla andra spelare i omgången. Behållning visar nuvarande behållningen för alla spelare. Diagram visar behållningens utveckling. Tipsen ger mer information: de visar alla regler som har används i omgången. Flytta bara musen över värdet som du är intresserad av.

  Den nedre delen visar använd regeluppsättning. Mellan poängtabellen och använd regel finns en avdelare, som låter dig ändra den relativa storleken hos båda delarna.

&Ctrl;E Visa Förklara poängberäkning

- Förklara poäng

  Poängsättningstabell Poängtabell

  Förklarar hur den aktuella omgångens poäng beräknades.

&Ctrl;&Shift;F Visa Fullskärmsläge

- Byter mellan fullskärmsläge och normalt läge.

Inställningar Spelare

- Lägg till, ändra och ta bort spelare.

  Lösenorden i tabellen är de som normalt används vid inloggning på en spelserver. Att ändra lösenordet som du från början valde för en spelserver är inte till någon hjälp. eftersom det ännu inte finns något sätt att också ändra lösenordet på spelservern. Du skulle behöva be spelserverns administratör att göra det åt dig direkt i databasen.

Inställningar Regeluppsättningar

- Anpassa regeluppsättningar.

  Använd regeluppsättningseditorn för att anpassa regeluppsättningar. För detaljerad information se följande.

&Ctrl;G Inställningar Ändra synvinkel

- Ändrar synvinkeln för brickorna moturs.

&Ctrl;D Inställningar Demonstrationsläge

- Aktiverar eller inaktiverar demonstrationsläget. Titta här för detaljinformation.

Dessutom har &kajongg; de vanliga menyalternativen Inställningar och Hjälp i &kde;. För mer information, läs avsnitten Menyn Inställningar och Menyn Hjälp i &kde;:s Grunder.

## Spelanpassning

Inställningsdialogrutan Inställningsdialogrutan

Menyalternativet Inställningar Anpassa &kajongg;... visar dialogrutan Anpassa - &kajongg;.

Om du klickar på knappen Avbryt här, ångras alla ändringar av inställningarna, inklusive allt du gjorde i regeluppsättningseditorn.

Du kan också välja olika flikar med tangentbordet: &Ctrl;1 väljer den första fliken, alternativet Spela, &Ctrl;2 väljer den andra fliken, och så vidare.

### Spelalternativ

Visa brickornas skuggor

- Det här visar brickor med kanter och skuggor. Det finns också ett visst mellanrum mellan brickrader, och murens brickor visas så att det går att se om muren är två eller tre brickor hög. Om alternativet inaktiveras, får man alltså en enklare visning med något större brickor. Det kan vara till hjälp för små bildskärmar.

Arrangera om dolda brickor till kombinationer

- Det här grupperar kombinationer på handen. Ibland kan grupperingen kanske inte vara som du vill ha den, så du kanske föredrar att inte ha någon gruppering alls, precis som i ett verkligt spel.

Visa bara möjliga åtgärder

- Visa bara möjliga åtgärder under spelet, som Ingen begäran eller Pong.

Föreslå vad som bör göras

- Så fort du har ett val av åtgärder, som att begära en bricka eller inte, eller välja vilken bricka som ska kastas, kan &kajongg; hjälpa dig genom att ge ett förslag.

Använd ljud om tillgängliga

- Det är låter dig höra kastade och kungjorda brickor. Om andra spelare spelar in ljudfiler med sina egna röster, kan du höra dem.

Låt andra höra min röst

- Om du spelade in ljudfiler med din egen röst, låter det här alternativet andra spelare höra din egen röst för dina kastade och kungjorda brickor.

Animeringshastighet:

- Definiera hur snabbt brickorna ska flyttas omkring. Om du flyttar skjutreglaget längst åt höger, animeras inte förflyttning av brickor: brickorna byter helt enkelt plats.

#### Ljud

Du får en mycket bättre spelupplevelse om du hör spelare begära brickor och kungöra kastade brickor. Det gör det också enklare att spela, eftersom du kan koncentrera dig på dina egna brickor, du behöver inte titta på vad andra kastar.

&kajongg; levereras med röster för olika spelare. Röster tilldelas automatiskt till alla spelare. För varje språk ska det finnas fyra röster, helst två manliga och två kvinnliga. &kajongg; försöker använda röster på samma språk som det kör med. Om inga röster hittas med det språket, använder &kajongg; andra språk som reserv, med samma reservspråk som du har definierat för &kajongg; (se Hjälp Ändra programmets språk...). Om inga röstfiler finns på ditt modersmål, inbjuds du att spela in och bidra med dem till &kajongg;.

- Så här kan du skapa röster själv. Det finns en separat katalog för varje röst. Observera att katalogerna kan finnas någon annanstans på ditt system, de beror på hur &kde; installerades. Bara delen som börjar med `kajongg` är alltid likadan. Det finns två röstgrupper med olika platser i filsystemet:

  - Fördefinierade röster för varje språk. De finns i en katalog som `/usr/share/kajongg/voices/SPRÅK` där SPRÅK är koden för ditt modersmål. Röstkatalogerna under `.../kajongg/voices/` är på amerikansk engelska. Fördefinierade röster tilldelas slumpmässigt till spelare. Rösterna har namn som `"male1 male2 female1 female2"` men namnen spelar ingen roll, eftersom användaren aldrig ser dem.

  - Användarröster kan definieras för en specifik användare. Om &kajongg; använder en sådan röst, kan det automatiskt överföras till andra spelare över Internet. Rösterna kan finnas i en katalog som `~/.local/share/apps/kajongg/voices/`. Så om loginnamnet är anna, kan det vara `/home/anna/.local/share/apps/kajongg/voices/joe/`. Katalogen `voices/` kanske inte existerar ännu. Om så är fallet, skapa den.

- Nu när du vet var den nya rösten ska placeras, skapa en ny katalog för den.

- I den underkatalogen kan du placera ljudfilerna. De måste kodas med Ogg Vorbis ljudomkodare, och namnen måste ha filändelsen `.ogg`. En enskild fil har ett namn som `s3.ogg`, vilket betyder sten 3. Sådana filer ska definieras för varje bricka, varje begäran och kungörelse. Men om ett ljudfil saknas, händer ingenting allvarligt, ljudet hörs helt enkelt bara inte. Återgång till andra röster eller språk fungerar bara för hela röster, inte för enskilda ljudfiler.

- Efter att ha definierat alla ljudfiler för en fördefinierad röst, försäkra dig om att &kajongg;-processen har skrivrättigheter i den nya röstkatalogen. Starta &kajongg; och prova rösten. När allting är ok, kan du ta bort skrivrättigheterna (och bör göra det för fördefinierade rösterna). &kajongg; kommer automatiskt att skapa en fil som kallas `md5sum` innehåller en checksumma för alla ljudfiler. När du ändrar, lägger till eller tar bort en ljudfil för en röst, försöker &kajongg; skriva den filen igen.

Gör ljudets längd kort men tala tydligt. Spelet kan gå mycket snabbt när man är van vid det. Det är enklare om man först skriver ned en lista med allt som ska läsas upp. Läs det inte som en följd av värden, utan försök uttala varje värde som det var det enda, och som man skulle göra det när man spelare. Lämna utrymme mellan värdena. Att läsa upp detta kräver en del övning.

Det här är bara en möjlighet att skapa ljudfilerna.

- Spela in en ljudfil med programmet `qarecord`, sparat den med WAV-format. Läs upp alla ljud i denna enda ljudfil.

- Redigera filen med ljudeditorn `audacity`. Använd musen i den editorn för att markera ett intervall av ljudvågorna. Editorn spelar upp den delen. Upprepa till du har markerat rätt del. Det kan vara enklare om Visa Zooma in används. Använd menykommandot Arkiv Exportera markering och spara med formatet `.ogg`. Välj låg kvalitet under Alternativ, det är tillräckligt, och till och med önskat, eftersom det reducerar tiden för att överföra ljuden till andra spelare.

Följande är namnen på filerna som ska skapas. Lägg alltid till `.ogg` sist i dem:

#### Ljudfilernas namn

&s1; .. &s9; | Bricka 1 till bricka 9
&b1; .. &b9; | Bambu 1 till bambu 9
&c1; .. &c9; | Tecken 1 till tecken 9
&we; &ws; &ww; &wn; | Vindarna östan, sunnan, västan, nordan
&db; &dr; &dg; | Drakarna blå/vit, röd, grön
&chow; &pung; &kong; &mahjongg; | De viktigaste kungörelserna: chi, pong, kong, Mah Jong
&originalcall; &violatesoriginalcall; | Ursprunglig kungörelse om den är felaktig
&dangerousgame; | En spelare fyrar av en kanon (farligt spel)
&nochoice; | En spelare deklarerar att han inte har något val annat än att spela ett farligt spel

### Brickalternativ

Brickuppsättningsväljare Brickuppsättningsväljare

Använd val av Brickor för att välja brickornas grafik.

### Bakgrundsalternativ

Val av bakgrund Val av bakgrund

Använd val av Bakgrund för att välja spelets bakgrundsgrafik.

Vissa bakgrunder, som det kinesiska landskapet, behöver en viss tid för att läsas in. Om du tycker att programmet ska starta snabbare, eller att det tar för lång tid att ändra storlek på huvudfönstret, kan du prova någon annan bakgrund.

### Regeluppsättningseditor

Regeluppsättningseditor Regeluppsättningseditor

Använd regeluppsättningseditorn för att anpassa regeluppsättningar. Fördefinierade regeluppsättningar visas med kursivstil, medan anpassade regeluppsättningar använder normal stil. Fördefinierade regeluppsättningar kan inte ändras av användaren på något sätt. Dock kan en uppdatering av &kajongg; det. Anpassade regeluppsättningar påverkas aldrig av en uppdatering.

När ett nytt spel startas, kan du välja en regeluppsättning för spelet. Alla regeluppsättningar definierade i regeluppsättningseditorn kan användas. Regeluppsättningen sparas tillsammans med spelet, så du kan alltid ändra regeluppsättning här: ändringarna påverkar bara framtida spel.

#### Regel, poäng, x2, gränser

Dubbelklicka helt enkelt på vad du än vill ändra. Om alla värden är tomma har regeln ingen påverkan på spelet. Regler kan inte tas bort.

#### Kopiera och ta bort

Du kan kopiera och ta bort hela regeluppsättningar.

Återigen kan det göras även om befintliga spel använder regeluppsättningen, eftersom varje spel har sin egen kopia av regeluppsättningen. Du kan titta på regeluppsättningar för gamla spel: Ladda det gamla spelet och visa dess poängtabell.

#### Jämför

Regeluppsättningsjämförelse Regeluppsättningsjämförelse Du kan välja kommandot när en hel regeluppsättning väljes. Det låter dig jämföra den valda regeluppsättningen med vilken annan regeluppsättning som helst.

### Förvalda tangentbindningar

De förvalda tangentbindningarna är följande:

F1

- Visar den här handboken.

&Ctrl;C

- Poängsätt ett manuellt spel.

&Ctrl;N

- Spela ett spel med vänner eller datorspelare.

&Ctrl;W

- Avbryt pågående spel.

&Ctrl;Q

- Avsluta programmet.

&Ctrl;T

- Visa poängtabellen.

&Ctrl;H

- Visa ett chattfönster.

&Ctrl;G

- Ändra synvinkel.

&Ctrl;D

- Aktiverar eller inaktiverar demonstrationsläget.

&Shift;F1

- Vad är det här? hjälp.

&Ctrl;&Shift;F

- Fullskärmsläge.

## Kända problem

- I spelläget är straff ännu inte möjliga.

- Datorspelarna är fortfarande ganska dumma.

## Möjliga framtida funktioner

- Lägg till flera regeluppsättningar. Det är valfritt, och kan göras av personer som ofta använder regeluppsättningarna.

## Vanliga frågor

Jag vill ändra hur spelet ser ut. Kan man göra det?

Ja. Använd menyraden för att öppna inställningsverktyget för att ändra utseendet på &kajongg;.

Kan man använda tangentbordet för att tilldela brickor till spelare?

Ja. Se Låt &kajongg; beräkna poängen.

## Tack till och licens

&kajongg; för &kde;

Program Copyright © 2009-2017 &Wolfgang.Rohdewald; &Wolfgang.Rohdewald.mail;

Dokumentation Copyright © 2009-2017 &Wolfgang.Rohdewald; &Wolfgang.Rohdewald.mail;

Översättning Stefan Asserhäll stefan.asserhall@bredband.net

&underFDL; &underGPL;

## Bibliografi

- Das Chinesische Mah-Jongg-Spiel av Uwe Martens 2005, Books on Demand GmbH, Norderstedt. Boken är ett utmärkt tyskt referensverk som innehåller allt man behöver veta om reglerna som används i Tyskland, och många andra spelaspekter.

- The Complete Book of Mah-Jongg av A. D. Millington, 1977 (med flera pocketutgåvor fram till 2003), Weidenfeld & Nicolson, London. Detta är det slutgiltiga referensverket för klassisk kinesisk Mah Jong, som det spelas i västvärlden. Det kan ge värdefulla tips om spelstrategier.

- Mah-Jong av Gwyn Headley och Yvonne Seeley, 3rd edition, 2008, A & C Black Publishers Ltd., London. Denna bok är ett mycket lättanvänt referensverk, som koncentrerar sig på reglerna som används i Storbritannien, definierade av BMJA (Brittiska Mah Jong-föreningen).

## Installation

För Linux: Distributionen ska ha det paketerad åt dig.

För Windows: Se för ett installationsprogram för Windows.

Om du vill ladda ner källkoden och installera för hand:

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

- För Linux: `cd kajongg ; mkdir build ; cd build; cmake .. && make && make install`

- För Windows: Läs `README.windows`

Kajongg beror på följande paket (debian paketnamn inom parentes):

- Python 3.5 eller senare (python3)

- Qt 5.7 eller senare (python3-pyqt5 och python3-pyqt5.qtsvg)

- Python-bindningar för Qt5 (python3-pyqt5)

- Python-biblioteket twisted 16.6.0 eller senare (python3-twisted)

- sqlite3 (libsqlite3-0)

&documentation.index;