Kajongg Priročnik

# Kajongg Priročnik

Wolfgang Rohdewald `<wolfgang@rohdewald.de>`

Prevod: Matjaž Jeran
Različica KDE Gear 21.04 (30.05.2021)

Pravno sporočilo

Ta dokumentacija opisuje igro Kajongg

Seznam tabel

6.1. Imena zvočnih datotek

Poglavje 1. Uvod
Uvod

# Poglavje 1. Uvod

### Vrsta igre:

Tabla, Arkadna

### Število možnih igralcev:

Štiri

Kajongg je družabna igra, ustvarjena po znani orientalski igri Mah Jong (iz kitajščine 麻將). Igrajo jo štirje igralci. Po vsem svetu se uporablja veliko različnih pravil. Trenutno Kajongg podpira klasična kitajska pravila, kot se igrajo v Nemčiji, sčasoma bodo sledili drugi glavni nizi pravil. Možno je prilagoditi ali dodati nove nabore pravil. Prosimo, da to storite in jih pošljete avtorju programa v integracijo!

Kajongg se lahko uporablja na dva različna načina: točkovanje ročne igre, kjer kot vedno igrate brez pomoči računalnika in uporabljate Kajongg za izračun rezultatov in za knjigovodstvo. Lahko pa uporabite Kajongg za igranje proti kateri koli kombinaciji drugih človeških igralcev ali računalniških igralcev.

Poglavje 2. Postavitev zaslona
Postavitev zaslona

# Poglavje 2. Postavitev zaslona

Hitra razlaga delov igralnega zaslona.

Orodna vrstica

  Orodna vrstica se nahaja pod menijsko vrstico in vsebuje gumbe za najpogosteje uporabljena dejanja. Vsebino orodne vrstice je mogoče urejati. Prav tako jo lahko naredite nevidno in s tem zagotovite več prostora za tablo.

  Odvisno od velikosti vašega zaslona boste morda želeli orodno vrstico narediti nevidno ali jo premakniti na levo stran okna. To lahko storite tako, da kliknete desna tipka miške mouse button na orodni vrstici.

Tabla

  Tabla je največji del okna. Vidite štiri stene z dolžino 18 ploščic (točno število je odvisno od pravil, kot je uporaba bonus ploščic ali ne). Imena igralcev so napisana na stenah, skupaj s trenutno vrednostjo kombinacije (če je znano) in njihovimi ploščicami vetra. Prevladujoči veter ima barvno ozadje, vzhod na zgornjem posnetku zaslona.

  Med igranjem so v notranjosti sten ploščice, ki so jih igralci odvrgli. Postavljeni so naključno. Zadnja zavržena ploščica ima moder fokusni okvir.

  Pri točkovanju ročnih iger ima notranjost sten izbor vseh razpoložljivih ploščic, osrednji izbirnik. Igralcem jih lahko dodelite z miško ali s tipkovnico.

Regija igralca

  Vsak igralec ima razpon zaslona za svoje ploščice. Zgornja vrsta vsebuje vidne ploščice, spodnja vrstica skrite ploščice. Pri točkovanju ročnih iger so skrite ploščice prikazane s senco čez celotno ploščico. Bonus ploščice gredo na desni konec.

Dialog

  Pogovorno okno predstavlja izbire, ki jih ima igralec. Najpogosteje ima časovno omejitev z vrstico napredka, ki prikazuje preostali čas.

Statusna vrstica

  Statusna vrstica se nahaja na dnu zaslona in vsebuje trenutne skupne vrednosti za igralce.

Poglavje 3. Točkovanje ročne igre
Točkovanje ročne igre

# Poglavje 3. Točkovanje ročne igre

V tem načinu se Kajongg uporablja samo za točkovanje. Igrate kot običajno z resničnimi ljudmi na resnični mizi in na koncu igre lahko rečete Kajongg ploščice, ki jih ima igralec v roki in vse ostalo Kajongg mora vedeti za izračun rezultatov - kar bo program tudi naredil. Lahko pa ročno izračunate rezultate rok in jih vnesete. Kajongg bo nato izvedel plačila med igralci in zapisal rezultate v bazo podatkov. Možno je prekiniti igro, začeti novo igro z drugimi igralci in nadaljevati stare igre. Vsa pravila bodo shranjena skupaj z igrami, tako da lahko različne igre igrate z različnimi pravili.

- V meniju izberite Igra → Ročno izračunaj igro ali pritisnite Ctrl+C.

- Zdaj lahko izberete obstoječo nedokončano igro ali začnete novo igro. Če začnete novo igro, boste morali vnesti igralce in nabor pravil. Kajongg bo predlagal enake vrednosti, kot so bile uporabljene v prejšnji igri. Če ni bilo prejšnje igre, bo predlagal prve štiri določene igralce. Upoštevajte, da po tej izbiri ne morete spremeniti nabora pravil ali katerega koli od njegovih pravil. To lahko storite vnaprej v urejevalniku nabora pravil.

- Zdaj dobite novo okno z naslovom Točkovanje za to roko. Preberite Naj Kajongg izračuna rezultat za podroben opis.

- Ko shranite rezultate roke, nadaljujte z naslednjo roko.

