Ghid

Codul sursă al jocului cu numere Tenguin: ce e construit și ce editezi

Regulile de potrivire, bonusurile, fișierul de configurare pe care îl editezi fără build și părțile care cer sursa TypeScript.

Tenguin key art: un pinguin cu fular roșu care face cu mâna de pe o banchiză, lângă plăcile cu numerele 3 și 7.

Codul sursă pentru un joc cu numere merită cumpărat când vrei un puzzle finalizat de tip „fă zece”, cu hartă de niveluri, bonusuri și conținut zilnic, și preferi să ajustezi prețurile și brandingul decât să scrii singur motorul de potrivire. Tenguin este acest pachet: jucătorii împerechează numere egale sau două numere care dau zece, pe zece teme insulare ilustrate, la prețul de listă de 39 USD.

Ghidul acesta este pentru cel care va deschide dosarul. Explică regulile pe care le aplică codul, ce se află în fișierul de configurare, ce cere sursa și ce setări te pot pune în dificultate pe un site live. Dacă vrei doar esențialul: majoritatea modificărilor comerciale înseamnă un fișier text și o reîncărcare a paginii.

Regulile pe care codul tău de joc cu numere le gestionează deja

Jucătorii ating o placă, apoi alta. Perechea dispare dacă numerele sunt egale sau dau împreună zece. Cele două plăci pot fi una deasupra celeilalte, alături, pe diagonală, cu spații goale între ele sau la capătul unui rând și începutul următorului.

Eliminarea unui rând întreg declanșează o Avalanche (avalanșă), iar o serie de potriviri ridică multiplicatorul de scor. Când nu mai rămân perechi, Snowfall (ninsoarea) copiază pe fundul tablei numerele rămase. Fiecare nivel acordă până la trei stele.

Trecerea de la un capăt la altul al rândului și spațiile goale sunt verificările pe care un motor de potrivire a numerelor trebuie să le facă bine: o pereche care pare legală jucătorului trebuie să fie legală și pentru cod. Aici aceste verificări fac parte din jocul livrat.

Încearcă regulile în demo-ul Tenguin

Bonusuri, conținut zilnic și modul Relax

Cinci bonusuri apar pe etape, ceea ce dă începutului o curbă de învățare:

  • Hint (indiciu).
  • Undo (anulare), din nivelul 3.
  • Snowfall (ninsoare), care reumple tabla cu copii ale numerelor rămase.
  • Peck (ciugulire), care elimină o placă, din nivelul 8.
  • Wild, un fulg care se potrivește cu orice număr, din nivelul 12.

O provocare zilnică, construită din data de azi, misiunile zilnice și cufele pe capitole îi dau jucătorului un motiv să revină. Modul Relax nu are stele, nu are grabă și are Snowfall nelimitat, pentru cei care vor doar să șteargă plăcile.

Ținutele pentru pinguin vin în patru categorii: fulare, pălării, culori și efecte. Se cumpără cu monedele câștigate în joc, iar unele niveluri deblochează câte una. Nu se folosesc bani reali.

Ce se află în descărcare

  • Un dosar game/ gata de găzduit, cu grafică locală, fonturi, fișiere audio și dependențe de rulare.
  • Cod sursă lizibil, cu configurare și notele de licență ale componentelor terțe.
  • 49 de teste automate.
  • Un ghid ilustrat offline pentru cumpărător, în 14 limbi, cu capturi de ecran în engleză.

Interfața vine în 14 limbi: engleza, portugheza, spaniola, franceza, germana, italiana, olandeza, poloneza, turca, rusa, indoneziana, japoneza, coreeana și chineza simplificată. Stiva este TypeScript, JavaScript și HTML5, cu Vite pentru compilarea sursei. Fișierele includ HTML, CSS, JavaScript, JSON, TypeScript, WebP, PNG și MP3.

Un lucru de știut când te uiți la pagina produsului: panourile ilustrate sunt grafică promoțională, iar galeria de capturi arată jocul real. Judecă aspectul după capturi și după demo.

Fișierul de configurare: modificări fără build

Majoritatea setărilor se află în tenguin.config.js, un fișier text lângă index.html. Modifici o valoare, încarci fișierul și reîncarci pagina. Nu ai nevoie de Node.js și nu există pas de build. Fișierul conține:

  • Titlul paginii și calea logo-ului.
  • Culoarea de accent.
  • Limba implicită.
  • Monedele de start.
  • Recompensele pentru victorie, stele și Relax.
  • Prețurile bonusurilor și ale ținutelor.

Acoperă două nevoi frecvente: propriul brand pe ecran și o economie ajustată la publicul tău. Dacă jucătorii cred că bonusurile sunt prea scumpe, schimbi un număr, nu codul.

O setare cere atenție: cheia de salvare. Alege-o înainte de lansare și nu o mai atinge după. Dacă o schimbi pe un site live, fiecare jucător își pierde progresul.

Ce cere sursa TypeScript

Structura nivelurilor, dialogurile, grafica din joc și clipurile vocale noi se modifică în ediția cu sursă și apoi se recompilează cu Node.js 22.13 sau mai nou. Node nu e necesar ca să găzduiești jocul, doar ca să-l recompilezi.

