ScrabbleAR - Seminario de Lenguajes (Python)

Trabajo realizado por: Garea Antonella (17614/5), Garofalo Pedro (17136/5) y Giorgetti Valentín (17133/2).

Número del grupo: 31.

Consideraciones a tener en cuenta

~ Versión de Python usada: 3.6.8

~ Versión de PySimpleGUI usada: 4.26.0

~ Versión de Pattern usada: 3.6

~ Versión de PlaySound usada: 1.2.2. Necesita los siguientes paquetes para funcionar:

En Ubuntu: "libcairo2-dev", "libgirepository1.0-dev" y "gir1.2-gtk-3.0". Instalar con el comando: "sudo apt install libcairo2-dev libgirepository1.0-dev gir1.2-gtk-3.0".
En Arch Linux: "python-gobject". Instalar con el comando: "sudo pacman -S python-gobject".

~ La imagen utilizada en el menú principal es propia. Los sonidos utilizados fueron buscados en la web "freesound.org" (Creative Commons Licensed).

~ Para usar el programa se debe ejecutar el archivo "ScrabbleAR.py".

Introducción

El trabajo final de la materia “Seminario de Lenguajes” consiste en implementar el conocido juego “Scrabble” usando el lenguaje de programación Python, aplicando los conocimientos adquiridos durante la cursada de la materia.

La versión implementada del juego tiene algunas diferencias respecto al original. El nombre elegido para la versión desarrollada es “ScrabbleAR”. Se juega contra la computadora y el jugador puede modificar varios parámetros de la partida.

Las palabras con las que se juega son sustantivos, adjetivos y verbos. Para el análisis sintáctico de las palabras usadas en el juego se utilizó la librería Pattern, y para el diseño de la interfaz gráfica se usó PySimpleGUI. También se añadieron sonidos haciendo uso de la librería PlaySound.

El objetivo del juego es intentar ganar más puntos que la computadora antes de que se acabe el tiempo, formando palabras sobre un tablero, tratando de aprovechar las casillas especiales ubicadas en el mismo.

Reglas del juego

Para comenzar la partida se deberá presionar el botón “Iniciar”. Esta acción hará que se elija en forma aleatoria, entre el jugador y la computadora, quien tendrá el primer turno.

Cada partida cuenta con un tiempo límite, y una bolsa de fichas en la cual se almacena una cierta cantidad de fichas de cada letra. Cada ficha tiene su propio puntaje.

Al comenzar la partida se reparten en forma aleatoria 7 (siete) fichas a cada participante. En todo momento, tanto el jugador como la computadora, deben disponer de esta cantidad de fichas en su atril. Las fichas de la computadora se muestran como símbolos de interrogación para no otorgar ventaja al jugador.

Las palabras colocadas en el tablero no deben cruzarse con otras, sólo pueden situarse de izquierda a derecha (orientación horizontal) o de arriba hacia abajo (orientación vertical). No se pueden ingresar palabras colocadas anteriormente. Los tipos de palabras admitidas dependen del nivel seleccionado.

Se debe formar una palabra usando 2 (dos) o más fichas. En la primera jugada, una de ellas deberá estar situada en la casilla rotulada “Inicio”, la cual se encuentra en el centro del tablero.

Una vez ingresada la palabra en el tablero, el jugador debe presionar el botón “Confirmar palabra” para verificar si la palabra es válida. En caso de que la palabra formada no sea válida, se le informará al jugador y el mismo podrá intentarlo nuevamente la cantidad de veces que desee. Si la palabra ingresada es válida, se informará en pantalla la palabra formada, la clasificación y los puntos obtenidos. Luego se repartirán aleatoriamente nuevas fichas al jugador, para reponer las utilizadas en la jugada, y finalmente, se pasará el turno a la computadora.

Si el turno es de la computadora, tratará de formar una palabra válida con las fichas que dispone. En caso de no poder formar una palabra válida, se informará en pantalla e intercambiará todas sus fichas. Luego se pasará el turno al jugador. Si la palabra ingresada es válida, se informará en pantalla la palabra formada, la clasificación y los puntos obtenidos. Luego, se repartirán aleatoriamente nuevas fichas a la computadora, para reponer las utilizadas en la jugada, y finalmente se pasará el turno al jugador.

En cualquier momento de la partida, el jugador puede presionar el botón “Cambiar fichas” para cambiar algunas o todas sus fichas, devolviéndolas a la bolsa y reemplazándolas por la misma cantidad. Si el jugador realizó algún cambio, se pasará el turno a la computadora.

Tanto el jugador como la computadora pueden realizar un máximo de 3 (tres) cambios durante la partida. En el caso de la computadora, ésta únicamente tendrá la opción de intercambiar todas sus fichas.

El juego cuenta con una configuración predeterminada para cada nivel, de esta forma el jugador puede iniciar una partida rápidamente. Los parámetros que se pueden modificar para una partida son: el nivel, el tiempo límite, la bolsa de fichas (cantidad y puntaje de las fichas) y el nick del jugador. Las configuraciones elegidas por el usuario son guardadas y puede restablecerse a valores por defecto en cualquier momento.

Niveles del juego

• Nivel fácil: el jugador puede colocar cualquier tipo de palabra: sustantivos, adjetivos o verbos. El tamaño del tablero es 19 x 19, tiene muchas casillas con premios (73 en total) y muy pocas con descuentos (16 en total).

• Nivel medio: las palabras permitidas en este nivel son adjetivos y verbos. El tamaño del tablero es 17 x 17, tiene menos casillas con premios (65) y más con descuentos (20).

• Nivel difícil: en este nivel, el tipo de palabra permitida se selecciona aleatoriamente entre adjetivos y verbos. Es decir, durante la partida sólo se podrán formar adjetivos o verbos, dependiendo del resultado de la elección aleatoria. El tamaño del tablero es 15 x 15, hay algunas casillas con premios (41) y muchas con descuentos (28).

Casillas especiales

• La casilla de inicio suma un punto a la ficha colocada en dicha posición.

• Las casillas azules rotuladas "F x2" y "F x3" multiplican por 2 o por 3 respectivamente, el puntaje de la ficha colocada en esa posición.

• Las casillas violetas rotuladas "P x2" y "P x3" multiplican por 2 o por 3 respectivamente, el puntaje de la palabra formada. Los multiplicadores pueden acumularse, es decir, si la palabra ocupa una casilla "P x3" y una "P x2", se multiplicará por 5 el puntaje de la palabra formada.

• Las casillas negras rotuladas "F -1", "F -2" y "F -3" restan 1, 2 o 3 puntos respectivamente, a la ficha colocada en esa posición.

En todo momento estará visible el puntaje del jugador y de la computadora. Para calcular el puntaje de una jugada se le suma el de cada ficha. Además, si la ficha está ubicada en una casilla especial, se aplicará el modificador correspondiente. El puntaje mínimo de una jugada es 0 (cero).

Fin de la partida

La partida finaliza cuando ocurre alguna de las siguientes situaciones:

• El jugador presiona el botón “Terminar”.

• La computadora no puede formar ninguna palabra y no puede intercambiar sus fichas debido a que alcanzó el máximo de cambios.

• No hay suficientes fichas en la bolsa para repartir a los jugadores.

• Se acaba el tiempo límite de la partida.

Una vez finalizada la partida, se revelan las fichas del atril de la computadora y al puntaje final de cada jugador se le resta el puntaje de las fichas que quedaron en sus atriles. Finalmente, se informa si ocurrió un empate o, en caso contrario, el ganador de la partida con su respectivo puntaje.