## Vnos rezultatov rok

### Rezultati

To je okno za vnos rezultatov rok. Samodejno se prikaže, ko Kajongg misli, da bi ga morda potreboval. Vedno ga lahko prikažete ali skrijete s pritiskom Ctrl+S ali z izbiro ustreznega menijskega vnosa.

Kot vedno ima prevladujoči veter obarvano ozadje.

Tukaj lahko ročno vnesete rezultate za vse igralce. Druga možnost je, da lahko natančno določite, katere ploščice je imel igralec v njegovi roki. Če se odločite za to, bo ustrezno polje za ročno vrednost rezultata zatemnjeno. Kajongg bo samodejno izračunal rezultat.

Ko vnesete vse ustrezne podatke za roko, pritisnite gumb Shrani roko. Vrednosti rok bodo vnesene v bazo podatkov, prikazane pa bodo tudi v tabeli rezultatov. Morda boste pozvani, da spremenite položaje igralcev, vendar se lahko odločite, da ne zamenjate sedežev. Predlaganih sprememb trenutno ni mogoče prilagoditi – če nabor pravil potrebuje nekaj drugačnega, bomo to spremenili.

Če je igralec morda zmagal, bo potrditveno polje v stolpcu Zmagovalec omogočeno - kliknite to za zmagovalca.

Vrstica stanja bo zdaj prikazala posodobljena stanja za igralce in lahko nadaljujete z naslednjo roko.

#### Vnesite rezultat ročno

Dober igralec bo verjetno raje sam izračunal njen rezultat. V tem primeru ga lahko neposredno vnesete. To je mogoče le, če za tega igralca ni izbrana nobena ploščica.

Če vnesete ročni rezultat, mora že vsebovati vse razen kazni, ne boste imeli izbirnih pravil med katerimi lahko izbirate. Obstaja ena izjema: “Nevarna igra”. To ne vpliva na ocene, tudi ni žalitev. To le pomeni, da je plačilo med igralci različno: storilec plača vse za vse zmagovalcu. Druga dva igralca ne izmenjujeta plačil. Tega trenutno ni mogoče prilagoditi.

#### Naj Kajongg izračuna rezultat

Če izrecno poveste Kajongg katere ploščice ima igralec, bo vnos rezultatov za tega igralca v tem oknu zatemnjen. Med povezovanjem ploščic z igralcem boste videli, kako bo njegov rezultat rasel - toda takoj, ko dodate 14. ploščico, gre rezultat na nič. To bi vas lahko presenetilo, vendar če tega ne razglasite za zmagovalno kombinacijo, je priznana kot dolga kombinacija, ki ima vedno nič točk. To vedenje je opredeljeno s klasičnim kitajskim naborom pravil, morda je drugače, če spremenite pravila ali uporabite drug nabor pravil.

Ploščice in zlitja lahko povežete z igralcem z uporabo miške ali tipkovnice ali obojega. Z miško preprosto premaknite ploščice tako, da jih povlečete/spustite v območje igralca. Ko spustite ploščico, boste pozvani, kaj želite premakniti: eno, par, pung, kong, zahtevani kong ali čov. Zgornja vrsta je za vidne ploščice, spodnja vrsta za skrite ploščice. Bonus ploščice se bodo prikazale skrajno desno. Prav tako lahko premikate ploščice in kombinacije med vrsticami, med igralci in nazaj do osrednjega izbirnika.

Če raje uporabljate tipkovnico, lahko uporabite Tab za premikanje med osrednjim selektorjem in regijami igralcev. Tipke eswnESWN premaknejo ploščico do igralcev vzhod, jug, zahod in sever. Tipke xX ga premaknejo nazaj na osrednji izbirnik. ESWN premakne v skrito vrstico, eswn premakne v vidno vrstico. Kazalec lahko premikate med ploščicami ali združitvami s puščičnimi tipkami, trenutno izbrana ploščica ali združitev ima moder okvir. Ker so puščice na tipkah daleč stran od črk na tipkovnici, lahko za premikanje kazalca uporabite tudi črki hjkl ali HJKL. hH pomik levo, jJ pomik navzdol, kK pomik navzgor, lL pomik desno. Tako to počne urejevalnik Unix vi. KDE brskalnik Konqueror in tudi ta program za pomoč podpira te tipke na enak način. Te tipke se lahko razlikujejo, če uporabljate jezik, ki ni angleščina, vendar jih trenutno ni mogoče konfigurirati.

Možnosti Zadnja ploščica: in Zadnje zlitje: potrebujeta nekatera pravila, kot je Zadnja ploščica zaključi par. Uporabljajo se lahko le za zmagovalno roko.

V desnem delu okna lahko ročno uporabite nekatera pravila. Katera pravila so prikazana na tem seznamu, je odvisno od trenutnega nabora pravil in ploščic. V primeru zgornjega posnetka zaslona imajo lahko poraženi igralci možnost “Nevarna igra” – spet odvisno od nabora pravil in njihovih ploščic. Cilj razvijalcev je, da je ta seznam ročno izbranih pravil čim krajši. Optimalno Kajongg vedno mora biti sposoben samodejno ugotoviti, ali velja pravilo, vendar včasih Kajongg nima dovolj informacij ali znanja za odločitev.

