Tutorial Pygame: Cómo Crear un Juego 2D en Python Paso a Paso

¿Quieres iniciarte en el emocionante mundo del desarrollo de videojuegos 2D? Este tutorial Pygame te guiará desde cero para que puedas crear juegos 2D en Python de manera sencilla y divertida. Aprenderás a instalar el entorno, crear una ventana de juego, manejar eventos, dibujar gráficos, animar objetos, implementar lógica básica y detectar colisiones. ¡Comencemos!

¿Qué es Pygame y por qué usarlo?

Pygame es una librería de Python que facilita la creación de videojuegos 2D. Proporciona herramientas para manejar ventanas, gráficos, sonidos y eventos de forma sencilla, ideal para principiantes e intermedios.

Ventajas de Pygame:

Fácil de aprender: sintaxis clara y documentación abundante.
Multiplataforma: funciona en Windows, macOS y Linux.
Comunidad activa: muchos tutoriales y ejemplos.

Paso 1: Instalación del entorno

Antes de empezar a programar, necesitamos instalar Python y Pygame.

1. Instalar Python

Si no tienes Python instalado, descárgalo desde https://www.python.org/downloads/ e instálalo.

Para verificar que Python está instalado, abre una terminal o consola y escribe:

python --version

1 2	python --version

Debería mostrar la versión instalada.

2. Instalar Pygame

Se instala fácilmente usando pip, el gestor de paquetes de Python.

pip install pygame

1 2	pip install pygame

Verifica la instalación ejecutando:

python -m pygame.examples.aliens

1 2	python -m pygame.examples.aliens

Esto ejecuta un pequeño juego de demostración.

Paso 2: Crear la ventana del juego

El primer paso para desarrollar juegos Python con Pygame es crear una ventana donde dibujaremos todo.

Crea un archivo llamado main.py y escribe este código:

import pygame

# Inicializamos Pygame
pygame.init()

# Definimos el tamaño de la pantalla
ancho, alto = 800, 600
pantalla = pygame.display.set_mode((ancho, alto))

# Título de la ventana
pygame.display.set_caption('Mi primer juego con Pygame')

# Bucle principal
corriendo = True
while corriendo:
    for evento in pygame.event.get():
        if evento.type == pygame.QUIT:
            corriendo = False

# Salimos de Pygame
pygame.quit()

import pygame

# Inicializamos Pygame

pygame.init()

# Definimos el tamaño de la pantalla

ancho, alto = 800, 600

pantalla = pygame.display.set_mode((ancho, alto))

# Título de la ventana

pygame.display.set_caption('Mi primer juego con Pygame')

# Bucle principal

corriendo = True

while corriendo:

for evento in pygame.event.get():

if evento.type == pygame.QUIT:

corriendo = False

# Salimos de Pygame

pygame.quit()

Explicación:

pygame.init() inicia los módulos de Pygame.
pygame.display.set_mode() crea una ventana con el tamaño indicado.
En el bucle principal, escuchamos eventos; si se cierra la ventana (QUIT), terminamos.
Finalmente cerramos de forma limpia.

Ejecuta el archivo con:

python main.py

1 2	python main.py

Deberías ver una ventana vacía.

Paso 3: Manejo de eventos y entrada del usuario

Aprender a capturar eventos como teclas o ratón es vital para la interactividad.

Modifiquemos el código para que la ventana se cierre cuando presiones la tecla ESC:

import pygame

pygame.init()

ancho, alto = 800, 600
pantalla = pygame.display.set_mode((ancho, alto))
pygame.display.set_caption('Eventos en Pygame')

corriendo = True
while corriendo:
    for evento in pygame.event.get():
        if evento.type == pygame.QUIT:
            corriendo = False
        elif evento.type == pygame.KEYDOWN:
            if evento.key == pygame.K_ESCAPE:
                corriendo = False

pygame.quit()

import pygame

pygame.init()

ancho, alto = 800, 600

pantalla = pygame.display.set_mode((ancho, alto))

pygame.display.set_caption('Eventos en Pygame')

corriendo = True

while corriendo:

for evento in pygame.event.get():

if evento.type == pygame.QUIT:

corriendo = False

elif evento.type == pygame.KEYDOWN:

if evento.key == pygame.K_ESCAPE:

corriendo = False

pygame.quit()

Explicación:

KEYDOWN detecta cuando una tecla es presionada.
evento.key compara la tecla específica, en este caso ESC.

Paso 4: Dibujar gráficos en pantalla

Vamos a mostrar formas básicas en la ventana, como un rectángulo o círculo.

Actualiza main.py así:

import pygame

pygame.init()
ancho, alto = 800, 600
pantalla = pygame.display.set_mode((ancho, alto))
pygame.display.set_caption('Dibujo de Formas')

# Colores RGB
blanco = (255, 255, 255)
rojo = (255, 0, 0)
azul = (0, 0, 255)

