Codice sorgente di un gioco number match: come è fatto Tenguin
Le regole degli abbinamenti, i potenziamenti, il file di configurazione che modifichi senza build e le parti che richiedono il sorgente TypeScript.
Il codice sorgente di un gioco number match è un buon acquisto quando vuoi un puzzle "fai dieci" già finito, con mappa dei livelli, potenziamenti e contenuti giornalieri, e preferisci regolare prezzi e marchio invece di scrivere un motore di abbinamento. Tenguin è questo pacchetto: si accoppiano numeri uguali o due numeri che sommati fanno dieci, attraverso dieci temi di isole illustrate, a $39 di listino.
Questa guida è per chi aprirà la cartella. Spiega le regole che il codice fa rispettare, cosa sta nel file di configurazione, cosa richiede il sorgente e quali impostazioni possono fare danni su un sito già online. Se ti basta il succo: la maggior parte delle modifiche commerciali si fa in un file di testo e con un ricaricamento della pagina.
Le regole che il codice sorgente del gioco number match gestisce già
Il giocatore tocca una tessera, poi un'altra. La coppia sparisce se i numeri sono uguali o se sommati fanno dieci. Le due tessere possono stare una sopra l'altra, una accanto all'altra, in diagonale, con spazi già liberati in mezzo, oppure a cavallo tra la fine di una riga e l'inizio della successiva.
Liberare un'intera riga scatena un'Avalanche (valanga), e una serie di abbinamenti alza il moltiplicatore del punteggio. Quando non restano coppie, lo Snowfall (nevicata) copia in fondo i numeri ancora sul tabellone. Ogni livello assegna fino a tre stelle.
Il passaggio da una riga all'altra e gli spazi vuoti sono i controlli che un motore number match deve fare bene: una coppia che sembra valida al giocatore deve esserlo anche per il codice. Qui questi controlli fanno parte del gioco consegnato.
Prova le regole nella demo di Tenguin
Potenziamenti, contenuti giornalieri e modalità Relax
I cinque potenziamenti arrivano per gradi, così i primi livelli fanno anche da tutorial:
- Hint (suggerimento).
- Undo (annulla), dal livello 3.
- Snowfall, che riempie di nuovo il tabellone con copie dei numeri rimasti.
- Peck (becco), che toglie una tessera, dal livello 8.
- Wild (jolly), un fiocco che si abbina a qualsiasi numero, dal livello 12.
Una sfida giornaliera costruita sulla data di oggi, missioni quotidiane e forzieri di capitolo danno ai giocatori un motivo per tornare. La modalità Relax non ha stelle, né fretta, e lo Snowfall è illimitato, per chi vuole solo liberare tessere.
Gli accessori del pinguino sono di quattro tipi: sciarpe, cappelli, colori ed effetti. Si comprano con le monete guadagnate nel gioco, e alcuni livelli ne sbloccano uno. Non c'è denaro reale di mezzo.
Cosa c'è nel download
- Una cartella game/ pronta da pubblicare, con grafica, font, file audio e dipendenze di runtime in locale.
- Codice sorgente leggibile, con configurazione e note di licenza di terze parti.
- 49 test automatici.
- Una guida illustrata offline per l'acquirente in 14 lingue, con schermate in inglese.
L'interfaccia è disponibile in 14 lingue: inglese, portoghese, spagnolo, francese, tedesco, italiano, olandese, polacco, turco, russo, indonesiano, giapponese, coreano e cinese semplificato. Lo stack è TypeScript, JavaScript e HTML5, con Vite per la build del sorgente. I file sono HTML, CSS, JavaScript, JSON, TypeScript, WebP, PNG e MP3.
Una cosa da sapere quando guardi la pagina del prodotto: i pannelli illustrati sono grafica promozionale, mentre la galleria di schermate mostra il gioco vero. Giudica l'aspetto dalle schermate e dalla demo.
Il file di configurazione: modifiche senza build
La maggior parte delle impostazioni sta in tenguin.config.js, un file di testo accanto a index.html. Cambi un valore, carichi il file e ricarichi. Niente Node.js e nessuna build. Contiene:
- Il titolo della pagina e il percorso del logo.
- Il colore d'accento.
- La lingua predefinita.
- Le monete iniziali.
- Le ricompense per vittoria, stelle e Relax.
- I prezzi dei potenziamenti e degli accessori.
Copre due esigenze frequenti: il tuo marchio sullo schermo e un'economia tarata sul tuo pubblico. Se i giocatori trovano i potenziamenti troppo cari, cambi un numero, non il codice.
Un'impostazione va maneggiata con cura: la chiave di salvataggio. Sceglila prima del lancio e poi lasciala stare. Cambiarla su un sito già online fa perdere i progressi a tutti i giocatori.
Cosa richiede il sorgente TypeScript
Disposizione dei livelli, dialoghi, grafica interna al gioco e nuove clip vocali si cambiano nell'edizione sorgente, poi si rifà la build con Node.js 22.13 o superiore. Node non serve per pubblicare il gioco, solo per ricostruirlo.
La mappa dei livelli ha dieci temi di isole illustrate. Dopo il decimo si prosegue con livelli generati che riutilizzano i temi esistenti. Aggiungere un undicesimo tema significa nuova grafica e nuove posizioni sulla mappa nel sorgente: pianificalo come lavoro grafico più un po' di codice, non come un'impostazione.
Esegui i 49 test dopo ogni modifica al sorgente. Sono il modo più veloce per capire se una modifica ha rotto una regola da qualche altra parte.
- Fai una copia di sicurezza del pacchetto.
- Fai la modifica nel sorgente.
- Esegui i test.
- Fai la build e sostituisci la cartella game/ pubblicata con l'output completo.
- Gioca qualche livello su un telefono e su un browser desktop.
Hosting, incorporamento e accessibilità
Carica il contenuto di game/ su un hosting statico HTTP(S), anche in una sottocartella. Non servono PHP né database. Aprire i file dal disco con file:// non è supportato, quindi prova da un server web.
Il gioco funziona nelle versioni attuali di Chrome, Edge, Firefox e Safari su computer, tablet o telefono. I giocatori lo caricano dal tuo indirizzo; non è un'app installabile offline. Nelle impostazioni ci sono tessere grandi, alto contrasto, una modalità calma e la vibrazione sui telefoni che la supportano, utile se il tuo pubblico comprende giocatori anziani o bambini.
Il pacchetto non contiene un progetto di app nativa né un fornitore pubblicitario collegato. Se ti serve uno dei due, o vuoi il gioco installato sul tuo server, quotiamo quel lavoro progetto per progetto.
Chiedi un preventivo per un lavoro su misura
Limiti e licenza in un paragrafo
Tenguin non ha salvataggi nel cloud, account online, classifiche remote, acquisti con denaro reale né un fornitore pubblicitario collegato; app native, hosting e sviluppo su misura non sono inclusi. I progressi restano nella memoria locale del browser. Un acquisto dà una licenza perpetua e non esclusiva per un solo prodotto finale, tuo o di un cliente, che i giocatori possono usare gratis o con monetizzazione pubblicitaria. Puoi modificare codice, grafica e audio all'interno di quel prodotto e sostituire il nostro marchio con il tuo, ma non rivendere né condividere il template, il suo sorgente o i suoi asset separatamente. L'assistenza dura 6 mesi, o 12 con l'estensione al momento dell'acquisto. Il prezzo di listino è $39; fino al 30 novembre 2026 una promozione Black Friday toglie il 15% a ogni template, quindi Tenguin costa $33,15, e dal 1° dicembre i prezzi tornano a quelli di listino.
Leggi i termini di licenza e assistenza
Domande frequenti
Quali sono le regole di un gioco number match?
In Tenguin due tessere spariscono quando hanno lo stesso numero o sommate fanno dieci, e tra loro ci sono solo spazi già liberati. Le coppie possono essere verticali, orizzontali, diagonali o andare dalla fine di una riga all'inizio della successiva.
Devo fare la build del gioco?
No. Carica il contenuto di game/ su un hosting HTTP(S). La build serve solo se modifichi il sorgente.
Cosa posso cambiare senza rifare la build?
Titolo, percorso del logo, colore d'accento, lingua predefinita, monete iniziali, ricompense, prezzi dei potenziamenti e degli accessori, tutto in tenguin.config.js.
Quanti livelli ci sono?
I livelli si snodano lungo una mappa di dieci temi di isole. Dopo il decimo tema il gioco continua con livelli generati e temi riutilizzati.
Posso organizzarci un concorso a premi?
Lo sconsigliamo. I contenuti giornalieri usano l'orologio del dispositivo e i record sono locali, quindi non sono una base equa per assegnare premi.
Funziona sui tablet?
Sì. Funziona nei browser attuali su computer, tablet e telefoni, con l'opzione tessere grandi nelle impostazioni.
Per chi è adatto, e due puzzle da confrontare
Un gioco number match è adatto a portali casual, siti con un taglio educativo e marchi che vogliono un puzzle rilassante con un motivo quotidiano per tornare. La regola del dieci si spiega in un attimo, e i potenziamenti arrivano abbastanza piano da insegnare strada facendo.
Per confronto, Gridspark è un puzzle a blocchi 8×8 con la mossa fulmine ZAP e una sfida giornaliera generata da seed, a $29 di listino. Bodoku è un puzzle logico con fantasmi, 180 livelli in sei ali di un castello, a $59 di listino. Entrambi hanno 14 lingue nell'interfaccia.
Scopri Gridspark, il puzzle a blocchi
Scopri Bodoku, il puzzle logico
Con due template nello stesso ordine ogni licenza ha il 5% di sconto, con tre il 10%, con quattro il 15% e da cinque in su il 20%.