### Kazni

V oknu za vnos rezultatov kombinacij bo gumb Kazni prikazal to okno, kjer lahko vnesete kazni. To je mogoče storiti kadar koli, neodvisno od običajnega mehanizma točkovanja.

Izbira Napad: prikazuje vse prekrške, ki bi lahko veljali za roke, ki jih držijo igralci. Izberite med njimi.

Zdaj lahko prilagodite Skupno kazen. To je skupni znesek, ki se premakne od plačnikov k prejemnikom plačil. Enakomerno bo razdeljen mednje.

Glede na vrsto prekrška se število plačnikov in prejemnikov plačil razlikuje. Prikaže se pravo število igralcev. Če izberete igralca, Kajongg zagotavlja, da se ta igralec pojavi samo enkrat s prilagajanjem drugih igralcev.

Poglavje 4. Igranje
Igranje

# Poglavje 4. Igranje

Kadarkoli lahko omogočite ali onemogočite demo način. V demo načinu bo računalnik igral namesto vas. Če se trenutno ne igra nobena igra, se začne nova igra z zadnjim uporabljenim naborom pravil.

## Igrajte proti računalniku

Najprej boste dobili pogovorno okno za prijavo. Vnesite strežnik igre, s katerim se želite povezati, in svoje uporabniško ime. Če izberete poseben vnos Lokalna igra, morate vnesti samo svoje ime (ali sprejeti predlagano ime) in želeni nabor pravil. To bo takoj začelo lokalno igro, v kateri igrate proti trem robotskim igralcem. Če pa obstajajo suspendirane igre, bodo prikazane na seznamu. Nato lahko izberete igro, s katero želite nadaljevati, ali začnete novo igro.

Igrajte se s prijatelji
Igrajte se s prijatelji

## Igrajte se s prijatelji

Če želite igrati proti drugim resničnim ljudem, potrebujete strežnik za igre, na katerega se morajo povezati vsi igralci vključno z vami. To storite tako, da izberete katerega koli drugega gostitelja ali ročno vnesete novo ime gostitelja in navedete svoje geslo za tega gostitelja. Predlagano bo zadnje uporabljeno geslo.

Najlažji način je, da uporabite strežnik za igre na `kajongg.org`. Kajongg bo tega prikazal na seznamu možnih igralnih strežnikov. Upoštevajte, da ta strežnik ponuja le strežnik za igre, ne pa tudi spletne strani ali drugih storitev.

Če na igralnem strežniku nimate računa z imenom, ki ste ga vnesli, boste pozvani, ali želite odpreti račun. Če odgovorite pritrdilno, se vam prikaže novo pogovorno okno, kjer lahko dvakrat vnesete želeno geslo. Vaš račun bo ustvarjen samodejno.

Po uspešni prijavi v igralni strežnik boste prejeli seznam miz s prostimi sedeži na tem igralnem strežniku. Pridružite se mizi ali dodelite novo mizo. Če dodelite novo mizo, počakajte, da drugi igralci zasedejo več sedežev. Igro lahko kadar koli začnete na mizi, ki ste jo dodelili, nezasedeni sedeži bodo zasedeni z robotskimi igralci.

Seznam miz prikazuje tudi ime nabora pravil, ki se igra na tej mizi. Nabor pravil in njegovo ime pošlje igralnemu strežniku igralec, ki začne mizo. Če imate identičen nabor pravil, je v tabeli prikazano vaše ime za nabor pravil – to bi lahko bilo v pomoč, če pobudnik tabele govori drug jezik in je nabor pravil poimenoval drugače. Tudi, če je prikazano ime vašega lokalnega nabora pravil, je prikazano v črni barvi. Če pa nimate identičnega nabora pravil, se ime prikaže rdeče in uporabite gumb Primerjaj, da ga primerjate s svojimi nabori pravil.

Če ne uporabljate `kajongg.org` ali katerega koli drugega obstoječega igralnega strežnika, lahko zaženete svoj Kajongg igralni strežnik na dva različna načina:

- povežite se s strežnikom `localhost`. To je vaš računalnik. Če to storite in noben igralni strežnik ne deluje, se bo zagnal samodejno. In ko nehate igrati, bo ustavljen tudi strežnik. To se razlikuje od izbire Lokalna igra, saj slednja ne dovoljuje povezav iz drugih računalnikov.

- ročno zaženite strežnik na kateremkoli računalniku, ki ga želite. Vse kar morate storiti je, da greste v ukazno vrstico in zaženete program kajonggserver. Če vnesete kajonggserver --help, se vam bodo prikazale vse razpoložljive možnosti, na primer sprememba privzetih vrat. Ta strežnik bo deloval, dokler ga ne ubijete.

V obeh primerih morate drugim igralcem povedati, kako lahko dosežejo vaš igralni strežnik. Potrebujejo URL ali preprosto naslov IP in vrata, ki jih vaš strežnik posluša. To je lahko nekaj takega kot `mypc.dyndns.org:8301`, kjer so `8301` vrata. Seveda morate vdorobran konfigurirati tako, da lahko oddaljeni predvajalnik doseže ta vrata. Komunikacija bo šifrirana.

