🏰 Liverbot - Bot de RPG para Discord

Liverbot es un bot de RPG interactivo para Discord que permite a los jugadores crear personajes, unirse a gremios, luchar contra enemigos y subir de nivel.
Los gremios y personajes se guardan de forma persistente, por lo que el progreso nunca se perderá, incluso si el bot se reinicia.

---

📌 Características

✅ Sistema de Personajes → Crea, sube de nivel y guarda tu personaje
✅ Sistema de Gremios → Crea, únete y gestiona gremios
✅ Batallas & Eventos → Enfréntate a enemigos, descansa en posadas y gana recompensas
✅ Generador de Builds → Obtén una build aleatoria de League of Legends
✅ Generador de Composiciones de TFT → Consulta las mejores composiciones de TFT
✅ Sistema de Bienvenida → Genera tarjetas personalizadas para nuevos miembros
✅ Datos Persistentes → Los personajes y gremios se guardan en JSON
✅ Juego Personalizable → Modifica la lógica del juego fácilmente

---

🔧 Instrucciones de Instalación

1️⃣ Crear un Entorno Virtual

Primero, crea y activa un entorno virtual para mantener las dependencias aisladas.

En Windows:

python -m venv venv
venv\Scripts\activate

En macOS/Linux:

python3 -m venv venv
source venv/bin/activate

---

2️⃣ Instalar Dependencias

Asegúrate de tener Python instalado y luego instala las librerías necesarias:

pip install -r requirements.txt

Si requirements.txt no existe, instala las librerías manualmente:

pip install discord json requests pillow selenium python-dotenv

Si ejecutas el bot en un servidor Linux sin entorno gráfico, también instala:

sudo apt update && sudo apt install -y xvfb

---

3️⃣ Configurar Variables de Entorno

Crea un archivo .env o configura el token del bot de Discord manualmente:

En macOS/Linux:

export DISCORD_BOT_TOKEN="tu-token-aquí"

En Windows (CMD):

set DISCORD_BOT_TOKEN=tu-token-aquí

---

4️⃣ Ejecutar el Bot

Si usas un entorno normal:

python bot.py

Si estás en un servidor Linux sin entorno gráfico, usa:

xvfb-run python3 bot.py

---

🎮 Guía de Comandos

El bot tiene cinco sistemas principales:
1️⃣ Sistema RPG (Creación de personajes, batallas, descanso)
2️⃣ Sistema de Gremios (Creación, gestión e información de gremios)
3️⃣ Generador de Builds (League of Legends)
4️⃣ Generador de Composiciones de TFT (Consulta las mejores composiciones)
5️⃣ Sistema de Bienvenida (Tarjetas de bienvenida personalizadas)

---

📜 Comandos del Sistema RPG

Comando	Descripción
!rpg <nombre_de_personaje> crear	Crea un nuevo personaje
!rpg <nombre_de_personaje> stats	Muestra las estadísticas del personaje
!rpg <nombre_de_personaje> aventura	Ir de aventura (batallas o encontrar objetos)
!rpg <nombre_de_personaje> descansar	Descansa en una posada (restaura HP, cuesta oro)

---

🏰 Comandos del Sistema de Gremios

Comando	Descripción
!guild <nombre_del_gremio> crear	Crea un nuevo gremio
!guild <nombre_de_personaje> unirse <nombre_del_gremio>	Únete a un gremio
!guild <nombre_de_personaje> salir	Sal del gremio
!guild <nombre_del_gremio> info	Muestra los miembros del gremio

---

🎲 Sistema de Aventura

Comando	Descripción
!aventura <nombre_de_personaje>	Enfréntate a eventos aleatorios: batallas, tesoros, maldiciones, etc.

---

⚔️ Comando de Generador de Builds

Comando	Descripción
!build	Genera una build aleatoria de League of Legends

---

🔹 Generador de Composiciones de TFT

El bot obtiene las mejores composiciones de Teamfight Tactics (TFT) desde MetaTFT.

Comando	Descripción
!TFT	Consulta las 5 mejores composiciones de TFT y sus campeones

Ejemplo de salida:

🔹 **Composiciones de TFT**
🛡️ 1. Invocadores y Magos
⚔️ Campeones: Ahri, Soraka, Lux, Taric, Syndra, Vel'Koz

🛡️ 2. Guardianes y Luchadores
⚔️ Campeones: Nasus, Sett, Jax, Garen, Riven, Warwick

---

📥 Descargar el Bot

Comando	Descripción
!descargar	Obtén el código fuente del bot en GitHub

---

👋 Sistema de Bienvenida

El bot da la bienvenida automáticamente a los nuevos miembros enviando una imagen personalizada con su nombre y avatar.

🔹 Comando de Prueba

Puedes probar la función de bienvenida con:

!test_channel

El bot enviará un mensaje de bienvenida en el canal designado.

📌 Configuración del Canal de Bienvenida

1. Asegúrate de que el bot tenga permisos para enviar mensajes e imágenes en el canal de bienvenida.
2. Configura el ID del canal de bienvenida en bot.py.

---

📂 Estructura de Archivos & Almacenamiento de Datos

El bot guarda automáticamente todos los personajes, gremios y builds, así como las imágenes de bienvenida.

📦 RPG-Bot/
 ┣ 📂 data/               # Almacena datos de personajes, gremios y builds
 ┃ ┣ 📜 characters.json   # Guarda las estadísticas de los personajes
 ┃ ┣ 📜 guilds.json       # Guarda la información de los gremios
 ┃ ┣ 📜 items.json        # Guarda los ítems de League of Legends
 ┃ ┣ 📜 welcome_background.jpg  # Imagen de fondo para la bienvenida
 ┃ ┣ 📜 events.json       # eventos para aventura
 ┣ 📜 bot.py              # Lógica principal del bot de Discord
 ┣ 📜 rpg_game.py         # Mecánicas del juego RPG
 ┣ 📜 scraper.py          # Scraping de TFT desde MetaTFT
 ┣ 📜 image_generator.py  # Generación de imágenes de bienvenida
 ┣ 📜 README.md           # Instrucciones y guía de uso
 ┣ 📜 requirements.txt    # Archivo de dependencias

---

🚀 Opciones de Implementación

Puedes desplegar el bot en servicios en la nube para que funcione 24/7:

• Railway
• Replit
• Heroku
• AWS EC2

---

❓ ¿Necesitas Ayuda?

Si necesitas más funcionalidades, personalización o ayuda para desplegar el bot, ¡pregunta y te ayudaré! 🚀