Cómo es por dentro el código fuente de un juego de emparejar números
Las reglas de pares, los potenciadores, el archivo de configuración que editas sin compilar y las partes que piden el código TypeScript.
El código fuente de un juego de emparejar números vale la pena cuando quieres un puzle de "haz diez" terminado, con mapa de niveles, potenciadores y contenido diario, y prefieres ajustar precios y marca antes que escribir el motor de pares. Tenguin es ese paquete: el jugador junta números iguales o dos que suman diez, a lo largo de diez temas de islas ilustradas, por US$ 39 a precio de lista.
Esta guía es para quien va a abrir la carpeta. Explica las reglas que el código ya garantiza, qué está en el archivo de configuración, qué requiere el código fuente y qué ajustes pueden darte problemas en un sitio publicado. Si solo quieres el resumen: casi todos los ajustes comerciales son un archivo de texto y recargar la página.
Las reglas que el código fuente del juego de emparejar números ya resuelve
El jugador toca una ficha y luego otra. El par desaparece si los números son iguales o suman diez. Las dos fichas pueden estar una sobre otra, lado a lado, en diagonal, con espacios ya despejados entre ellas, o al final de una fila y al inicio de la siguiente.
Despejar una fila completa provoca una Avalancha, y una racha sube el multiplicador de puntos. Cuando ya no quedan pares, la Nevada copia al final los números que siguen en el tablero. Cada nivel da hasta tres estrellas.
El paso de una fila a otra y los espacios vacíos son las comprobaciones que un motor de pares tiene que resolver bien: un par que al jugador le parece válido también tiene que serlo para el código. Aquí esas comprobaciones ya forman parte del juego entregado.
Probar las reglas en la demo de Tenguin
Potenciadores, contenido diario y modo Relax
Cinco potenciadores aparecen por etapas, lo que les da a los primeros niveles una curva de aprendizaje:
- Pista.
- Deshacer, desde el nivel 3.
- Nevada, que rellena el tablero con copias de los números restantes.
- Picotazo, que quita una ficha, desde el nivel 8.
- Comodín, un copo que empareja con cualquier número, desde el nivel 12.
Un desafío diario armado con la fecha de hoy, misiones diarias y cofres de capítulo le dan al jugador un motivo para volver. El modo Relax no tiene estrellas ni prisa y da Nevada sin límite, para quien solo quiere despejar fichas.
La ropa del pingüino viene en cuatro categorías: bufandas, sombreros, colores y efectos. Se compra con monedas ganadas en el juego, y algunos niveles desbloquean una. No hay dinero real de por medio.
Qué trae la descarga
- Una carpeta game/ lista para alojar, con ilustraciones, fuentes tipográficas, archivos de audio y dependencias del runtime, todo local.
- Código fuente legible, con configuración y avisos de licencia de terceros.
- 49 pruebas automáticas.
- Una guía ilustrada sin conexión para el comprador en 14 idiomas, con capturas en inglés.
La interfaz viene en 14 idiomas: inglés, portugués, español, francés, alemán, italiano, neerlandés, polaco, turco, ruso, indonesio, japonés, coreano y chino simplificado. La base es TypeScript, JavaScript y HTML5, con Vite para compilar el código fuente. Los archivos incluyen HTML, CSS, JavaScript, JSON, TypeScript, WebP, PNG y MP3.
Un detalle al ver la página del producto: los paneles ilustrados son arte promocional, y la galería de capturas muestra el juego real. Juzga el aspecto por las capturas y la demo.
El archivo de configuración: cambios sin compilar
La mayoría de los ajustes están en tenguin.config.js, un archivo de texto junto al index.html. Cambia un valor, sube el archivo y recarga. Sin Node.js y sin compilar. Contiene:
- El título de la página y la ruta del logo.
- El color de acento.
- El idioma predeterminado.
- Las monedas iniciales.
- Las recompensas por victoria, por estrella y del modo Relax.
- Los precios de los potenciadores y de la ropa.
Eso cubre dos necesidades comunes: tu propia marca en pantalla y una economía ajustada a tu público. Si los jugadores sienten que los potenciadores son caros, cambias un número, no el código.
Un ajuste requiere cuidado: la clave de guardado. Elígela antes del lanzamiento y no la toques después. Cambiarla en un sitio publicado hace que todos los jugadores pierdan su progreso.
Qué requiere el código TypeScript
El diseño de los niveles, los diálogos, el arte dentro del juego y los nuevos clips de voz se cambian en la edición con código fuente, que luego se recompila con Node.js 22.13 o posterior. Node no hace falta para alojar el juego, solo para recompilarlo.
El mapa de niveles tiene diez temas de islas ilustradas. Después del décimo, el progreso sigue con niveles generados y los temas existentes reutilizados. Agregar un undécimo tema requiere arte nuevo y nuevas posiciones en el mapa dentro del código, así que plantéalo como trabajo de arte con un poco de código, no como un ajuste.
Corre las 49 pruebas después de cada cambio en el código. Es la forma más rápida de ver si una edición rompió una regla en otra parte.
- Haz una copia del paquete.
- Haz el cambio en el código fuente.
- Corre las pruebas.
- Compila y reemplaza la carpeta game/ alojada por la salida completa.
- Juega algunos niveles en un celular y en un navegador de computadora.
Alojamiento, inserción y accesibilidad
Sube el contenido de game/ a un alojamiento HTTP(S) de archivos estáticos, en una subcarpeta si prefieres. No necesitas PHP ni base de datos. Abrir los archivos directo del disco con file:// no funciona, así que prueba desde un servidor web.
El juego funciona en las versiones actuales de Chrome, Edge, Firefox y Safari, en computadora, tableta o celular. Los jugadores lo cargan desde tu dirección; no es una app instalable sin conexión. Los ajustes incluyen fichas grandes, alto contraste, modo tranquilo y vibración en los celulares compatibles, algo útil si tu público incluye personas mayores o niños.
El paquete no trae un proyecto de app nativa ni un proveedor de anuncios conectado. Si necesitas alguno, o quieres el juego instalado en tu servidor, cotizamos ese trabajo por proyecto.
Pedir cotización de trabajo a medida
Límites y licencia en un párrafo
Tenguin no tiene guardado en la nube, cuentas en línea, ranking remoto, compras con dinero real ni proveedor de anuncios conectado, y no incluye apps nativas, alojamiento ni desarrollo a medida. El progreso queda en el almacenamiento local del navegador. Una compra da una licencia perpetua y no exclusiva para un producto final, tuyo o de un cliente, que los jugadores pueden usar gratis o con monetización por anuncios. Puedes modificar el código, el arte y el audio dentro de ese producto y cambiar nuestra marca por la tuya, pero no revender ni compartir la plantilla, su código o sus recursos por separado. El soporte dura 6 meses, o 12 con la extensión al pagar. El precio de lista es US$ 39; hasta el 30 de noviembre de 2026, una promoción de Black Friday descuenta 15% en todas las plantillas, así que Tenguin cuesta US$ 33.15, y desde el 1 de diciembre los precios vuelven a los de lista.
Leer los términos de licencia y soporte
Preguntas frecuentes sobre Tenguin
¿Cuáles son las reglas de un juego de emparejar números?
En Tenguin, dos fichas desaparecen cuando tienen el mismo número o suman diez, y entre ellas solo hay espacios ya despejados. Los pares pueden ir en vertical, horizontal, diagonal o del final de una fila al inicio de la siguiente.
¿Necesito compilar el juego?
No. Sube el contenido de game/ a un alojamiento HTTP(S). Compilar solo hace falta si cambias el código fuente.
¿Qué puedo cambiar sin recompilar?
Título, ruta del logo, color de acento, idioma predeterminado, monedas iniciales, recompensas, precios de los potenciadores y de la ropa, todo en tenguin.config.js.
¿Cuántos niveles tiene?
Los niveles siguen un mapa con diez temas de islas. Después del décimo tema, el juego continúa con niveles generados y temas reutilizados.
¿Puedo hacer un concurso con premios?
No lo recomendamos. El contenido diario usa el reloj del dispositivo y los récords son locales, así que no son una base justa para premios.
¿Funciona en tabletas?
Sí. Funciona en los navegadores actuales de computadora, tableta y celular, con la opción de fichas grandes en los ajustes.
Para quién es, y dos puzles para comparar
Un juego de emparejar números encaja con portales casuales, sitios con enfoque educativo y marcas que quieren un puzle tranquilo con un motivo diario para volver. La regla del diez es fácil de explicar, y los potenciadores llegan con calma suficiente para enseñar sobre la marcha.
Para comparar, Gridspark es un puzle de bloques de 8×8 con el movimiento ZAP y un desafío diario, por US$ 29 a precio de lista. Bodoku es un puzle de lógica con fantasmas, 180 niveles en seis alas de un castillo, por US$ 59 a precio de lista. Ambos tienen 14 idiomas en la interfaz.
Ver Gridspark, el puzle de bloques
Ver Bodoku, el puzle de lógica
Dos plantillas en el mismo pedido tienen 5% de descuento en cada licencia, tres tienen 10%, cuatro 15% y cinco o más 20%.