Za številko vrat glejte Pomoč → O Kajongg. Različica protokola je številka vrat. Za Kajongg 17.04 je to 8301. Če igralec ne vnese nobenih vrat za želeni igralni strežnik, odjemalec izračuna vrata na enak način. Torej, če računalnik poganja več igralnih strežnikov z različnimi različicami protokola, bi morali običajno samodejno doseči pravi igralni strežnik. Kakorkoli že, bosta igralni strežnik in odjemalec poskrbela, da sta njuni različici združljivi, in vas opozorila na nasprotno.

Če naletite na možne napake, boste morda želeli uporabiti možnost kajongg --debug=traffic. To vam bo na konzoli, kjer je bil zagnan igralni strežnik, pokazalo, katera sporočila tečejo med igralnim strežnikom in odjemalci. Za več možnosti glejte kajongg --help

### Opozorila

- Če se želite prepričati, da nihče ne more goljufati, nihče od človeških igralcev ne sme imeti dostopa do računalnika, na katerem teče strežnik igre. Seveda se nikoli ne morete izogniti temu, da si dva igralca pomagata, ker ne morete vedeti, kaj v resnici počneta. Dva igralca sta lahko celo ena in ista oseba.

Pravila igre
Pravila igre

## Pravila igre

Po vsem svetu obstaja veliko različnih različic igre. Trenutno Kajongg podpira dve različici klasične kitajske, eno, kot jo igrajo v Nemčiji, in eno, kot jo igrajo v Veliki Britaniji.

Ta opis se ne spušča v podrobnosti in kot tak ustreza obema različicama.

Vendar je večina osnovnih pravil v večini različic enaka.

Ker program Kajongg zna igrati, ta opis vsebuje samo stvari, ki morda niso očitne.

Če se želite Mah Jong naučiti podrobneje, si oglejte bibliografijo.

### Cilj igre

Vsak igralec poskuša zbrati ploščice tako, da ima zmagovalno roko. Ko to doseže, pokliče “Mah Jong”. V zmagoviti igri so ploščice običajno razvrščene v pet skupin: štiri kombinacije s tremi ali štirimi ploščicami in peta kombinacija, ki je sestavljena iz dveh enakih ploščic. Običajna kombinacija ima tri ali štiri enake ploščice (imenovane Pung oziroma Kong) ali tri zaporedne ploščice, kot so Bambus 3, Bambus 4, Bambus 5 (imenovan Čov).

### Potek igre

Na začetku ima igralec z vzhodnim vetrom (kot je označeno na steni) eno ploščico več kot drugi igralci. Vzhodni začne tako, da zavrže neželeno ploščico.

Kadarkoli je bila ploščica zavržena, jo lahko drugi igralci zahtevajo tako, da povedo, kaj lahko dokončajo s to ploščico (Čov, Pung, Kong, Mah Jong). Samo naslednji igralec lahko zahteva Čov - ostali zahtevki so možni za vse igralce. Zlitje, dokončano z zahtevkom, bo izpostavljeno – vidna vsem igralcem.

Če nihče ne zahteva zavržene ploščice, naslednji igralec, Jug (in nato Zahod in Sever), dobi ploščico s stene in zavrže neželeno ploščico.

Obstaja več pravil o tem, kdaj je Pung mogoče razširiti na Konga (z prevzemom četrte ploščice ali tako, da jo vzamete iz stene) - ta pravila tukaj niso pojasnjena. Toda Kajongg seveda jih pozna in skrbi za njihovo spoštovanje. Če je razglašen Kong, igralec samodejno dobi nadomestno ploščico s stene – sicer ne bi bilo mogoče zgraditi petih zlitij, kot je omenjeno zgoraj.

### Leto, krog in roka

Ko igralec zahteva Mah Jong ali smo na koncu izenačeni, je roka zaključena. Zdaj se, razen remijev, menjajo vetrovi med igralci. To se ponavlja, dokler vsak igralec enkrat ne dobi vsakega vetra. Celotna enota se imenuje krog. Celotna igra, imenovana tudi leto, je sestavljena iz štirih takih krogov: krog vzhodnega vetra, krog južnega vetra, krog zahodnega vetra, krog severnega vetra. Veter kroga se imenuje tudi prevladujoči veter, lahko povzroči višje ocene.

Torej je celotna igra (leto) sestavljena iz vsaj 16 rok. Ker se vetrovi ne vrtijo za remije ali ko vzhodni igralec reče Mah Jong, je za celotno igro običajno potrebno večje število rok.

### Bonus ploščice

Igra lahko vsebuje osem bonus ploščic (razen če jih pravila izključujejo). Izpostavljeni so ločeno na desni strani območja igralca, saj se nikoli ne uporabljajo za gradnjo zlitij. Vendar ustvarjajo bonus točke.

Če igralec dobi bonus ploščico, samodejno dobi tudi nadomestno ploščico s stene. In zazvoni zvonec.

### Točkovanje