Harta nivelurilor are zece teme insulare ilustrate. După a zecea, progresul continuă cu niveluri generate și cu temele existente refolosite. Adăugarea unei a unsprezecea teme înseamnă grafică nouă și poziții noi pe hartă în sursă, deci planifică-o ca muncă de artă plus puțin cod, nu ca simplă setare.

Rulează cele 49 de teste după fiecare modificare a sursei. Sunt cel mai rapid mod de a vedea dacă o modificare a stricat o regulă în altă parte.

  1. Fă o copie de rezervă a pachetului.
  2. Fă modificarea în sursă.
  3. Rulează testele.
  4. Compilează și înlocuiește dosarul game/ găzduit cu rezultatul complet.
  5. Joacă câteva niveluri pe un telefon și pe un browser de desktop.

Găzduire, integrare și accesibilitate

Încarcă conținutul dosarului game/ pe o găzduire statică HTTP(S), într-un subdosar dacă vrei. Nu e nevoie de PHP sau de bază de date. Deschiderea fișierelor direct de pe disc cu file:// nu este suportată, deci testează de pe un server web.

Jocul rulează în versiunile actuale de Chrome, Edge, Firefox și Safari, pe calculator, tabletă sau telefon. Jucătorii îl încarcă de la adresa ta; nu este o aplicație offline instalabilă. Setările includ plăci mari, contrast ridicat, un mod calm și vibrație pe telefoanele care o acceptă, ceea ce ajută dacă publicul include jucători în vârstă sau copii.

Pachetul nu conține un proiect de aplicație nativă și nu are un furnizor de publicitate conectat. Dacă ai nevoie de oricare dintre ele, sau vrei jocul instalat pe serverul tău, cotăm lucrarea pe proiect.

Cere o ofertă pentru lucrări personalizate

Limite și licență, într-un singur paragraf

Tenguin nu are salvări în cloud, conturi online, clasamente la distanță, achiziții cu bani reali sau furnizor de publicitate conectat, iar aplicațiile native, găzduirea și dezvoltarea personalizată nu sunt incluse. Progresul rămâne în stocarea locală a browserului. O singură achiziție oferă o licență perpetuă, neexclusivă, pentru un produs final, al tău sau al unui singur client, pe care jucătorii îl pot folosi gratuit sau cu monetizare prin publicitate. Poți modifica codul, grafica și audio din produsul respectiv și poți înlocui brandul nostru cu al tău, dar nu poți revinde sau distribui separat șablonul, sursa sau activele lui. Suportul durează 6 luni, sau 12 cu extensia de la finalizarea comenzii. Prețul de listă este de 39 USD; până pe 30 noiembrie 2026 o promoție Black Friday scade cu 15% fiecare șablon, deci Tenguin costă 33,15 USD, iar din 1 decembrie prețurile revin la listă.

Citește termenii licenței și ai suportului

Întrebări frecvente

Care sunt regulile unui joc cu numere?

În Tenguin, două plăci dispar când au același număr sau dau împreună zece, iar între ele nu se află nimic în afară de spații golite. Perechile pot fi verticale, orizontale, diagonale sau pot trece de la capătul unui rând la începutul următorului.

Trebuie să compilez jocul?

Nu. Încarci conținutul dosarului game/ pe o găzduire HTTP(S). Compilarea e necesară doar dacă modifici sursa.

Ce pot schimba fără recompilare?

Titlul, calea logo-ului, culoarea de accent, limba implicită, monedele de start, recompensele, prețurile bonusurilor și ale ținutelor, toate în tenguin.config.js.

Câte niveluri există?

Nivelurile merg pe o hartă cu zece teme insulare. După a zecea temă, jocul continuă cu niveluri generate și teme refolosite.

Pot organiza un concurs cu premii cu el?

Nu îți recomandăm. Conținutul zilnic folosește ceasul dispozitivului, iar înregistrările sunt locale, deci nu sunt o bază corectă pentru premii.

Funcționează pe tablete?

Da. Rulează în browserele actuale pe calculatoare, tablete și telefoane, cu opțiunea plăci mari din Setări.

Pentru cine e potrivit și două puzzle-uri de comparat

Un joc cu numere se potrivește portalurilor casual, site-urilor cu accent educativ și brandurilor care vor un puzzle calm cu un motiv zilnic de întoarcere. Regula „fă zece” se explică ușor, iar bonusurile apar suficient de rar cât să-l învețe pe jucător din mers.

Pentru comparație: Gridspark este un puzzle cu blocuri 8×8, cu o mutare fulger ZAP și o provocare zilnică cu sămânță, la prețul de listă de 29 USD. Bodoku este un puzzle de logică fantomă cu 180 de niveluri pe șase aripi de castel, la prețul de listă de 59 USD. Amândouă au 14 limbi de interfață.

Vezi Gridspark, puzzle-ul cu blocuri

Vezi Bodoku, puzzle-ul de logică

Două șabloane în aceeași comandă primesc fiecare licență cu 5% reducere, trei primesc 10%, patru 15%, iar cinci sau mai multe 20%.

Cumpără codul sursă pentru jocul cu numere Tenguin