Skip to content

exeptionhandler/Sokoromi

Repository files navigation

🎮 Sokoromi - Bot de Sokoban Kawaii para Discord

Python Discord Bot Sokoban Kawaii

✨ Descripción

Sokoromi es un adorable bot de Discord que trae el clásico juego de rompecabezas Sokoban directamente a tu servidor con un toque kawaii único. Disfruta de mapas infinitos generados aleatoriamente, compite en tablas de clasificación globales y personaliza tu experiencia con una interfaz súper kawaii.

🌟 Características Principales

  • 🗺️ Mapas infinitos aleatorios - Nunca te quedarás sin desafíos
  • 📊 Sistema de puntuación y estadísticas - Rastrea tu progreso
  • 🏆 Tabla de clasificación global - Compite con jugadores de todo el mundo
  • 🎨 Interfaz kawaii personalizable - Hace que cada partida sea adorable
  • 🎮 Controles intuitivos - Fácil de jugar para todos
  • 📱 Soporte multiplataforma - Funciona en móvil, escritorio y consola
  • Comandos slash - Interfaz moderna de Discord

🚀 Instalación Rápida

Prerrequisitos

Pasos de Instalación

Clona el repositorio

git clone https://github.com/exeptionhandler/Sokoromi.git

Navega al directorio

cd Sokoromi

Crea un entorno virtual

python -m venv sokoromi-env

Activa el entorno virtual En Windows:

sokoromi-env\Scripts\activate

En Linux/macOS:

source sokoromi-env/bin/activate

Instala las dependencias

pip install -r requirements.txt

text

⚙️ Configuración

  1. Crea un archivo .env en el directorio raíz: TOKEN=tu_token_de_bot_aqui PREFIX=/

  2. Invita el bot a tu servidor con los permisos necesarios:

    • Enviar mensajes
    • Usar comandos de aplicación
    • Insertar enlaces
    • Leer historial de mensajes
  3. Ejecuta el bot:

python main.py

🎯 Comandos Principales

Comando Descripción Ejemplo
/play Inicia una nueva partida /play
/stop Terminar partida actual /stop
/info Muestra todos los comandos disponibles /info

🕹️ Controles de Juego

  • W/↑ - Mover arriba
  • A/← - Mover izquierda
  • S/↓ - Mover abajo
  • D/→ - Mover derecha
  • 🔄 - Reiniciar nivel
  • - Terminar partida

🎨 Capturas de Pantalla

image

🤝 Contribuir

¡Las contribuciones son bienvenidas! Si tienes ideas para mejorar Sokoromi:

  1. Haz un fork del proyecto
  2. Crea una rama para tu característica (git checkout -b feature/nueva-caracteristica)
  3. Commitea tus cambios (git commit -m 'Añade nueva característica')
  4. Push a la rama (git push origin feature/nueva-caracteristica)
  5. Abre un Pull Request

🐛 Reportar Problemas

¿Encontraste un bug? ¡Ayúdanos a mejorar!

  • Abre un issue
  • Describe el problema detalladamente
  • Incluye pasos para reproducir el error

📄 Licencia

Este proyecto está bajo la Licencia GNU. Ver el archivo LICENSE para más detalles.

🎀 Créditos


⭐ ¡No olvides darle una estrella al repo si te gusta Sokoromi! ⭐

¿Tienes preguntas? ¡Únete a nuestro servidor de Discord para soporte!