Na koncu igre se izračuna rezultat za vsakega igralca. Prvič, osnovne točke se štejejo kot 2 točki za preprosti pung ali 20 točk za zmago. Nato se uporabi še en niz pravil - ta pravila lahko podvojijo točke kot ena dvojna za zlitje zmajev. Ko je rezultat za vsako kombinacijo znan, se razlike izplačajo med igralci – medtem ko zmagovalec prejme svoj celoten rezultat od vseh drugih igralcev. Vzhodni vedno dobi in plača dvakrat svoj rezultat.

Seveda Kajongg pozna vsa veljavna pravila, vendar dober igralec ve, katere kombinacije dobijo kakšen rezultat, tako da lahko optimizira. Med učenjem je priporočljivo aktivirati okno Razloži ocene.

Natančna pravila točkovanja se pogosto razlikujejo - v Kajongg lahko jih spremenite z urejevalnikom nabora pravil.

Urejevalnik nabora pravil vam pokaže tudi vsa razpoložljiva pravila in njihov pomen. Postavite miško nadnje in za bolj eksotična pravila se bo prikazalo besedilo pomoči.

Kako igrati z Kajongg
Kako igrati z Kajongg

## Kako igrati z Kajongg

Pozvani boste, kaj želite storiti. To je majhno pogovorno okno, ki se prikaže na desni ali na dnu, odvisno od velikosti okna. Če ga naredite širšega od visokega, se pogovorno okno prikaže na desni. Včasih bo pogovorno okno imelo časovno omejitev - ko se konča, se za vas samodejno izbere prvi možni odgovor. Ta časovna omejitev je nastavljiva v urejevalniku nabora pravil pod Možnosti, Časovna omejitev zahtevka. Vsi igralci morajo imeti enako časovno omejitev, zato je to del nabora pravil.

Če morate izbrati ploščico iz svoje roke, se lahko premikate med ploščicami z Desno in Levo puščične tipke ali črke h in l na tipkovnici. Seveda lahko uporabite tudi miško.

Ploščico lahko zavržete z uporabo tipkovnice na enak način kot za vsa dejanja. Druga možnost je, da uporabite miško in premaknete ploščico iz svoje roke v območje za odmet (notranjost sten). Postavitev ploščice v območje za odmet bo še vedno opravil računalnik - ker mora biti postavitev enaka za igralce.

Pogovorna okna pogosto ponujajo izbire, ki v resnici niso uporabne, na primer klic Pung, ko nimate potrebnih ploščic. To je namenjeno - tako kot v pravi igri. Lahko pa konfigurirate nemogoče izbire: onemogočite Pokaži samo možna dejanja na strani Predvajaj pogovornega okna z nastavitvami.

Zavržene ploščice so naključno postavljene med stene. Nekatere različice igre določajo, kje naj bodo ploščice postavljene, vendar tega še ni mogoče konfigurirati. Ko ga bo mogoče konfigurirati, bo del nabora pravil.

Poglavje 5. Pregled vmesnika
Pregled vmesnika

# Poglavje 5. Pregled vmesnika

## Elementi menija

Igra → Ročna igra rezultatov (Ctrl+C)

  Zadenite samo ročno odigrano igro.

  Lahko naložite staro igro ali začnete novo igro. Privzeto so na izbirnem seznamu prikazane samo čakajoče (tj. nedokončane) igre. Po želji lahko prikažete vse igre, vključno s končanimi igrami. Tukaj lahko tudi izbrišete igre.

Igra → Igraj (Ctrl+N)

  Igrajte se z drugimi (ljudmi in računalniki).

Igra → Prekini igro (Ctrl+W)

  Prekini trenutno igro. Če je šlo za ročno igro samo z točkovanjem, jo lahko nadaljujete pozneje. Če ste igrali s Kajongg, igre še ni mogoče nadaljevati.

Igra → Zapri Kajongg (Ctrl+Q)

  Zapusti Kajongg.

Pogled → Klepet (Ctrl+H)

  Klepetajte

  Omogoča vam klepet z drugimi igralci.

Pogled → Tabela rezultatov (Ctrl+T)

  Tabela rezultatov

  Pokaži tabelo rezultatov. Round/Hand je trenutni krog (vzhod, jug, zahod, sever), ki mu sledi štetje odigranih rok v tem krogu. Zmagovalec ima zeleno ozadje za svoje vrednote. Plačila prikazujejo, koliko je igralec plačal ali prejel od vseh drugih igralcev s to roko. Stanje prikazuje trenutno stanje za vse igralce. Graf prikazuje razvoj bilančnih vrednosti. Namigi vam dajo več podrobnosti: prikazujejo vsa pravila, ki so bila uporabljena za to roko. Samo premaknite miško nad vrednost, ki vas zanima.

  Spodnji del prikazuje uporabljeni nabor pravil. Med tabelo rezultatov in uporabljenim naborom pravil najdete razdelilnik, ki vam omogoča spreminjanje relativne velikosti obeh delov.

Pogled → Razloži rezultate (Ctrl+E)

  Razloži rezultate

  Pojasnjuje, kako je bil izračunan rezultat za trenutno roko.

Pogled → Celozaslonski način (Ctrl+Dvigalka+F)

  Preklaplja med celozaslonskim in običajnim načinom.