corriendo = True
while corriendo:
    for evento in pygame.event.get():
        if evento.type == pygame.QUIT:
            corriendo = False

    pantalla.fill(blanco)  # Color de fondo

    # Dibujar un rectángulo rojo
    pygame.draw.rect(pantalla, rojo, (150, 150, 100, 50))

    # Dibujar un círculo azul
    pygame.draw.circle(pantalla, azul, (400, 300), 40)

    pygame.display.flip()

pygame.quit()

import pygame

pygame.init()

ancho, alto = 800, 600

pantalla = pygame.display.set_mode((ancho, alto))

pygame.display.set_caption('Dibujo de Formas')

# Colores RGB

blanco = (255, 255, 255)

rojo = (255, 0, 0)

azul = (0, 0, 255)

corriendo = True

while corriendo:

for evento in pygame.event.get():

if evento.type == pygame.QUIT:

corriendo = False

pantalla.fill(blanco) # Color de fondo

# Dibujar un rectángulo rojo

pygame.draw.rect(pantalla, rojo, (150, 150, 100, 50))

# Dibujar un círculo azul

pygame.draw.circle(pantalla, azul, (400, 300), 40)

pygame.display.flip()

pygame.quit()

Explicación:

pantalla.fill() pinta el fondo.
pygame.draw.rect() dibuja un rectángulo.
pygame.draw.circle() dibuja un círculo.
pygame.display.flip() actualiza la pantalla.

Paso 5: Animaciones básicas

Para animar objetos, hay que moverlos y actualizar la pantalla en cada frame.

Creamos un círculo que se mueve horizontalmente.

import pygame

pygame.init()
ancho, alto = 800, 600
pantalla = pygame.display.set_mode((ancho, alto))
pygame.display.set_caption('Animación básica')

blanco = (255, 255, 255)
azul = (0, 0, 255)

x = 0
y = 300
velocidad = 5

reloj = pygame.time.Clock()

corriendo = True
while corriendo:
    for evento in pygame.event.get():
        if evento.type == pygame.QUIT:
            corriendo = False

    pantalla.fill(blanco)

    # Dibujar círculo en posición actual
    pygame.draw.circle(pantalla, azul, (x, y), 40)

    # Actualizar posición
    x += velocidad

    # Volver al inicio si sale de pantalla
    if x > ancho:
        x = 0

    pygame.display.flip()
    reloj.tick(60)  # Limitar a 60 FPS

pygame.quit()

import pygame

pygame.init()

ancho, alto = 800, 600

pantalla = pygame.display.set_mode((ancho, alto))

pygame.display.set_caption('Animación básica')

blanco = (255, 255, 255)

azul = (0, 0, 255)

x = 0

y = 300

velocidad = 5

reloj = pygame.time.Clock()

corriendo = True

while corriendo:

for evento in pygame.event.get():

if evento.type == pygame.QUIT:

corriendo = False

pantalla.fill(blanco)

# Dibujar círculo en posición actual

pygame.draw.circle(pantalla, azul, (x, y), 40)

# Actualizar posición

x += velocidad

# Volver al inicio si sale de pantalla

if x > ancho:

x = 0

pygame.display.flip()

reloj.tick(60) # Limitar a 60 FPS

pygame.quit()

Explicación:

La posición x se incrementa cada frame, moviendo el círculo.
reloj.tick(60) limita la velocidad a 60 cuadros por segundo.
Cuando el círculo sale por la derecha, vuelve a empezar desde 0.

Paso 6: Uso de imágenes y sprites

Para juegos más ricos, se usan imágenes en lugar de formas básicas.

Guarda una imagen llamada jugador.png en la carpeta del proyecto.

Luego, modifica el código:

import pygame
import os

pygame.init()
ancho, alto = 800, 600
pantalla = pygame.display.set_mode((ancho, alto))
pygame.display.set_caption('Sprites con imágenes')

blanco = (255, 255, 255)

# Cargar imagen
jugador = pygame.image.load(os.path.join('jugador.png'))
x, y = 100, 100
velocidad = 5

reloj = pygame.time.Clock()
corriendo = True
while corriendo:
    for evento in pygame.event.get():
        if evento.type == pygame.QUIT:
            corriendo = False

    keys = pygame.key.get_pressed()
    if keys[pygame.K_LEFT]:
        x -= velocidad
    if keys[pygame.K_RIGHT]:
        x += velocidad
    if keys[pygame.K_UP]:
        y -= velocidad
    if keys[pygame.K_DOWN]:
        y += velocidad

    pantalla.fill(blanco)
    pantalla.blit(jugador, (x, y))  # Dibujar imagen

    pygame.display.flip()
    reloj.tick(60)

pygame.quit()

import pygame

import os

pygame.init()

ancho, alto = 800, 600

pantalla = pygame.display.set_mode((ancho, alto))

pygame.display.set_caption('Sprites con imágenes')

blanco = (255, 255, 255)

# Cargar imagen

jugador = pygame.image.load(os.path.join('jugador.png'))

x, y = 100, 100

velocidad = 5

reloj = pygame.time.Clock()

corriendo = True

while corriendo:

for evento in pygame.event.get():

if evento.type == pygame.QUIT:

corriendo = False

keys = pygame.key.get_pressed()

if keys[pygame.K_LEFT]:

x -= velocidad

if keys[pygame.K_RIGHT]:

x += velocidad

if keys[pygame.K_UP]:

y -= velocidad

if keys[pygame.K_DOWN]:

y += velocidad

pantalla.fill(blanco)

pantalla.blit(jugador, (x, y)) # Dibujar imagen

pygame.display.flip()

reloj.tick(60)

pygame.quit()

Explicación:

pygame.image.load() carga la imagen.
.blit() dibuja la imagen en pantalla.
pygame.key.get_pressed() detecta teclas mantenidas para mover la imagen.

Paso 7: Lógica básica de juego

Creamos un juego sencillo donde controlas un rectángulo y debes evitar colisiones con un obstáculo.

import pygame

pygame.init()
ancho, alto = 800, 600
pantalla = pygame.display.set_mode((ancho, alto))
pygame.display.set_caption('Juego básico con colisiones')

blanco = (255, 255, 255)
negro = (0, 0, 0)
rojo = (255, 0, 0)

# Jugador
jugador_rect = pygame.Rect(50, 50, 50, 50)
velocidad = 5

# Obstáculo
obstaculo_rect = pygame.Rect(400, 300, 100, 100)

reloj = pygame.time.Clock()
corriendo = True
while corriendo:
    for evento in pygame.event.get():
        if evento.type == pygame.QUIT:
            corriendo = False

    keys = pygame.key.get_pressed()
    if keys[pygame.K_LEFT]:
        jugador_rect.x -= velocidad
    if keys[pygame.K_RIGHT]:
        jugador_rect.x += velocidad
    if keys[pygame.K_UP]:
        jugador_rect.y -= velocidad
    if keys[pygame.K_DOWN]:
        jugador_rect.y += velocidad

    # Limitar movimientos dentro de la pantalla
    jugador_rect.clamp_ip(pantalla.get_rect())

    # Detectar colisión
    if jugador_rect.colliderect(obstaculo_rect):
        print('¡Colisión detectada!')

    pantalla.fill(blanco)
    pygame.draw.rect(pantalla, negro, jugador_rect)
    pygame.draw.rect(pantalla, rojo, obstaculo_rect)

    pygame.display.flip()
    reloj.tick(60)

pygame.quit()

import pygame

pygame.init()

ancho, alto = 800, 600

pantalla = pygame.display.set_mode((ancho, alto))

pygame.display.set_caption('Juego básico con colisiones')

blanco = (255, 255, 255)

negro = (0, 0, 0)

rojo = (255, 0, 0)

# Jugador

jugador_rect = pygame.Rect(50, 50, 50, 50)

velocidad = 5

# Obstáculo

obstaculo_rect = pygame.Rect(400, 300, 100, 100)

reloj = pygame.time.Clock()

corriendo = True

while corriendo:

for evento in pygame.event.get():

if evento.type == pygame.QUIT:

corriendo = False

keys = pygame.key.get_pressed()

if keys[pygame.K_LEFT]:

jugador_rect.x -= velocidad

if keys[pygame.K_RIGHT]:

jugador_rect.x += velocidad

if keys[pygame.K_UP]:

jugador_rect.y -= velocidad

if keys[pygame.K_DOWN]:

jugador_rect.y += velocidad

# Limitar movimientos dentro de la pantalla

jugador_rect.clamp_ip(pantalla.get_rect())

# Detectar colisión

if jugador_rect.colliderect(obstaculo_rect):

print('¡Colisión detectada!')

pantalla.fill(blanco)

pygame.draw.rect(pantalla, negro, jugador_rect)

pygame.draw.rect(pantalla, rojo, obstaculo_rect)

pygame.display.flip()

reloj.tick(60)

pygame.quit()

Explicación:

Creamos rectángulos que representan objetos del juego.
colliderect() detecta si dos rectángulos se superponen.
clamp_ip() limita al jugador dentro de la ventana.

Buenas prácticas para desarrollo de juegos con Pygame

Separa la lógica y el renderizado. Esto facilita mantenimiento y mejora rendimiento.
Controla el framerate con pygame.time.Clock(). Evita que el juego vaya demasiado rápido.
Utiliza constantes para colores y configuraciones. Hace el código más legible.
Documenta tu código con comentarios. Facilita la comprensión.
Divide el código en funciones o clases. Mejora organización y reutilización.

Conclusión

¡Felicidades! Acabas de aprender cómo crear un juego 2D en Python usando Pygame, desde instalar el entorno hasta implementar animaciones y colisiones básicas. Este conocimiento es la base para desarrollar juegos cada vez más complejos y divertidos.

Te invitamos a continuar experimentando: intenta agregar puntajes, más enemigos, diferentes niveles o sonidos, todo con Pygame y Python.

¿Te gustó este tutorial Pygame? ¡Comparte tu primer juego con la comunidad y sigue creando!

Para seguir aprendiendo:

Visita la documentación oficial de Pygame
Explora cursos y tutoriales avanzados
Únete a foros y grupos de desarrollo de juegos

¡Mucho éxito en tu camino para dominar el desarrollo juegos Python!