Recreación Moderna de Pac-Man: Aprende a Desarrollar Juegos Cross-Platform con .NET y Avalonia UI

Introducción: ¡Revive el Clásico Pac-Man y Aprende Programación de Juegos!

¡Hola, futuro desarrollador! Si eres un estudiante o principiante en programación y siempre has soñado con crear tu propio videojuego, este artículo es para ti. Imagina recrear el icónico Pac-Man, ese juego arcade que ha entretenido a generaciones, pero con herramientas modernas que funcionan en Windows y Linux. El proyecto "Pac-Man Recreation" del repositorio de GitHub (https://github.com/JalaU-Capstones/pacman-recreation) es un ejemplo perfecto para empezar. No necesitas ser un experto; te guiaré paso a paso desde cero, explicando cada funcionalidad, tecnología y cómo puedes contribuir o modificarlo. ¡Al final, tendrás las bases para desarrollar tus propios juegos!

Este proyecto no solo es un juego divertido, sino una lección práctica en desarrollo cross-platform. Usaremos .NET 9.0 y Avalonia UI, que permiten crear aplicaciones de escritorio que corren en múltiples sistemas operativos sin complicaciones. Si eres nuevo, piensa en esto como tu primer paso hacia una carrera en game dev. ¡Vamos a sumergirnos!

Tecnologías Utilizadas: El Stack Moderno para Juegos de Escritorio

Antes de entrar en el código, veamos las herramientas clave que hacen posible este proyecto:

.NET 9.0 SDK: El framework principal de Microsoft para desarrollar aplicaciones en C#. Es gratuito, open-source y soporta cross-platform (Windows, Linux, macOS). Proporciona todo lo necesario para lógica de juego, como manejo de eventos y threading.
Avalonia UI: Una biblioteca UI open-source para crear interfaces gráficas cross-platform. Similar a WPF, pero más ligera y compatible con Linux. Se usa para renderizar el mapa, Pac-Man, fantasmas y UI como scores.
C#: El lenguaje principal (83.8% del código). Fácil de aprender si vienes de Java o Python.
Python: Usado en herramientas auxiliares (16.2% del código), como generación de assets en la carpeta tools/AssetGeneration. Ayuda en scripts para procesar imágenes o datos.
Flathub: Para distribución en Linux, facilitando la instalación como un paquete flatpak.
GitHub Actions: Para CI/CD, automatizando builds y tests.
NuGet: Gestor de paquetes para dependencias .NET.
AWS: Mencionado para deployment, posiblemente para hostear leaderboards.

Requisitos para empezar: Instala .NET 9.0 SDK desde el sitio oficial de Microsoft (https://dotnet.microsoft.com/download/dotnet/9.0). Para Linux, usa Flathub.

Funcionalidades del Proyecto: Todo lo que Ofrece Esta Recreación

Este no es solo un clon básico; incluye mejoras modernas. Vamos a desglosar todas las funcionalidades:

Modo Single-Player Clásico:
- 3 niveles con dificultad creciente.
- Comportamiento auténtico de fantasmas: Blinky (rojo, persigue directamente), Pinky (rosa, embosca), Inky (azul, impredecible), Clyde (naranja, aleatorio).
- Sonidos y gráficos originales del arcade.
Multiplayer Online:
- Soporta hasta 5 jugadores.
- Unión directa a partidas en progreso.
Leaderboards Globales:
- Top 10 mundial.
- Envío de scores después de completar los 3 niveles.
- Cache local y cola offline para envíos pendientes.
Sistema de Perfiles:
- Tracking de high scores locales y globales.
Modo Creativo (Editor de Proyectos):
- Diseña niveles personalizados (hasta 10 por proyecto).
- Configura vidas, puntaje para ganar, dificultad por nivel.
- Exporta/importa como paquetes .pacproj.
Soporte Cross-Platform:
- Linux (x64 y ARM64) y Windows.
Características Adicionales en v1.0.0:
- Highscores globales.
- DevConsole para debugging.
- Editor de proyectos.

Otras detalles: Licencia MIT (puedes usarlo libremente), 94 commits en la rama main, release v1.0.0 con foco en editor y highscores.

Instalación y Ejecución Paso a Paso: ¡Clona y Juega!

Para principiantes, empecemos con lo básico. Usa Git para clonar el repo.

Paso 1: Clona el Repositorio

Abre tu terminal y ejecuta:

git clone https://github.com/JalaU-Capstones/pacman-recreation.git
cd pacman-recreation

Paso 2: Restaura Dependencias

dotnet restore

Esto descarga todos los paquetes NuGet definidos en Directory.Packages.props.

Paso 3: Ejecuta el Juego

dotnet run --project src/PacmanGame/PacmanGame.csproj

Para Linux vía Flathub (más fácil):

flatpak install flathub io.github.jalaucapstones.pacman-recreation
flatpak run io.github.jalaucapstones.pacman-recreation

Si usas Python para assets, navega a tools/AssetGeneration y ejecuta scripts (asumiendo un archivo como generate_assets.py, que procesa imágenes para el juego).

Secciones con Código: Explicaciones Paso a Paso

Aunque el core es C#, incluiremos ejemplos de código Python de las tools (para asset generation) y snippets C# conceptuales basados en el proyecto. Todo es ejecutable.

Sección 1: Generación de Assets con Python (de tools/AssetGeneration)

Supongamos un script simple para procesar imágenes (basado en el uso de Python en el repo). Crea un archivo generate_assets.py:

import os
from PIL import Image  # Requiere pip install pillow (pero nota: el entorno del repo no permite installs extras)

def generate_thumbnail(image_path, output_path, size=(128, 128)):
    """Genera un thumbnail para assets del juego."""
    with Image.open(image_path) as img:
        img.thumbnail(size)
        img.save(output_path)
        print(f"Thumbnail generado en {output_path}")

# Ejemplo de uso
if __name__ == "__main__":
    generate_thumbnail("pacman.png", "pacman_thumb.png")

Explicación paso a paso:

Importa PIL para manipular imágenes.
Función generate_thumbnail: Abre imagen, redimensiona y guarda.
Útil para preparar sprites de Pac-Man o fantasmas en el juego.

Ejecútalo: python generate_assets.py. En el mundo real, esto optimiza assets para rendimiento en Avalonia.

Sección 2: Lógica Básica de Movimiento en C# (Conceptual del Juego)

En src/PacmanGame, imagina una clase para Pac-Man. Snippet ejecutable (prueba en un proyecto .NET console):

using System;

class PacMan {
    public int X { get; set; }
    public int Y { get; set; }

    public void Move(string direction) {
        switch (direction) {
            case "up": Y--; break;
            case "down": Y++; break;
            case "left": X--; break;
            case "right": X++; break;
            default: Console.WriteLine("Dirección inválida"); break;
        }
        Console.WriteLine($"Nueva posición: ({X}, {Y})");
    }
}

// Ejemplo de uso
class Program {
    static void Main() {
        PacMan pac = new PacMan { X = 0, Y = 0 };
        pac.Move("right");
        pac.Move("up");
    }
}

Explicación:

Clase PacMan con propiedades X/Y.
Método Move: Actualiza posición basado en dirección.
En el juego real, esto se integra con Avalonia para renderizar en canvas.

Compila y ejecuta: dotnet run. En el mundo real, aplica a colisiones con fantasmas o puntos.

Sección 3: Integración de Leaderboards (Ejemplo Avanzado)

Usa HTTP para enviar scores (conceptual):

using System.Net.Http;
using System.Threading.Tasks;
using System;

class Leaderboard {
    private static readonly HttpClient client = new HttpClient();

    public async Task SendScore(string player, int score) {
        var content = new StringContent($"{{ \"player\": \"{player}\", \"score\": {score} }}");
        var response = await client.PostAsync("https://example-leaderboard.com/submit", content);
        Console.WriteLine(await response.Content.ReadAsStringAsync());
    }
}

// Uso
async Task Main() {
    var lb = new Leaderboard();
    await lb.SendScore("Diego", 10000);
}

Esto simula envío a AWS. En el proyecto, usa cache local si offline.

Ejemplos Prácticos del Mundo Real

Educación: Usa este proyecto en clases de programación para enseñar OOP (clases para entidades como fantasmas).
Portfolio: Modifícalo agregando un nuevo fantasma y súbelo a tu GitHub para impresionar en entrevistas.
Comunidad: Contribuye fixing bugs (ver commits como resolución de assembly loading).
Negocios: Extiéndelo a mobile con .NET MAUI para una app de juegos retro.

Conclusión: ¡Tú Puedes Crear Juegos Increíbles!

¡Felicidades por llegar hasta aquí! Has explorado un proyecto completo que revive Pac-Man con toques modernos. Ahora, clona el repo, experimenta y crea tu versión. Recuerda, el desarrollo de juegos es iterativo: empieza pequeño y construye. ¡Sigue programando y conviértete en un game dev estrella!

Autor: Diego Alejandro Botina (CodeWithBotina)

Referencias

Documentación .NET 9.0: https://learn.microsoft.com/en-us/dotnet/core/whats-new/dotnet-9
Avalonia UI Docs: https://docs.avaloniaui.net/
Repositorio Original: https://github.com/JalaU-Capstones/pacman-recreation
Python PIL: https://pillow.readthedocs.io/en/stable/
Flathub: https://flathub.org/apps/io.github.jalaucapstones.pacman-recreation