Nastavitve → Igralci

  Dodajanje, spreminjanje in brisanje igralcev.

  Gesla v tej tabeli so tista, ki se privzeto uporabljajo pri prijavi v igralni strežnik. Spreminjanje gesla, ki ste ga prvotno izbrali za igralni strežnik, še ni v veliko pomoč, ker še ni možnosti, da bi spremenili geslo tudi na igralnem strežniku. Morali bi prositi skrbnika igralnega strežnika, da to stori namesto vas neposredno v bazi podatkov.

Nastavitve → Nabori pravil

  Prilagodite nabore pravil.

  Uporabite urejevalnik nabora pravil za prilagajanje nabora pravil. Za podrobnosti glejte tukaj.

Nastavitve → Spremeni vidni kot (Ctrl+G)

  Spremeni kot gledanja ploščic v nasprotni smeri urinega kazalca.

Nastavitve → Demo način (Ctrl+D)

  Omogoči ali onemogoči demo način. Za podrobnosti glejte tukaj.

Poleg tega Kajongg ima skupno KDE Elementi menija Nastavitve in Pomoč, za več informacij preberite razdelke o meniju z nastavitvami in meni Pomoč v KDE Osnove.

Poglavje 6. Konfiguracija igre
Konfiguracija igre

# Poglavje 6. Konfiguracija igre

Vnos menija Nastavitve → Konfiguriraj Kajongg... odpre pogovorno okno Konfiguriraj - Kajongg.

Če tukaj pritisnete gumb Prekliči, bodo vse vaše spremembe konfiguracije razveljavljene, vključno z vsem, kar ste naredili z urejevalnikom nabora pravil.

S tipkovnico lahko izberete tudi različne zavihke: Ctrl+1 izbere prvi zavihek možnosti Predvajaj, Ctrl+2 izbere drugi zavihek itd.

## Možnosti igranja

Prikaži sence ploščic

  To prikazuje ploščice z obrobami in sencami. Med vrstami ploščic je tudi nekaj prostora, stenske ploščice pa so prikazane tako, da lahko vidite, da je stena visoka dve ali tri ploščice. Če torej onemogočite to možnost, imate enostavnejši zaslon z nekoliko večjimi ploščicami. To je lahko koristno za majhne zaslone.

Prerazporedite nerazkrite ploščice v zlitja

  Ta skupina se zlije v roki. Včasih združevanje morda ni takšno, kot bi si ga želeli, zato bi morda raje, da ga sploh ne bi imeli, tako kot v igri tudi v resničnem svetu.

Prikaži samo možna dejanja

  Med igranjem prikaži samo možna dejanja, kot je “Brez zahtevka” ali “Pung”.

Predlagajte, kaj narediti

  Kadarkoli imate možnost izbire med dejanji, na primer zahtevati ploščico ali ne ali izbrati katero ploščico želite zavreči, Kajongg vam lahko pomaga s predlogom.

Uporabite zvoke, če so na voljo

  To vam omogoča, da slišite zavržene in zahtevke. Če so drugi igralci posneli zvočne datoteke s svojim glasom, jih lahko slišite.

Naj drugi slišijo moj glas

  Če ste zvočne datoteke posneli z glasom, bo ta možnost drugim igralcem omogočila, da z vašim glasom slišijo vaše zavržke in zahtevke.

Hitrost animacije:

  Določite, kako hitro naj se ploščice premikajo. Če premaknete drsnik na skrajni desni položaj, premikanje ploščice ni animirano: ploščice bodo preprosto zamenjale mesto.

### Zvok

Igranje vam daje veliko lepšo izkušnjo, če slišite igralce, ki zahtevajo ploščice in napovedujejo zavržene. Prav tako olajša igranje, ker se lahko osredotočite na svoje ploščice, ni vam treba gledati, kaj drugi zavržejo.

Kajongg prihaja z glasovi za različne igralce. Igralcem samodejno dodeli glasove. Za vsak jezik naj bodo štirje glasovi, po možnosti dva moška in dva ženska. Kajongg poskuša uporabiti glasove v istem jeziku Kajongg steče. Če ne najde glasov v tem jeziku, Kajongg se bo vrnil v druge jezike z uporabo istih nadomestnih jezikov, ki ste jih določili za Kajongg (glejte Pomoč → Preklop jezika aplikacije). Če za vaš jezik še ni govornih datotek, vas vabimo, da jih posnamete in prispevate v Kajongg.

- Tako lahko sami ustvarite glasove. Za vsak glas obstaja posebna mapa. Upoštevajte, da so te mape lahko nekje drugje v vašem sistemu, odvisno od tega, kako KDE je bil nameščen. Samo del, ki se začne z `kajongg`, je vedno enak. Obstajata dve skupini glasov z različnimi mesti v datotečnem sistemu:

  - Prednastavljeni glasovi za vsak jezik. Živijo v mapi, kot je `/usr/share/kajongg/voices/LANG`, kjer je LANG koda za vaš jezik. Glasovni imeniki neposredno pod `.../kajongg/voices/` so ameriško-angleške različice. Vnaprej določeni glasovi so naključno dodeljeni igralcem. Ti glasovi imajo imena, kot je “`male1 male2 female1 female2`”, vendar ta imena niso pomembna, uporabnik jih ne bo nikoli videl.

  - Uporabniške glasove je mogoče določiti za določenega uporabnika. Če Kajongg uporablja takšen glas, se lahko samodejno prenese na druge igralce prek interneta. Ti glasovi živijo v mapi, kot je `~/.local/share/apps/kajongg/voices/`. Torej, če je vaše prijavno ime joe, je to morda `/home/joe/.local/share/apps/kajongg/voices/joe/`. Mapa `voices/` morda še ne obstaja - če obstaja, jo ustvarite.

