Izvorni kod igre domine: pravila, računalni protivnici i 58 testova

Izvorni kod igre domine izgleda jednostavno dok ne provjerite rubne slučajeve. Tko otvara kad nitko nema dublet? Što se dogodi kad je gomila prazna i oba igrača prolaze? Kako se bodovi računaju na kraju blokiranog kola? Predložak koji na ta pitanja odgovara kodom i to dokazuje testovima vrijedi više od onoga s ljepšim pločicama. Pip Club Dominoes, naš predložak dupla šestica, dolazi s 58 automatiziranih testova koji pokrivaju pravila, računalnog protivnika, raspored stola, spremanje i 14 prijevoda.

Ovaj vodič objašnjava koja pravila igra, kako je paket organiziran, što možete promijeniti uređivačem teksta, a što traži ponovnu izgradnju, kako ga hostati i što licenca dopušta. Nazivi datoteka dolaze iz ilustriranog vodiča za kupce koji ide uz izdanje.

Jedna stvar prije svega: Pip Club se igra protiv računala. Nema online načina ni načina za dva igrača na jednom uređaju.

Pravila koja ova igra domina igra

Pravila su mjesto gdje se predlošci domina najviše razlikuju, pa ih provjerite prema onome što vaši igrači očekuju. Pip Club igra klasičnu igru blokova dupla šestica, jedan igrač protiv jednog računalnog protivnika.

• 28 pločica od 0 do 6. Svaki igrač dobije 7, a ostalih 14 ostaje u gomili.
• Najveći dublet otvara. Bez dubleta otvara najveći zbroj, a kod izjednačenja najveća polovica.
• Stol uvijek ima dva kraja, A i B. Pločica mora odgovarati kraju, a nula odgovara nuli.
• Dupleti mogu ležati poprečno, ali se nikad ne granaju i ne daju dodatni potez.
• Bez podudaranja vučete jednu pločicu po jednu dok ne možete odigrati. Kad je gomila prazna i nema podudaranja, prolazite.
• Domino (kad igrač isprazni ruku): tko isprazni ruku, dobiva zbroj koji je ostao u ruci protivnika.
• Lock (zaključavanje stola): dva uzastopna prolaska uz praznu gomilu zaključavaju stol. Niži zbroj dobiva razliku, a jednaki zbrojevi su neriješeni.

Quick Round (brzo kolo) završava nakon jednog kola. Points Match (utakmica do bodova) igra kola dok netko ne dosegne 50 ili 100. Kampanja ima 9 susreta u 3 poglavlja, po jedan za svako druženje, a svaka pobjeda donosi pečat.

Što dolazi u paketu

Igrači se suočavaju s tri računalna protivnika s vlastitom osobnošću: Rico (DJ rakun), Faísca (klizačka lisica) i Nix (mačka umjetnica), svaki na Easy (lako), Normal (normalno) ili Hard (teško). Pločice koje se mogu igrati svijetle, stol prikazuje gdje će pločica pasti, a savjet predlaže potez. Tri su druženja, Rooftop (krov), Skate Park i Midnight Arcade (ponoćna arkada), šest skupljivih setova pločica, pečati kampanje i statistika. Miš, dodir i tipkovnica rade.

• game/: gotova verzija za hosting, s index.html, pip.config.js, modules/, lib/, assets/ i licenses/.
• game/lib/phaser.js: Phaser 3.90.0, čitljiv, pod MIT licencom.
• source/: uređivi TypeScript, grafika, glazba, prijevodi i automatizirani testovi.
• documentation/index.html i DOCUMENTATION.html: vodič za kupce na 14 jezika, koji se otvara bez interneta.
• THIRD-PARTY-LICENSES/: obavijesti za Phaser i font Barlow Condensed.

Grafika i glazba su originalna sredstva proizvoda, licencirana kupcu uz stavku. Sučelje ima 14 jezika i prati jezik preglednika; nema snimljenog glasa, pa svaka replika protivnika slijedi odabrani jezik.

Pogledajte Pip Club Dominoes: demo, vodič i cijenu

Mijenjajte bez izgradnje: pip.config.js

Pored index.html stoji pip.config.js. Otvorite ga u bilo kojem uređivaču teksta, promijenite vrijednost, prenesite datoteku i ponovno učitajte stranicu. Tri postavke su tu.

• title: naslov kartice preglednika.
• saveKey: ime pod kojim se sprema napredak. Zadano je pip-club.
• defaultLanguage: početni jezik. Ako je prazno, igra prati preglednik.

Na živoj stranici ne mijenjajte saveKey. Drugi ključ znači da igra ignorira postojeći napredak i kreće s novim spremanjem, što je korisno za drugu kopiju, a bolno za nadogradnju.

Gdje žive tekstovi, grafika i pločice u izvornom kodu

• Tekstovi i prijevodi: source/src/ui/i18n.ts i source/src/ui/locales/.
• Grafika likova, scene i logotip: source/src/assets/club/.
• Glazba: source/src/assets/music/.
• Boje pločica: source/src/art/palette.ts i source/src/art/tileArt.ts.
• Testovi: source/tests/.

Tipičan posao brendiranja ide ovim redom: logotip i grafika scene u assets/club/, zatim paleta pločica, pa tekst u lokalizacijama. White label je dopušten, pa vaš brend može zamijeniti naš. Mijenjanje igranja računala ili nekog pravila dublji je posao; pokrenite testove prije i poslije, jer pokrivaju oboje.

