Biblioteca de Python para desarrollar juegos retro.

Inspirado en consolas retro, aplica varias restricciones como una paleta de 16 colores y 4 canales de audio.

• Repositorio de código

• Multiplataforma (Windows, Mac, Linux y web)
• Programable con Python (aunque está hecho en Rust)
• Paleta de 16 colores
• 3 bancos de imágenes de 256×256
• 8 tilemaps de 256×256
• 4 canales con 64 sonidos diferentes
• 8 pistas de música combinando cualquier sonido
• Compatible con teclado, ratón y mando
• Herramientas para la edición de imágenes y sonidos
• Bancos, canales y colores extensibles por el usuario

En Linux, sería de la siguiente manera:

sudo pip3 install -U pyxel

En Arch Linux, está disponible mediante el paquete python-pyxel, en AUR.

Ejemplo más sencillo que muestra un texto por pantalla:

import pyxel
 
class App:
    def __init__(self):
        pyxel.init(160,120,title="Hello, world")
        pyxel.run(self.update, self.draw)
 
    def update(self):
        # Se ejecutará 60 veces por segundo (FPS)
        if pyxel.btnp(pyxel.KEY_Q):
            pyxel.quit()
 
    def draw(self):
        pyxel.cls(0)
        pyxel.text(55, 41, "Hello, world!", 5)
 
App()

Si guardamos el fichero como main.py, lo podríamos ejecutar con:

pyxel run main.py

Esta función inicializa el motor de Pyxel y genera la ventana.

pyxel.init(160,120,title="Hello, world")

La anterior instrucción crea una ventana de 160 x 120 pixeles con el título Hello, world.

Firma de la función:

init(width, height, [title], [fps], [quit_key], [display_scale], [capture_scale], [capture_sec])

• width: anchura de la pantalla.
• height: altura de la pantalla.
• title: título de la ventana.
• fps: frames por segundo.
• quit_key: tecla para cerrar la aplicación.
• display_scale:
• capture_scale
• capture_sec: duración máxima (segundos) de la captura de vídeo.

Esta función inicia la aplicación Pyxel. Necesita recibir por parámetro 2 funciones:

• update: actualiza los valores del juego (controles, física, etc) en cada frame.
• draw: dibuja elementos en pantalla

pyxel.run(self.update, self.draw)

Por defecto, la función update se ejecuta 30 veces por segundo.

Todas las funciones disponibles de la API de Pyxel se pueden consultar en:

• API Reference

Al tratarse de scripts en Python, los juegos hechos con Pyxel se pueden lanzar de la siguiente manera:

python mijuego.py

También puede ejecutarse con el comando pyxel run:

pyxel run mijuego.py

Si queremos que Pyxel esté pendiente de los cambios en un directorio y relance el programa cuando esto suceda:

pyxel watch <DIRECTORIO_CON_APLICACION_PYXEL>

Pyxel dispone de un formato propio de distribución multiplataforma. Se crea de la siguiente manera:

pyxel package <DIRECTORIO_APLICACION_PYXEL> <FICHERO_PRINCIPAL>

Tanto los ficheros con el código como los recursos estarán contenidos en un único fichero.

El paquete creado se puede ejecutar con:

pyxel play <fichero.pyxapp>

pyxel app2exe <fichero.pyxapp>

pyxel app2html <fichero.pyxapp>

El fichero .html resultante podremos abrirlo con cualquier navegador y el juego se ejecutará en él.

Pyxel incluye un editor visual desde el que podremos crear recursos:

• Imágenes (sprites)
• Tilemap (mapas)
• Efectos de sonido
• Música

Para abrir este editor:

pyxel edit <fichero.pyxres>

El editor tiene 3 bancos de imágenes (0, 1, 2) con lo que podremos guardar hasta 3 imágenes de 256×256.

También se puede arrastrar una imagen (PNG, GIF o JPEG) y se mostrará en un banco de imágenes del editor.

El editor de tilemaps nos permite hacer mosaicos que luego se utilizarán para crear mapas en el juego.

Podemos hacer mapas a partir de los elementos que hay en los bancos de imágenes.

Podemos tener hasta 7 mapas usando los 3 bancos de imágenes.

Permite generar hasta 64 sonidos diferentes.

Los sonidos son MIDI y se pueden añadir efectos sobre los sonidos.

Por defecto, Pyxel soporta 16 colores que están representados por números enteros (del 0 al 15), pero también se pueden usar constantes definidas en este fichero: https://github.com/kitao/pyxel/blob/main/python/pyxel/__init__.pyi

Por ejemplo:

Se pueden consultar la definición de las teclas, entre otras cosas, en este fichero: https://github.com/kitao/pyxel/blob/main/python/pyxel/__init__.pyi

Por ejemplo:

Desde Pyxel también se puede usar el ratón y mandos (hasta 4 mandos).

Se pueden consultar la definición de las teclas, entre otras cosas, en este fichero: https://github.com/kitao/pyxel/blob/main/python/pyxel/__init__.pyi

Por ejemplo:

En el repositorio de Pyxel hay varios scripts con ejemplos de juegos que se pueden hacer con esta biblioteca:

• https://github.com/kitao/pyxel/tree/main/python/pyxel/examples

Se recomienda seguir el siguiente orden para aprender Pyxel: 01, 05, 03, 04, 02.

Otros ejemplos en esta wiki:

• Pong clon
• Breakout clon
• Endless Runner clon
• Snake clon
• Space Invaders clon
• Tetris clon
• Flappy Bird clon

• https://github.com/kitao/pyxel/wiki/Pyxel-User-Examples
• https://github.com/shivanju/pyxel-games
• https://github.com/gonzalocarreterohdz/Super-Mario-Bros-Game
• https://github.com/dascruz/mario-bros-revisited
• https://github.com/timbledum/snake
• https://github.com/nadi726/Rocket-Flight
• Python Retro Game Tutorial (vídeo)
• Create a Retro Game with Pyxel in Python (Breakout) (vídeo)
• Taller de Pyxel | Gamejam (vídeo)
• Victor Suarez - Pyxel: Los 8 bits Retro Pythoneros (vídeo)
• ¡Crea fácilmente juegos retro con Pyxel! ¡Incluso los principiantes pueden hacer juegos en Python! (vídeo, audio en japonés, pero hay subtítulos en español)