- Zdaj, ko veste, kam postaviti svoj novi glas, ustvarite novo mapo zanj.

- V to podmapo lahko postavite zvočne datoteke. Morajo biti kodirane z zvočnim kompresorjem Ogg Vorbis, imena datotek morajo imeti pripono `. ogg`. Posamezna datoteka ima ime, kot je `s3.ogg` - to je Stone 3. Takšne datoteke bi morali definirati za vse ploščice ter za vse zahtevke in objave. Če pa zvočna datoteka manjka, se ne zgodi nič hudega - tega zvoka preprosto ne boste slišali. Povratek na druge glasove ali jezike deluje samo za celotne glasove, ne pa za posamezne zvočne datoteke.

- Ko definirate vse zvočne datoteke za vnaprej določen glas, se prepričajte, da ima Kajongg proces dovoljenje za pisanje v novo glasovno mapo. Zaženite Kajongg in preizkusite glas. Ko je vse v redu, lahko prekličete dovoljenje za pisanje (in to morate storiti za vnaprej določene glasove). Kajongg samodejno ustvari datoteko z imenom `md5sum`, ki vsebuje kontrolno vsoto vseh zvočnih datotek. Kadarkoli spremenite, dodate ali izbrišete zvočno datoteko za glas, bo Kajongg poskusil znova napisati to datoteko.

Prosim, naj bo zvok kratek, vendar govorite jasno - to igro lahko igrate zelo hitro, ko se je navadite. Lažje je, če si najprej napišete seznam z vsem, kar je treba povedati. Ne berite ga kot zaporedja elementov, poskusite vsak element izgovoriti, kot da je edini in tako kot bi med igranjem. Pustite prostor med predmeti. Branje tega zahteva malo vaje.

To je samo ena možnost za ustvarjanje zvočnih datotek:

- Posnemite zvočno datoteko s programom qarecord in jo shranite v formatu WAV. V tej eni zvočni datoteki izgovorite vse zvoke.

- Uredite to datoteko z urejevalnikom zvoka audacity. V tem urejevalniku z miško označite obseg zvočnih valov. To vlogo bo odigral urednik. Ponavljajte, dokler ne izberete pravega dela. To je morda lažje, če Ogled → Povečaj. Uporabite menijski ukaz Datoteka → Izvozi izbor in shranite v formatu `.ogg`. Pod Možnosti izberite nizko kakovost - to zadostuje in je celo zaželeno, ker skrajša čas za prenos zvokov na druge predvajalnike.

Sledijo imena datotek, ki jih morate ustvariti. Vedno jim pripnite `.ogg`:

Tabela 6.1. Imena zvočnih datotek

s1 .. s9 | Stone 1 do Stone 9
b1 .. b9 | Bambus 1 do bambus 9
c1 .. c9 | Znak 1 do znak 9
we ws ww wn | Vetrovi vzhodni, južni, zahodni, severni
db dr dg | Zmaji modro/beli, rdeči, zeleni
chow pung kong mahjongg | Glavne trditve
originalcall violatesoriginalcall | Prvotni razpis in njegova kršitev
dangerousgame | Igralec sproži top (nevarna igra)
nochoice | Igralec izjavi, da nima druge izbire, kot da igra nevarno igro

Možnosti ploščic
Možnosti ploščic

## Možnosti ploščic

Z izbirnikom Ploščice izberite grafiko za ploščice.

Možnosti ozadja
Možnosti ozadja

## Možnosti ozadja

Z izbirnikom Ozadje izberite grafiko ozadja za igro.

Nekatera ozadja, kot je kitajska pokrajina, potrebujejo nekaj časa za nalaganje. Če menite, da bi se program moral zagnati hitreje ali da spreminjanje velikosti glavnega okna traja predolgo, lahko poskusite z drugim ozadjem.

Urejevalnik nabora pravil
Urejevalnik nabora pravil

## Urejevalnik nabora pravil

Uporabite urejevalnik nabora pravil za prilagajanje nabora pravil. Vnaprej določeni nabori pravil so prikazani v poševni pisavi, prilagojeni nabori pravil pa imajo običajno pisavo. Vnaprej določenih naborov pravil uporabnik ne more spremeniti na noben način, vendar posodobitev Kajongg morda. Posodobitev nikoli ne bo vplivala na prilagojene nabore pravil.

Ko začnete novo igro, boste lahko izbrali nabor pravil za to igro. Uporabijo se lahko vsi nabori pravil, definirani v urejevalniku nabora pravil. Nabor pravil je shranjen skupaj z igro, tako da lahko tukaj vedno spremenite nabore pravil - vaše spremembe bodo vplivale samo na prihodnje igre.

### Pravilo, točke, x2, meje

