tetrigo

tetrigo

el árbol va

Una implementación de Tetris en Golang, siguiendo la guía oficial de diseño de Tetris de 2009.

Este proyecto consta de tres componentes principales, dependiendo de cuáles sean sus objetivos:

• "Solo quiero jugar al Tetris"
  • La TUI (Interfaz de usuario de texto) en cmd/tetrigo/ es para usted. Consulte la sección de instalación.
• "Quiero crear mi propio juego/UI de Tetris"
  • Los paquetes en pkg/tetris/modes/ son para ti. Puedes reutilizar estos modos de juego con tu propia interfaz de usuario.
• "Quiero crear mi propio modo de juego Tetris"
  • Los paquetes en pkg/tetris/ son para ti. Puedes crear tu propio modo de juego con un conjunto personalizado de reglas y requisitos.

Puedes encontrar más información sobre estas secciones en la sección de desarrollo. Si tiene alguna sugerencia, error o solicitud de función, abra una incidencia de GitHub.

Contenido

• Instalación
• Uso
• Configuración
• Datos
• Desarrollo

Instalación

Tetrigo se puede instalar descargando el binario o compilándolo desde el código fuente. Consulte las instrucciones a continuación para conocer su método preferido.

Binario

Puedes descargar el binario correspondiente a tu sistema operativo desde la página de lanzamientos en GitHub.

Una vez descargado puedes ejecutar el binario desde la línea de comando:

 # Linux or macOS
./tetrigo

# Windows
tetrigo.exe

Opcionalmente, puedes mover el binario a un directorio en tu $PATH para ejecutarlo desde cualquier lugar (ejemplo).

Construir desde la fuente

Asegúrese de tener una versión compatible de Go instalada y configurada correctamente. Puede encontrar la versión mínima requerida de Go en el archivo go.mod.

Luego puede instalar la última versión globalmente ejecutando:

go install github.com/Broderick-Westrope/tetrigo/cmd/tetrigo@latest

O puede instalar en otro directorio:

env GOBIN=/bin go install github.com/Broderick-Westrope/tetrigo/cmd/tetrigo@latest

Uso

Para obtener información general sobre cómo jugar Tetris, consulta esta guía para principiantes.

Controles

Los controles predeterminados del juego son los siguientes:

• Mover a la izquierda : A
• Mover a la derecha : D
• Activar/desactivar caída suave : S
• Caída dura : W
• Girar en el sentido de las agujas del reloj : E
• Girar en sentido antihorario : Q
• Mantenga presionada la opción de menú Tetrimino / Enviar : Space o Enter
• Pausar juego/Salir : Escape
• Forzar salida del juego : Ctrl+C
• Mostrar controles Ayuda : ?

Los controles del juego se pueden cambiar en el archivo de configuración.

Se puede navegar por el menú, la tabla de clasificación, etc. usando las teclas de flecha (mover), escapar (salir) e ingresar (enviar). Estos controles no son configurables.

Configuración

CLI

Al iniciar Tetrigo sin subcomandos ni banderas, se iniciará el juego en el menú donde puedes configurar manualmente ajustes simples como el nombre del jugador y el modo de juego:

./tetrigo

También puedes iniciar el juego directamente en un modo de juego (por ejemplo, Maratón), omitiendo el menú:

 # Start the game in Marathon mode with a level of 5 and the player name "Brodie"
./tetrigo play marathon --level=5 --name=Brodie 

Para ver más opciones para iniciar el juego puedes ejecutar:

./tetrigo --help

TOML

Se puede realizar una configuración más compleja utilizando un archivo TOML. Si no se encuentra ningún archivo de configuración, se utilizarán valores predeterminados sensatos.

De forma predeterminada, Tetrigo buscará el archivo ./tetrigo/config.toml dentro del directorio de configuración XDG (o equivalente) del dispositivo. adrg/xdg define valores XDG_CONFIG_HOME para varios sistemas operativos (por ejemplo, en macOS existe el directorio ~/Library/Application Support se almacenará allí; de lo contrario, en ~/Library/Preferences ). Puede especificar un archivo diferente usando el indicador --config .

./tetrigo --config=/path/to/config.toml

Se proporciona un archivo de configuración de ejemplo en example.config.toml .

Datos

Los datos del juego se almacenan en una base de datos SQLite. De forma predeterminada, la base de datos se almacena en ./tetrigo/tetrigo.db dentro del directorio de datos XDG (o equivalente) del dispositivo. adrg/xdg define XDG_DATA_HOME para varios sistemas operativos (por ejemplo, en macOS, si el directorio ~/Library/Application Support existe, se almacenará allí; de lo contrario, en /Library/Application Support ). Puede especificar una ruta de archivo diferente utilizando el indicador --db .

./tetrigo --db=/path/to/data.db

Desarrollo

Este proyecto consta de tres componentes principales:

1. cmd/tetrigo/ : Una TUI (Interfaz de usuario de texto) que te permite reproducirlo desde el primer momento. También sirve como demostración sobre cómo usar los paquetes y cómo crear una TUI usando Bubble Tea.
2. pkg/tetris/modes/ : La funcionalidad para diferentes modos de juego de Tetris. Esto se puede utilizar para crear fácilmente un juego de Tetris con tu propia interfaz de usuario pero sin necesidad de conocer el conjunto de reglas.
3. pkg/tetris/ : La lógica central de Tetris, que incluye cosas como Tetrminimos, Matrix y la puntuación. Esto se puede utilizar para crear modos de juego con su propio conjunto de reglas y requisitos.

Task es la herramienta de construcción utilizada en este proyecto. La configuración de la tarea se encuentra en Taskfile.yaml. Una vez instalada la CLI de tareas, puede ver todas las tareas disponibles ejecutando:

task -l

Puede ejecutar la TUI utilizando la tarea run :

task run

Edificio

Puede construir el proyecto usando la tarea build :

task build

Esto creará un binario en el directorio bin/ que se puede ejecutar siguiendo las instrucciones de la sección Instalación.

Pruebas

Las pruebas se pueden ejecutar utilizando la tarea test :

task test

También puede utilizar la tarea cover para generar y abrir un informe de cobertura:

task cover

Las prioridades ordenadas para las pruebas son:

1. pkg/tetris/
2. pkg/tetris/modes/
3. cmd/tetrigo/

HACER

• Agregar más pruebas
  • Agregue pruebas para calificar endOnMaxLevel.
  • Revisar las pruebas de calificación.
• Agregue las opciones de bloqueo restantes.
• Verifique el bloqueo 0,5 s después de aterrizar en una superficie
  • También en Soft Drop, pero no en Hard Drop.
  • Esto se reinicia después de cada movimiento y rotación, para un total de 15 movimientos/rotaciones.
  • Consulte "Bloqueo de ubicación extendida" en las pautas de diseño.
• Gana puntos con T-Spins
• Multijugador SSH (similar a Gambit)