Kildekode til tallspill: slik er Tenguin bygget og hva du bør endre
Parreglene, boosterne, konfigurasjonsfilen du redigerer uten bygging, og delene som krever TypeScript-kildekoden.
Kildekode til tallspill er et godt kjøp når du vil ha et ferdig make-ten-puslespill med nivåkart, boostere og daglig innhold, og heller vil justere priser og merkevare enn å skrive en matchingsmotor selv. Tenguin er en slik pakke: spillerne parer like tall, eller to tall som summerer til ti, over ti illustrerte øytemaer, for $39 til listepris.
Denne guiden er for deg som skal åpne mappen. Den forklarer reglene koden håndhever, hva som ligger i konfigurasjonsfilen, hva som krever kildekoden, og hvilke innstillinger som kan skade deg på en live side. Kort oppsummert: de fleste kommersielle endringer er én tekstfil og en sideinnlasting på nytt.
Reglene kildekoden til tallspillet allerede håndterer
Spillerne trykker på én brikke, og så på en annen. Paret forsvinner hvis tallene er like eller summerer til ti. De to brikkene kan ligge over eller under hverandre, ved siden av hverandre, på en diagonal, med tomme felt mellom seg, eller over slutten av én rad og starten av den neste.
Når en hel rad fjernes, utløses en Avalanche (ras), og en serie øker poengmultiplikatoren. Når det ikke er flere par igjen, kopierer Snowfall (snøfall) tallene som fortsatt står på brettet ned til bunnen. Hvert nivå gir opptil tre stjerner.
Overgangene mellom radene og hullene er kontrollene en tallmatch-motor må få riktige: et par som ser lovlig ut for spilleren, må også være lovlig for koden. Her er disse kontrollene en del av det leverte spillet.
Boostere, daglig innhold og Relax-modus
Fem boostere låses opp etter hvert, slik at de tidlige nivåene gir en lærekurve:
- Hint.
- Undo (angre), fra nivå 3.
- Snowfall, som fyller brettet på nytt med kopier av de gjenværende tallene.
- Peck, som fjerner én brikke, fra nivå 8.
- Wild, en snøflak som kan pare seg med alle tall, fra nivå 12.
En daglig utfordring bygget på dagens dato, daglige oppdrag og kapittelkister gir spillerne en grunn til å komme tilbake. Relax-modus (Relax mode) har ingen stjerner, ingen tidspress og ubegrenset Snowfall, for spillere som bare vil fjerne brikker.
Antrekk til pingvinen finnes i fire kategorier: skjerf, luer, farger og effekter. De kjøpes med mynter som tjenes i spillet, og noen nivåer låser opp ett. Ingen ekte penger er involvert.
Hva som ligger i nedlastingen
- En klar til opplasting game/-mappe med lokal grafikk, skrifttyper, lydfiler og nødvendige avhengigheter for kjøring.
- Lesbar kildekode med konfigurasjon og lisensmerknader for tredjepart.
- 49 automatiske tester.
- En illustrert veiledning for kjøpere som fungerer uten nett, på 14 språk, med skjermbilder på engelsk.
Grensesnittet finnes på 14 språk: engelsk, portugisisk, spansk, fransk, tysk, italiensk, nederlandsk, polsk, tyrkisk, russisk, indonesisk, japansk, koreansk og forenklet kinesisk. Stacken er TypeScript, JavaScript og HTML5, med Vite for kildebygget. Filene omfatter HTML, CSS, JavaScript, JSON, TypeScript, WebP, PNG og MP3.
Én ting å vite når du ser på produktsiden: de illustrerte panelene er reklamegrafikk, mens skjermbildegalleriet viser det faktiske spillet. Bedøm utseendet etter skjermbildene og demoen.
Konfigurasjonsfilen: endringer uten bygging
De fleste innstillingene ligger i tenguin.config.js, en tekstfil ved siden av index.html. Endre en verdi, last opp filen og last siden på nytt. Ingen Node.js og ingen byggesteg. Filen inneholder:
- Sidetittelen og stien til logoen.
- Aksentfargen.
- Standardspråket.
- Startmynter.
- Belønninger for seier, stjerner og Relax-modus.
- Priser på boostere og antrekk.
Det dekker to vanlige behov: din egen merkevare på skjermen og en økonomi tilpasset publikummet ditt. Hvis spillerne synes boosterne er for dyre, endrer du et tall, ikke koden.
Én innstilling krever forsiktighet: lagringsnøkkelen (save key). Velg den før lansering, og la den være etterpå. Endrer du den på en live side, mister alle spillere fremdriften sin.
Hva som krever TypeScript-kildekoden
Nivåoppsett, dialog, grafikken inne i spillet og nye stemmeklipp endres i kildeutgaven, og bygges deretter på nytt med Node.js 22.13 eller nyere. Node trengs ikke for å være vert for spillet, bare for å bygge det på nytt.
Nivåkartet har ti illustrerte øytemaer. Etter det tiende fortsetter spillet med genererte nivåer og gjenbrukte temaer. Å legge til et ellevte tema krever ny grafikk og nye posisjoner på kartet i kildekoden, så planlegg det som grafikkarbeid pluss litt kode, ikke som en innstilling.
Kjør de 49 testene etter hver endring i kildekoden. De er den raskeste måten å se om en redigering har ødelagt en regel et annet sted.
- Ta sikkerhetskopi av pakken.
- Gjør endringen i kildekoden.
- Kjør testene.
- Bygg på nytt, og erstatt den hostede game/-mappen med hele resultatet.
- Spill noen nivåer på en telefon og i en nettleser på datamaskin.
Hosting, innbygging og tilgjengelighet
Last opp innholdet i game/ til statisk HTTP(S)-hosting, i en undermappe om du vil. Det trengs ingen PHP eller database. Å åpne filene fra disk med file:// støttes ikke, så test fra en webserver.
Spillet kjører i nyeste versjon av Chrome, Edge, Firefox og Safari på datamaskin, nettbrett og telefon. Spillerne laster det fra adressen din; det er ikke en app som kan installeres for bruk uten nett. Innstillingene (Settings) inkluderer store brikker, høy kontrast, en rolig modus og vibrasjon på telefoner som støtter det. Det hjelper hvis publikummet ditt inkluderer eldre spillere eller barn.
Det finnes ikke noe nativt app-prosjekt i pakken, og ingen tilkoblet annonseleverandør. Trenger du noe av dette, eller vil ha spillet installert på serveren din, gir vi tilbud per prosjekt.
Be om et tilbud på tilpasset arbeid
Begrensninger og lisens i ett avsnitt
Tenguin har ingen skylagring, nettkontoer, eksterne ledertavler, kjøp for ekte penger eller tilkoblet annonseleverandør. Native apper, hosting og tilpasset utvikling er ikke inkludert. Fremdriften lagres i nettleserens lokale lagring. Ett kjøp gir en evigvarende, ikke-eksklusiv lisens for ett sluttprodukt, ditt eller én kundes, som spillerne kan bruke gratis eller med annonseinntekter. Du kan endre koden, grafikken og lyden i det produktet og erstatte vår merkevare med din egen, men du kan ikke videreselge eller dele malen, kildekoden eller ressursene alene. Støtten varer i 6 måneder, eller 12 med tillegget i kassen. Listeprisen er $39. Frem til 30. november 2026 gir en Black Friday-kampanje 15 % rabatt på alle maler, så Tenguin koster $33,15, og fra 1. desember går prisene tilbake til listepris.
Les lisens- og støttevilkårene
Vanlige spørsmål
Hva er reglene i et tallspill?
I Tenguin forsvinner to brikker når de har samme tall eller summerer til ti, og det er bare tomme felt mellom dem. Par kan være vertikale, horisontale eller diagonale, eller gå fra slutten av én rad til starten av den neste.
Må jeg bygge spillet?
Nei. Last opp innholdet i game/ til HTTP(S)-hosting. Bygging trengs bare hvis du endrer kildekoden.
Hva kan jeg endre uten å bygge på nytt?
Tittel, sti til logo, aksentfarge, standardspråk, startmynter, belønninger, priser på boostere og priser på antrekk, alt i tenguin.config.js.
Hvor mange nivåer er det?
Nivåene går langs et kart med ti øytemaer. Etter det tiende temaet fortsetter spillet med genererte nivåer og gjenbrukte temaer.
Kan jeg kjøre en premiekonkurranse med det?
Vi fraråder det. Daglig innhold bruker enhetens klokke, og rekordene er lokale, så de er ikke et rettferdig grunnlag for premier.
Fungerer det på nettbrett?
Ja. Det kjører i nyeste nettlesere på datamaskin, nettbrett og telefon, med et alternativ for store brikker under Settings.
Hvem det passer for, og to puslespill å sammenligne
Et tallspill passer for casual-portaler, nettsteder med pedagogisk fokus og merkevarer som vil ha et rolig puslespill med en daglig grunn til å komme tilbake. Make-ten-regelen er enkel å forklare, og boosterne kommer sakte nok til at de lærer deg underveis.
For sammenligning: Gridspark er et 8×8 blokkpuslespill med et lynraskt ZAP-trekk og en fast daglig utfordring, $29 til listepris. Bodoku er et logikkpuslespill med spøkelser, med 180 nivåer fordelt på seks slottfløyer, $59 til listepris. Begge har 14 språk i grensesnittet.
Se Gridspark, blokkpuslespillet
To maler i samme bestilling gir 5 % rabatt på hver lisens, tre gir 10 %, fire 15 % og fem eller flere 20 %.