Preprosto dvakrat kliknite na tisto, kar želite spremeniti. Če so vse vrednosti izbrisane, to pravilo ne bo imelo vpliva na igro. Pravil ni mogoče izbrisati.

### Kopiraj in odstrani

Lahko kopirate in odstranite celotne nize pravil.

Tudi to je mogoče narediti, če obstoječe igre uporabljajo ta nabor pravil, saj ima vsaka igra svojo kopijo nabora pravil. Ogledate si lahko nabore pravil za stare igre: Naložite staro igro in prikažite njeno tabelo rezultatov.

### Primerjaj

Ta ukaz lahko izberete, ko je izbran celoten nabor pravil. Omogoča primerjavo izbranega nabora pravil s katerim koli drugim naborom pravil.

Privzete vezave tipk
Privzete vezave tipk

## Privzete vezave tipk

Privzete bližnjice so naslednje:

F1

  Prikaže ta priročnik.

Ctrl+C

  Zadetek ročne igre.

Ctrl+N

  Igrajte igro s prijatelji ali računalniškimi igralci.

Ctrl+W

  Prekini trenutno igro.

Ctrl+Q

  Zapustite program.

Ctrl+T

  Pokaži tabelo rezultatov.

Ctrl+H

  Prikaži okno za klepet.

Ctrl+G

  Spremenite kot gledanja.

Ctrl+D

  Omogoči ali onemogoči demo način.

Dvigalka+F1

  Kaj je to? pomoč.

Ctrl+Dvigalka+F

  Celozaslonski način.

Dodatek A. Znane težave
Znane težave

# Dodatek A. Znane težave

- V načinu igranja kazni še niso možne.

- Računalniški igralci so še vedno precej neumni.

Dodatek B. Možne funkcije v prihodnosti
Možne funkcije v prihodnosti

# Dodatek B. Možne funkcije v prihodnosti

- Dodajte več naborov pravil. To bi po želji morali storiti ljudje, ki redno uporabljajo te nabore pravil.

Dodatek C. Pogosto zastavljena vprašanja
Pogosto zastavljena vprašanja

# Dodatek C. Pogosto zastavljena vprašanja

C.1. Želim spremeniti videz te igre. Ali lahko?
C.2. Ali lahko uporabim tipkovnico za dodeljevanje ploščic igralcem?

C.1. | Želim spremeniti videz te igre. Ali lahko?
| Da Če želite spremeniti način Kajongg videza uporabite menijsko vrstico, da odprete konfiguracijski pripomoček.
C.2. | Ali lahko uporabim tipkovnico za dodeljevanje ploščic igralcem?
| Da. Glejte Naj Kajongg izračuna rezultat.

Dodatek D. Zasluge in licenca
Zasluge in licenca

# Dodatek D. Zasluge in licenca

Kajongg za KDE

Avtorske pravice programa (c) 2009-2017 Wolfgang Rohdewald `(wolfgang AT rohdewald.de)`

Dokumentacija Copyright (c) 2009-2017 Wolfgang Rohdewald `(wolfgang AT rohdewald.de)`

Prevod: Matjaž Jeran`(matjaz.jeran AT amis.net)`

Dokumentacija je objavljena pod pogoji GNU Free Documentation License.

Pogoji uporabe programa so določeni v GNU General Public License.

Dodatek E. Bibliografija
Bibliografija

# Dodatek E. Bibliografija

- Das Chinesische Mah-Jongg-Spiel Uweja Martensa 2005, Books on Demand GmbH, Norderstedt. Ta knjiga je odlična nemška referenca, ki vsebuje vse, kar želite vedeti o pravilih, ki se uporabljajo v Nemčiji, in mnogih drugih vidikih igre.

- The Complete Book of Mah-Jongg avtorja A. D. Millingtona, 1977 (z več mehkimi izdajami do leta 2003), Weidenfeld & Nicolson, London. To je ultimativna referenca za klasični kitajski Mah Jong, kot se igra v zahodnem svetu. Lahko vam da dragocene namige o strategijah igre.

- Mah-Jong Gwyn Headley in Yvonne Seeley, 3. izdaja, 2008, A & C Black Publishers Ltd., London. Ta knjiga je referenca, ki je zelo enostavna za uporabo in se osredotoča na pravila, ki se uporabljajo v Veliki Britaniji in jih določa BMJA (The British Mah Jong Association).

- https://en.wikipedia.org/wiki/Mahjong

- https://de.wikipedia.org/wiki/Mah-Jongg

Dodatek F. Namestitev
Namestitev

# Dodatek F. Namestitev

Za Linux: vaša distribucija bi ga morala imeti zapakiranega za vas.

Za Windows: glejte https://www.linux-apps.com/p/1109453/ za namestitveni program za Windows.

Če želite prenesti vir in ročno namestiti:

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

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

- Za Windows: preberite `README.windows`

Kajongg je odvisen od teh paketov: (imena paketov debian v oklepajih)

- Python 3.8 ali novejši (python3)

- Qt6.5 ali novejši (python3-pyqt6 in python3-pyqt6.qtsvg)

- python vezave za Qt6 (python3-pyqt6)

- knjižnica python twisted 16.6.0 ali novejša (python3-twisted)

- sqlite3 (libsqlite3-0)