Wordle es un juego de palabras. En el siglo pasado había un juego entre dos jugadores que se jugaba con lápiz y papel y en México lo llamábamos "quemado", aunque parece ser que es más antiguo (ref. ahorcado) y consistía en que el jugador 1 pensaba una palabra "secreta" y el jugador 2 debía adivinarla en un número máximo de intentos. El jugador 1 dibujaba un hombre palo y escribía guiones indicando el tamaño de la palabra secreta. A su vez, el jugador 2 escribía una palabra de esa longiitud y el jugador 1 respondía una de 3 pistas en cada letra indicando cada una de las tres posibilidades, a saber:
i) letra correcta en posición correcta,
ii) letra correcta en posición incorrecta,
iii) letra incorrecta (es decir, dicha letra no aparece en la palabra secreta).
Cada vez que el jugador 2 no adivinaba la palabra secreta, el jugador 1 añadía al dibujo un nuevo elemento para poder llevar a cabo la quema: leña, gasolina, cerillos etc.
El juego terminaba cuando el jugador 2 adivinaba la palabra secreta o bien cuando, habiendo llegado el número máximo de intentos, el jugador 1 procedía a la quema del hombre palo.
En la imagen siguiente se puede apreciar un juego en desarrollo:
No obstante ser un juego viejo, no fue hasta hace pocos años que se popularizó en la red (Wordle, juego) en inglés, posteriormente en español (La palabra del día) y por supuesto han surgido apps. En estas versiones, el jugador 1 es la computadora o dispositivo y el jugador 2 es un humano.
En su versión original en la red había una palabra secreta por día y todos los jugadores tratan de adivinar dicha palabra, pudiendo compartir estadísticas. Este proyecto de Wordle consiste de hacer una app que adivine una palabra secreta en español. Esta palabra cambia cada vez que se usa la app y es tomada aleatoriamente de un diccionario.
El diccionario es básico para el buen funcionamiento del juego pues el jugador 2 espera que el jugador 1 "conozca" todas las palabras que él escriba. En la red se pueden encontrar una gran variedad de diccionarios y cualquier desarrollador de un juego Wordle puede utilizar el diccionario que crea conveniente. En lo personal, hemos encontrado que hay diccionarios en línea sumamente sencillos (con pocas palabras) y diccionarios muy sofisticados, por llamarlos de alguna manera, que contienen palabras en desuso o no comunes, al menos en el español hablado en México. (Es de hacer notar cómo influye el léxico utilizado en cada país.) El diccionario puede contener singulares y plurales o solo singulares, puede contener verbos y diversas conjugaciones, hay muchas posibilidades. El diccionario que hemos usado ha surgido a partir de un diccionario básico encontrado en línea al cual se le han añadido palabras durante un período de prueba y cuenta actualmente con más de 2400 palabras.
Dicho todo esto, el presente proyecto trata de hacer un clon de Wordle en español utilizando un diccionario propio. Se trata de seguir la forma como un Wordle funciona con el mismo diseño. La imagen de la app cuando inicia es la siguiente:
El objetivo del juego es entonces que el humano adivine la palabra secreta de cinco letras que ha sido tomada aleatoriamente del diccionario, en un máximo de seis intentos. De tal manera que el espacio en blanco que se ubica entre el título y el teclado se usa para desplegar las palabras que el usuario vaya escribiendo. Es decir, este espacio en una tabla de 6 renglones y 5 columnas, inicialmente vacía.
A su vez, el teclado está formado por botones ubicados también de manera tabular con 3 renglones y 10 columnas. Al inicio, estos botones son de color gris claro indicando que ninguna letra ha sido intentada. A medida que el humano prueba una palabra, las letras de esta palabra y las del teclado cambian de color dependiendo, como se ha mencionado antes, de si una letra es correcta en posición correcta (color verde), o correcta en posición incorrecta (amarillo) o bien una letra no aparece en la palabra (gris obscuro). Estas pistas ayudan al humano a lograr adivinar la palabra secreta.
Puesto que se va a simular un cambio de pantallas (al menos hay dos pantallas para cambiar entre la pantalla del juego y una pantalla de ayuda) se van a utilizar (al menos) dos 'Disposiciones Verticales' A una la llamaremos 'PantallaJuego' y a la otra 'PantallaAyuda'. Las propiedades 'Alto' y 'Ancho' de estas 'Disposiciones' se ponen a 'Ajustar al contenedor' para que ocupen toda la pantalla. Los demás componentes visibles se colocan dentro de estas disposiciones, según corresponda y poniendo 'Visible' o no cada disposición se puede ver una u otra "pantalla".
Un 'Notificador', componente no-visible, para informar al jugador situaciones del juego, por ejemplo, si ha ganado.
un componente no-visible de 'Almacenamiento' tipo 'Archivo' para leer el diccionario.
una 'Disposición horizontal' con propiedades 'Alto' igual a 10% y 'Ancho' igual a 'Ajustar al contenedor', para poner en ella:
un 'Botón' de ayuda
una 'Etiqueta' con el nombre del juego
una 'DisposiciónTabular' con 6 'Registros' y 5 'Columnas', 'Alto' igual a 50% y 'Ancho' igual a 'Ajustar al contenedor'. Dentro de ella se escribirán las palabras que el jugador vaya escribiendo. Cada letra es una etiqueta, es decir, esta DisposiciónTabular tendrá:
6x5=30 'Etiqueta's. El 'Ancho' de cada etiqueta lo pondremos como 15%, el 'Tamaño de letra' igual a 30 y como valor de 'Text´' le pondremos vacío. Para saber a qué letra nos estamos refiriendo en la funcionalidad, le pondremos como nombre 'Etiquetaij' si ésta corresponde a la letra j de la palabra i
otra 'DisposiciónTabular' con 3 'Registros' y 11 'Columnas', 'Alto' igual a 25% y 'Ancho' igual a 'Ajustar al contenedor'. Notemos que hemos escrito efectivamente 11 columnas, no obstante que haya 10 letras en cada renglón, esto para que haya espacio suficiente para poder colocar todos los botones si no ya no se pueden insertar los botones más a la derecha. Dentro de esta 'DisposiciónTabularBotones' se insertarán:
10+10+9=39 'Botones' correspondientes a cada una de las 27 letras del alfabeto en español (incluída la ñ) y la "palomita" en el extremo inferior izquierdo indicando que el usuario desea probar la nueva palabra que ha escrito y la tecla para borrar una letra en el extremo inferior derecho. El 'Ancho' de cada botón lo pondremos como 9% y para saber a qué botón nos estamos refiriendo en la funcionalidad, le pondremos como nombre 'BotónQ', 'BotónA', etc. Asimismo, como valor 'Texto' le pondremos 'Q', 'A', etc, de acuerdo a cada letra. Para el botón correspondiente a "aceptar" le pondremos como 'Imagen' un archivo con "palomita" y al botón de "borra" le pondremos como 'Imagen' un archivo con el símbolo "backspace".
En esta "pantalla" se escriben las indicaciones de cómo jugar el Wordle y tiene un botón "tache" para regresar a la pantalla del juego. Al inicio, la propiedad 'Visible' de esta disposición está como 'falso' y se cambia de valor entre 'falso' y 'verdadero' al "cambiar" de pantallas. Tiene los componentes:
una 'Disposición horizontal' con propiedades 'Alto' igual a 10% y 'Ancho' igual a 'Ajustar al contenedor', para poner en ella:
una 'Etiqueta' con el texto 'CÓMO JUGAR' con 'Alto' igual a 'Automático y 'Ancho' igual a 95%
un 'Botón' para el "tache" que cierra esta ventana, con 'Alto' y 'Ancho' igual a 15% y como 'Imagen' un tache de cierre.
una 'Etiqueta' para escribir en ella todas las indicaciones pertinentes, con 'Ancho' igual a 'Ajustar al contenedor' y 'Alto' igual a 80%
Por último hemos puesto una 'DisposiciónHorizontal' que no ha sido usada.
Se deben subir varios archivos para que puedan ser usados por la app. Éstos son; en el orden en que aparecen en el diseño:
aceptar.png contiene la "palomita" para probar la palabra escrita por el usuario,
ayuda.png imagen del botón de ayuda,
dicNuevo.txt archivo de texto que contiene el diccionario, con más de 2400 palabras. No contiene todos los plurales ni todas las conjugaciones,
playstore.png imagen del icono de la app. De este icono se hablará más adelante,
supr.png imagen correspondiente al "backspace",
tache.png imagen que corresponde a cerrar una pantalla
Sugerimos familiarizarse con Wordle para comprender el desarrollo del juego. En verdad es fácil engancharse en él y es relativamente sencilla su funcionalidad. Por ejemplo, la funcionalidad de cada botón letra del teclado es la misma: si se da 'Clic' al botón 'A' se escribe una 'A', si se da 'Clic' al botón 'Q' se escribe una 'Q', etc., el problema consiste en saber en dónde se escribe la letra, es decir, de qué palabra se trata y en qué posición o, lo que equivale a decir que son necesarias 30 condicionales. Son bloques largos pero aquí es sumamente útil poner nombres apropiados tanto a las letras de las palabras que el usuario escribe, como a los botones del teclado. Es interesante notar que cuando se da clic en el "backspace" se hace prácticamente lo mismo que con una letra, solamente que en este caso se escribe ' ' espacio para dar la impresión de que se ha borrado la última letra, aunque aquí no se avanza una posición.
Un evento importante es cuando el jugador da clic en el botón de "aceptar". En este caso se compara la palabra escrita por el jugador contra la palabra clave y se deben ir mostrando las pistas. Existen 30 (6 palabras de 5 letras) posibles letras para cambiar su color de fondo y 27 botones (uno por cada letra) para cambiar también su color y, para cada una de estas opciones, uno de tres colores posibles. Ello significa tener muchos condicionales, la gran noticia es que todo el proceso es parecido, solamente hay que fijarse en qué palabra se está tratando (de la 1 a la 6, indicada por 'intento', ver más adelante) y qué letra de la palabra (entre 1 y 5, indicada por 'posicion').
Se usan algunas variables globales en la funcionalidad. Éstas son:
'palabra' es la palabra secreta a adivinar, tipo 'texto',
'usuario' es la (nueva) palabra que el jugador ha escrito y que se compara contra la palabra secreta, tipo 'texto',
'intento' cuenta el número de intentos que el jugador ha realizado, al inicio vale 1. Esta variable indica si se trata de la primera, segunda, etc. palabra del jugador. Es decir, indica el renglón en que se trabaja,
'posicion' indica qué letra se está tratando, desde la posición 1 hasta la 5. Es decir, indica la columna en que se trabaja,
'aciertos' indica cuántas letras correctas tiene la palabra escrita por el jugador, entre 0 y 5 (donde 5 significa éxito),
'colorSi' color verde para poner el fondo de color verde si la letra es correcta en posición correcta, tipo 'color'
'colorTalVez' color naranja para poner el fondo de color naranja si la letra es correcta en posición incorrecta, tipo 'color'
'colorNo' color gris obscuro para poner el fondo de color de este color si la letra es incorrecta, tipo 'color'
El diccionario es un archivo de texto que contiene palabras de cinco letras, una por renglón. Este archivo se lee al inicio de la app y se guarda en una lista de app inventor auxiliar. Para poder leer de un archivo se necesita precisamente un componente de app inventor de tipo 'Archivo' que se encuentra de la categoría de 'Almacenamiento'. Después de haber leído y guardado las palabras en la lista auxiliar, se recorre palabra por palabra esta lista auxiliar haciendo una doble transformación: primero se pasa cada palabra a mayúsculas (esto para que no importe si las palabras en el diccionario contienen mayúsculas o minúsculas) y, segundo, las letras ´ñ´en al archivo se han cambiado por el signo ´#' de tal manera que en la lista el símbolo '#' se vuelve a cambiar por 'Ñ' (¿por qué se han cambiado las 'ñ' por '#'s? porque no se lograba leer las 'ñ' de forma adecuada). Finalmente, después de tener el 'diccionario' armado, se toma una 'palabra' aleatoria que será la palabra a adivinar. (Puesto que la palabra se toma de manera aleatoria poco importa que el diccionario esté ordenado o no.) Esta funcionalidad se hace de la siguiente manera:
Al dar 'clic' en cualquier (botón) letra se hace prácticamente los mismo: escribir la letra correspondiente (en la posición correspondiente, ahí está el detalle). De tal manera que utilizando un procedimiento la funcionalidad del evento 'Clic' es sencilla (no se muestran todos los eventos, los otros son análogos):
A su vez, el proceso 'ponLetra' solo llama al procedimiento 'escribe' que escribe la 'letra' correspondiente pero, como sí se trata de una letra, avanza una posición, a diferencia de cuando se escribe un backspace que escribe espacio pero no avanza la posición.
Este procedimiento escribe el 'símbolo' que se le da como primer parámetro y si el símbolo 'esLetra' (es decir, el segundo parámetro tiene valor verdadero) entonces avanza una posición. Si 'esLetra' es 'falso' (el símbolo es backspace) no se avanza la posición.
Este procedimiento sí se fija en qué celda de la disposición tabular se debe escribir el símbolo. Para ello, usando un condicional, se prueba primero si se trata de la primera palabra (la variable 'intento' es igual a 1) y, si éste es el caso, se verifica si es la primera, segunda, o hasta quinta letra preguntando por el valor de la variable 'posición' para escribir el símbolo en la 'Etiqueta1posicion'. Es de notar que cada vez que escribe una letra se forma en la variable 'usuario' la palabra que el usuario ha escrito (aunque esté incompleta), esto para que el proceso de verificación sea más fácil, independiente de cuál intento sea.
Si 'intento' no es igual a 1 se pregunta entonces si es igual a 2 (segunda palabra) y se vuelve a hacer lo mismo pero ahora escribiendo el simbolo en la 'Etiqueta2posicion'. Esta pregunta se hace seis veces, para cada una de las 6 oportunidades que tiene el jugador. De tal manera que la funcionalidad queda así, no se han escrito los 6 intentos posibles pero se deja al lector que complete el código.
Por ultimo (al final del procedimiento), pero no menos importante, si es que se ha escrito una letra ('esLetra' es verdadero) se avanza una posición.
Para situarse en contexto, recordemos que hay un máximo 6 intentos, si ya se hicieron estos 6 intentos aunque el jugador trate de escribir letras o borrar alguna, no sucede nada. Del mismo modo, si después de escribir una palabra de 5 letras, el jugador sigue escribiendo más letras, éstas no se toman en cuenta.
De tal manera que el evento 'Clic' del 'BotonBorra' consiste en:
Se pregunta primero si ya se han acabado todos los intentos y de ser éste el caso no se hace nada pues no hay nada posible qué borrar.
Por el contrario (si no se han acabado los intentos) se pregunta ahora si es que el jugador ha tratado de escribir más de 5 letras y, si éste es el caso, se pone la ´posición' igual a 6. Además, el usuario debe de haber escrito al menos una letra para poderla borrar, es por ello que se pregunta si 'posicion' es mayor a 1 y, si este es el caso, se disminuye en 1 la 'posicion' (pues 'posición siempre indica la siguiente posición disponble, al restarle 1 se posiciona en la última letra escrita). Finalmente, se llama al procedimiento 'escribe' con parámetros ' ' (espacio) para que dé la impresión de borrar y 'esLetra' como 'falso' para que no avance a la siguiente posición:
Recordemos que la palabra secreta se encuentra almacenada en la variable 'palabra' y que la palabra escrita por el jugador está en la variable 'usuario'. Al momento en que el jugador da clic en el 'botónAceptar' es cuando nuestra app debe comprobar si estas dos palabras son iguales, ¿cómo se hace esto? puesto que la longitud de ambas palabras es igual a 5 es un proceso muy fácil, comparando elemento a elemento y contando el número de aciertos. Por supuesto que esta comprobación se realiza siempre y cuando haya habido menos de 7 intentos.
A manera de ejemplo, supongamos que:
A R B O L es la 'palabra' secreta y que
D A D O S es el primer intento del jugador, es decir, intento=1
Notemos como independientemente de si se ha adivinado la palabra secreta o no, la aplicación debe mostrar las pistas de color de fondo en la nueva palabra. Este cambio de color se va realizando a medida que se compara letra por letra, además de contar el número de aciertos que se tienen. Este es el algoritmo que se describe a continuación. Al final se llama al procedimiento 'verificaExito' quien será el encargado de revisar, y notificar según sea el caso, de si el jugador ha descubierto la palabra secreta.
Algoritmo
si intento <= 6 entonces
si posicion < 6 entonces
"notificar que no hay suficientes letras"
sino si no está en el diccionario la palabra escrita por el usuario, que está almacenada en la variable 'usuario' entonces
"notificar que la palabra no está en el diccionario"
sino // se procede a la comparación
aciertos <- 0
si intento = 1 entonces
hacer Etiqueta11.ColorDeTexto <- "blanco"
comparamos si Etiqueta11=palabra[1] entonces
hacer aciertos <- acuertos+1
hacer Etiqueta11.ColorDeFondo <- 'ColorSi'
sino si Etiqueta11 está en palabra entonces
hacer Etiqueta11.ColorDeFondo <- 'ColorTalVez'
sino // la letra en Etiqueta11 no se encuentra en la 'palabra'
hacer Etiqueta11.ColorDeFondo <- 'ColorNo'
.
.
.
// se hace lo mismo para las Etiqueta12, Etiqueta13, ..., Etiqueta15
verificaExito() // se llama al procedimiento que verifica si hubo éxito o no
sino si intento = 2 entonces
// se hace lo mismo para los intentos 2, 3, ..., 6
finsi
finsi
finsi
Como se puede observar, es un proceso largo pero sencillo. La funcionalidad es la siguiente:
Este procedimiento es el encargado de, primero, escribir los colores de fondo de las pistas usando otro procedimiento llamado 'coloreaTeclado' y, más importante aún, de revisar si el jugador ha adivinado la palabra secreta, ¿cómo? preguntando si ha habido 5 aciertos. De ser así, informa al jugador del éxito logrado y termina el juego, poniendo los valores de las variables 'posición' e 'intento' igual a un valor muy grande, con lo cual la app no hará nada más.
Si, por el contrario, el jugador no ha adivinado la palabra secreta, la app pasa al siguiente intento (incrementando la variable 'intento' en 1, es decir, pasa al siguiente renglón) y regresando la 'posición' a 1 pues es nuevo inicio de palabra (es decir, pasa a la columna 1).
Como un "plus", si el jugador no ha logrado adivinar la palabra secreta, ésta se muestra para conocimiento del jugador. Esto se pudiera eliminar al gusto del programador.
A primera vista, podría pensarse que el proceso para indicar las pistas de colores en el teclado de la app fuera muy similar al de colorear las pistas en las palabras escritas por el usuario pero existe una diferencia fundamental: cuando se colora el fondo de la última palabra escrita por el usuario sólo se tiene que trabajar con las cinco etiquetas correspondientes a la última palabra y sí se sabe cuáles son estas etiquetas. Por el contrario, cuando se quiere colorear los botones del teclado no es posible saber de manera directa cuáles botones de deben colorear sino que se deben recorrer todas las letras e ir preguntando si cada letra aparece (bien puesta o no) o no aparece en la palabra escrita por el usuario.
De tal manera que el proceso resulta ser fácil pero largo de escribir y queda de esta manera:
Por lo que se refiere a la funcionalidad de la app, sólo nos resta desarrollar el evento 'Clic' de los botones para solicitar la ayuda y para cerrar ésta (y regresar al juego). Estos eventos son:
Queremos que cuando la app se instale en nuestro dispositivo se presente con un ícono bonito, relacionado con el juego Wordle, así es que debemos enfocarnos en diseñar un icono usando nuestra herramienta preferida. La imagen creada debe ser en formato .PNG
Aunque habrá lectores expertos en realizar dibujos por computadora, nosotros, para este proyecto hemos escrito en una hoja de cálculo un "icono" simple usando una "tabla" de 3x3 formando la palabra:
W O R
D L E
con fondo igual a uno de los colores usados en el juego Wordle. Después hemos guardado este icono como archvo .PDF y posteriormente lo hemos convertido a archivo .PNG usando el software llamado "gimp"; cabe mencionar que este gimp es un software sumamente útil pues puede leer un archivo en prácticamente cualquier formato y guardarlo con otro formato. Para la "transformación" se necesita ejecutar 'gimp' (claro, previamente descargado) y seleccionar
'Archivo' -> 'Abrir' -> seleccionar archivo .PDF -> 'Importar' y, después de que lo haya cargado:
'Archivo' -> 'Exportar como ...' -> nuevoNombre.PNG -> 'Exportar' -> 'Exportar' y listo
Hemos logrado crear un archivo .PNG con el ícono deseado. Solamente que para poderlo publicar en al Play Store (Android) o en la tienda App Store el archivo debe ser de dimensiones 512x512, o bien 1024x104, respectivamente (ref. applsflyer, app store). Así que debemos hacer que nuestro icono sea del tamaño apropiado correspondiente, usando una herramienta específica para ello, como por ejemplo: https://www.appicon.co en donde seleccionamos nuestro archivo.PDF -> Generate
Se generan, entre otros, los archivos playstore.png y appstore.png y se descarga el que nos interese en nuestra computadora para luego subirlo a nuestro proyecto y poner su nombre como el valor de la ´Propiedad' 'Icono' de la 'Screen1'.
El archivo playstore.png que usamos es el siguiente:
Finalmente, teniendo probada nuestra app y diseñado su icono podemos instalarla en nuestro dispositivo para tenerla, de esta manera, guardada y lista para usarse como cualquier otra app.
Para ello, ponemos un nombre apropiado a la app en la 'Propiedad' 'AppName' y vamos a usar el icono creado poniendo al valor de la 'Propiedad' 'Icono' igual a 'playstore.png' (propiedades de 'Screen1'). Ahora, debemos generar un archivo de extensión .APK (Android PacKage), estos son los archivos que aparecen en la Play Store (Nota: Si se quisiera publicar realmente en la Play Store se necesitaría hacer un manual y hacer un pago Google Play).
Para generar el archivo .APK del menú principal de App Inventor seleccionamos:
'Generar' -> 'Android app (.apk)
tarda varios segundos y forma el archivo .apk a instalar en nuestro dispositivo. Lo más fácil es usar un app para leer el código QR que ha generado App Inventor. Al leer el código se da cuenta que es una archivo "ejecutable" y nos puede avisar que se trata de un posible archivo dañino pero, como lo hemos hecho nosotros entonces damos clic en 'Descargar de todos modos' -> 'Instalar' y listo, tenemos nuestra app instalada en nuestro dispositivo, a jugar con ella.