Ako gradite mali katalog stolnih igara, dva druga naša predloška dobro stoje uz ovaj.

Ludo Cats: Ludo s mačićima, računalo na tri razine ili prijatelji na jednom uređaju

Boba Club: pasijans Klondike s kampanjom od 12 podjela

Ponovna izgradnja nakon uređivanja TypeScripta

Mapa game/ je već izgrađena, pa instaliranje igre ne treba Node.js. Trebat će vam tek nakon promjene izvornog koda.

1. Instalirajte Node.js 22.12 ili noviji (vodič je testiran s 22.23). npm dolazi uz njega.
2. Otvorite terminal u source/, gdje su package.json i package-lock.json.
3. Pokrenite npm ci. Instalira točno zaključane verzije Phasera, Vitea, Vitesta i TypeScripta.
4. Pokrenite npm test (58 testova) i npm run typecheck. Ispravite greške prije izgradnje.
5. Pokrenite npm run build. Izlaz je source/dist-static/, s index.html, modules/, lib/, assets/ i licenses/.
6. Napravite sigurnosnu kopiju hostane igre, zatim prenesite sadržaj dist-static/ točno kao game/.

Vodič upozorava protiv npm audit fix i npm update, jer mijenjaju testirane verzije. Ako se pojavi problem s paketom, vratite isporučeni par package.json i package-lock.json.

Hosting na vašoj stranici

Prenesite samo sadržaj game/, tako da index.html bude izravno u ciljnoj mapi, primjerice public_html/games/pip-club/. Uz njega držite assets/, lib/, modules/, licenses/ i pip.config.js te zadržite velika i mala slova u svakom nazivu. Nemojte prenositi source/, documentation/ ni ZIP.

• Svaki statički HTTP(S) hosting radi, u bilo kojoj podmapi bilo koje domene, jer igra koristi relativne putanje.
• Za igranje nisu potrebni baza podataka, PHP ni servis Node.js.
• Otvaranje index.html s računala (file://) nije podržano.
• Host mora poslužiti .js, .webp, .woff2 i .mp3 s normalnim vrstama.
• Igra ne šalje pozive za analitiku, ljestvice, plaćanja ni oglase.

Spremanja ostaju u pregledniku igrača, u IndexedDB ili localStorage, i ne sinkroniziraju se među uređajima. Za nadogradnju prenesite novi game/ preko starog, zadržite pip.config.js i njegov saveKey, a ako se stara verzija i dalje prikazuje, obrišite predmemorirane datoteke, a ne podatke stranice.

Što ne uključuje i licenca

Izdanje nema online ni lokalni način za dva igrača, nema spremanja u oblaku, online ljestvice, kupnji za pravi novac ni SDK za oglase. Nativne aplikacije, hosting i prilagođeni razvoj također su izvan paketa. Dodavanje oglasa, trgovine ili sinkronizacije je posao za programera koji treba vaše račune i odobrenja.

Pip Club stoji na 49 USD, što uz promociju Black Friday do 30. studenoga 2026. postaje 41,65 USD; popust za paket od 5 % do 20 % vrijedi kad kupite dva ili više predložaka zajedno. Licenca je trajna i nekskluzivna, za jedan krajnji proizvod, vaš ili jednog klijenta. Kod, grafiku i zvuk smijete mijenjati, staviti svoj brend i pustiti igrače besplatno ili uz oglase, ali ne smijete preprodavati predložak ni njegov kod samostalno. Podrška traje šest mjeseci, odnosno dvanaest uz produženje; sve što ide dalje od instalacije i popravka grešaka nudi se po ponudi.

Pročitajte uvjete licence i podrške

Često postavljana pitanja

Je li izvorni kod igre domine u TypeScriptu ili JavaScriptu?

Izvor je čitljiv, neminificiran TypeScript. Mapa game/ spremna za hosting je izgrađeni JavaScript, pa su vam alati za TypeScript potrebni samo za mijenjanje igre.

Mogu li se igrati dvije osobe jedna protiv druge?

Ne. Igrači se suočavaju s računalnim protivnicima na jednom uređaju. Nema online ni lokalnog načina za dva igrača.

Koju varijantu domina igra?

Klasična dupla šestica, jedan protiv jednog, s vučenjem iz gomile, prolascima i pravilom zaključavanja. Domino boduje preostali zbroj protivnika, a zaključan stol ide onome s nižim zbrojem.

Što mogu promijeniti bez ponovne izgradnje?

pip.config.js postavlja naslov preglednika, ključ spremanja i početni jezik. Pravila, grafika, tekstovi i glazba mijenjaju se u izvornom kodu i traže ponovnu izgradnju.

Radi li offline?

Ne poziva vanjske servise, ali nije aplikacija za instalaciju za rad bez interneta. Igrači moraju doći do vaše web-adrese da bi je učitali.

Je li ovo baza za domine koja vam treba?

Pip Club odgovara stranici ili portalu koji želi klasičnu stolnu igru za sve uzraste, studiju koji gradi brendiranu igru domina za jednog klijenta te programeru koji želi čitljiv TypeScript s računalnim protivnikom i pravim jediničnim testovima. Ne odgovara projektu kojem ljudi trebaju igrati jedni protiv drugih, online ili na jednom ekranu; to je prilagođeni rad od početka.

Odigrajte demo Pip Cluba i kupite licencu

Trebate drugačiji skup pravila ili više licenci? Zatražite ponudu