Los juegos

He intentado diseñar una arquitectura para la web que permita la incorporación de nuevos juegos como si fueran plug-ins, es decir, que haya una parte central fija que gestione las funcionalidades del sistema y que los juegos se incorporen al sistema mediante clases derivadas de una interfaz común GameBase que define las funciones que deben implementar.

Actualmente hay dos juegos programados de este modo que puedes utilizar como base para crear los tuyos propios:

• Sum: suma de enteros. Es un ejemplo de juego con un código muy simple que muestra al usuario dos números enteros y le pide que los sume. Está aquí con la única intención de mostrar el ejemplo mínimo que permite incorporar un juego al sistema.
• word2def: de la palabra a la definición. Este juego muestra al usuario una palabra y cuatro posibles definiciones entre las que debe escoger la correcta. El código de este juego no se limita a la funcionalidad básica como en el caso anterior, sino que es una aplicación de Django que además tiene sus propias tablas en la base de datos donde almacena los resultados.

Estoy seguro de que en breve habrá alguno más.

Cómo añadir nuevos juegos

Si tienes alguna idea de juego o desafío que quieres que pongamos en el sistema puedes programarlo tú mismo y pedir un pull-request en Github para que lo incorporemos. Te voy a explicar cómo hacerlo:

1. Lo primero que tienes que hacer es preparar el sistema para que puedas probar todo en local antes de subirlo a la web. Es muy sencillo:

   • Haz un fork del repositorio Lingwars/lingwars-games

   • Clónate ese repositorio en tu ordenador.

   • Crea un archivo secret.py junto a ~/appweb/appweb/settings.py con tus claves de Apicultur.

     ACCESS_TOKEN_STORE = "tu access_token"
     ACCESS_TOKEN_IO = "tu access_token"
     

   • Creamos la base de datos de pruebas (será una base de datos local sqlite3):

     ~/appweb$ python manage.py migrate
     

   • Y vamos a arrancar el servidor web en local:

     ~/appweb$ python manage.py runserver
     

   • Llegado aquí deberías ser capaz de acceder a la página en tu navegador introduciendo la dirección http://localhost:8000/

2. Después tendrás que programar el juego. Te recomiendo que empieces por un juego sencillo (o no), pero que no necesite utilizar una base de datos y que sea también de seleccionar una opción entre varias (si tienes interés en crear otro tipo de juego donde la mecánica sea diferente, coméntamelo antes para preparar la infraestructura).

   Todo juego debe cumplir dos requisitos:

   • Debe implementarse en una clase que derive de GameBase
   • Tiene que existir un objeto game de dicho juego en la raíz del paquete de Python.

   La primera condición significa que tienes que crear una clase, con el nombre que quieras, e implementar los métodos make_question y score, tal y como he hecho aquí con SumGame o como aparece a continuación:

   class MyAwesomeGame(GameBase):
       title = 'My Awesome Game'
       author = 'Me myself'
       description = "In this game you blablabla"
   
       def make_question(self, *args, **kwargs):
           question = {
               'query': "Question to the user",
               'options': ["list", "of", "answers",]
               }
           response = {
               'answer': <index of correct answer>,  # Esto debe ser el índice de la respuesta correcta en la lista.
               'info': "Some info to the user"
               }
           return question, response
   
       def score(self, response, user_answer):
           # Check the `user_answer`, it should be equal to response['answer']
           # :param:`response` contains the same data created in `make_question`
           u = user_answer.get('answer', None)
           try:
               u = int(u)
           except TypeError:
               return 0
           else:
               return 1 if u == response.get('answer') else 0
   

   La segunda condición hace referencia a que debe existir una instancia del juego en el archivo __init__.py del paquete. Como ocurre aquí.

Si estos archivos los pones en un nuevo paquete dentro del directorio ~/games/ el sistema debería ser capaz de detectarlos automáticamente y presentarlos en el listado de juegos para que lo pruebes.

Si has llegado hasta aquí, ¡enhorabuena! Manda tu pull-request y estaremos encantados de incorporarlo a la web para que la gente se enfrete a tu nuevo desafío.

En próximos capítulos veremos cómo:

• Crear un juego que no sea de opción múltiple
• Crear juegos que hagan uso de la base de datos (serán aplicaciones de Django)