🎁 Sistema de Drops

El Sistema de Drops es un completo sistema de eventos sorpresa con gamificación, crafting, trading, misiones y personalización. Los drops aparecen aleatoriamente en el servidor y los usuarios deben ser rápidos para reclamarlos.

📊 Descripción General

Los drops son eventos sorpresa que aparecen en canales específicos del servidor. Cada drop tiene una rareza, recompensa en yumes, y puede dar fragmentos para el sistema de crafting. El sistema incluye:

• Sistema base con CRUD completo y WebSocket real-time
• Gamificación con leaderboards, battle pass, notificaciones y streaks
• Misiones y eventos temáticos con drops exclusivos
• Crafting para crear drops de mayor rareza
• Trading/Marketplace P2P para intercambiar drops crafteados
• Personalización con skins y temas
• Balanceo dinámico con ajuste automático de probabilidades

---

🎮 Comandos de Usuario

Ver Información del Sistema

/drops info

Muestra información general sobre el sistema de drops, tipos disponibles, configuración actual.

Ver Historial de Drops

/drops historial

Muestra los últimos 10 drops que han aparecido en el servidor.

Ver Top Recolectores

/drops top

Muestra el ranking de los mejores recolectores de drops del servidor.

Ver Fragmentos

/drops fragmentos

Muestra tu inventario completo de fragmentos (común, poco común, rara, épica, legendaria).

Probabilidades de obtener fragmentos al reclamar drops:

• Común: 30%
• Poco Común: 50%
• Rara: 70%
• Épica: 90%
• Legendaria: 100% (x2 fragmentos)

Craftear Drops

/drops craftear <receta>

Usa tus fragmentos para craftear nuevos drops de mayor rareza.

Recetas disponibles:

1. Uncommon Basic - 5 común → Poco común aleatorio (instantáneo)
2. Rare Standard - 3 común + 2 poco común → Rara aleatoria (instantáneo)
3. Rare Advanced - 8 poco común → Rara aleatoria (instantáneo)
4. Epic Premium - 5 común + 4 poco común + 2 rara → Épica aleatoria (5 min)
5. Epic Supreme - 10 rara → Épica aleatoria (5 min)
6. Legendary Ultimate - 15 común + 10 poco común + 5 rara + 2 épica → Legendaria aleatoria (10 min)
7. Legendary Perfect - 25 común + 15 poco común + 8 rara + 3 épica → Legendaria a elegir (10 min)

Ver Crafts en Progreso

/drops crafts

Lista todos tus crafts activos con tiempo restante y estado.

Reclamar Crafts Completados

/drops reclamar-crafts

Reclama automáticamente todos los crafts que hayan terminado y agrega los drops a tu inventario.

---

👑 Comandos de Administración

Lanzar Drop Manual

/drops spawn [tipo] [canal]

Lanza un drop específico en un canal determinado (solo admins con permiso "Gestionar Servidor").

Configurar Sistema

/drops config [activar:true/false] [canal:#canal]

Configura el sistema de drops automáticos y el canal donde aparecerán.

---

🎯 Raridades de Drops

Rareza	Color	Peso Base	Recompensa Base
Común	Gris	45%	500-1,000 yumes
Poco Común	Verde	30%	1,500-3,000 yumes
Rara	Azul	15%	5,000-8,000 yumes
Épica	Púrpura	8%	10,000-15,000 yumes
Legendaria	Dorada	2%	25,000-50,000 yumes

Balanceo Dinámico

Las probabilidades se ajustan automáticamente cada 6 horas según la actividad del servidor:

• Alta actividad (más de 80% claim rate, más de 10 usuarios): Modifier 1.3x (más drops raros)
• Actividad normal (30-80%): Modifier 1.0x (probabilidades base)
• Baja actividad (menos de 30%): Modifier 0.7x (más drops comunes para incentivar)

---

📈 Sistema de Leaderboards

Los leaderboards están integrados con el Battle Pass y sistema de Rankings Avanzados.

Categorías de Ranking

1. Total Claims - Drops totales reclamados
2. Yumes Earned - Yumes ganados mediante drops
3. Best Streak - Mejor racha de días consecutivos
4. Fastest Claims - Claims más rápidos (menos de 5 segundos)
5. Legendary Drops - Drops legendarios reclamados

Marcos de Tiempo

• Diario (últimas 24 horas)
• Semanal (últimos 7 días)
• Mensual (últimos 30 días)
• Todo el tiempo

---

🏆 Sistema de Logros

El sistema de drops incluye 40+ logros integrados en el sistema de Rankings Avanzados.

Ejemplos de Logros

Logro	Descripción	Rareza	Recompensa
🎁 Primer Drop	Reclama tu primer drop	Común	500 yumes + 50 XP
🎁 Recolector	10 drops reclamados	Común	1,000 yumes + 100 XP
⭐ Primera Legendaria	Reclama tu primera legendaria	Rara	15,000 yumes + 1,500 XP
🔥 Racha de 7	7 días seguidos reclamando	Poco Común	5,000 yumes + 500 XP
🔥 Racha Divina	100 días de racha	Mítica	300,000 yumes + 30,000 XP
🎁 Dios del Drop	1,000 drops reclamados	Legendaria	250,000 yumes + 25,000 XP

---

✨ Sistema de Crafting

El sistema de crafting permite a cada usuario combinar sus fragmentos para crear drops más valiosos.

Sistema para Usuarios

El crafting es un sistema completamente para usuarios. Cada usuario tiene su propio inventario de fragmentos, puede craftear drops usando comandos de Discord (/drops craftear), y gestionar sus crafts personalmente. Los administradores no gestionan el crafting de otros usuarios.

Cómo Obtener Fragmentos

Los fragmentos se obtienen automáticamente al reclamar drops, con probabilidad basada en la rareza del drop reclamado.

Inventario de Crafting

Tu inventario incluye:

• Fragmentos por rareza (común, poco común, rara, épica, legendaria)
• Drops crafteados - Historial de crafteos exitosos
• Crafts pendientes - Crafteos en progreso con tiempo restante

Desbloqueo de Recetas

Las recetas se desbloquean según el nivel de drops reclamados:

• Nivel 1: Recetas básicas (común → poco común)
• Nivel 5-10: Recetas raras
• Nivel 20: Recetas épicas
• Nivel 30: Recetas legendarias

---

🔄 Sistema de Trading & Marketplace

Intercambia o vende drops crafteados con otros usuarios.

Marketplace Público

Crear listing:

• Los usuarios pueden listar sus drops crafteados en venta
• Se establece un precio en yumes
• El drop queda marcado como "en venta"
• Solo puedes vender drops que tú mismo hayas crafteado

Comprar listing:

• Cualquier usuario puede comprar drops listados por otros usuarios
• Se verifica el balance de yumes del comprador
• La transacción es instantánea y segura
• El vendedor recibe los yumes automáticamente

Trading P2P (Peer-to-Peer)

Crear oferta de trade:

• Ofrece uno o más drops crafteados
• Solicita uno o más drops específicos a cambio
• La oferta expira en 24 horas

Responder a trade:

• Acepta o rechaza ofertas de trade
• El intercambio es atómico (ambas partes intercambian simultáneamente)
• Protección anti-scam (verificación de inventarios)

Historial de Transacciones

Todas las transacciones quedan registradas:

• Compras en marketplace
• Trades completados
• Precios históricos
• Estadísticas de mercado

---

🎨 Sistema de Personalización

Personaliza la apariencia de los drops con temas y skins.

Temas (Guild-wide)

Los administradores pueden establecer un tema global para el servidor:

1. Default - Tema por defecto (gratis)
2. Dark Neon - Neones en la oscuridad (25,000 yumes)
3. Neon Cyberpunk - Estilo cyberpunk futurista (100,000 yumes)
4. Sakura Blossom - Flores de cerezo japonesas (logro: 500 drops)
5. Ocean Deep - Profundidades marinas (75,000 yumes)
6. Forest Magic - Bosque encantado (logro: 25 legendarias)
7. Galaxy Space - Espacio galáctico (150,000 yumes)
8. Fire & Ice - Fuego y hielo (logro: racha de 30 días)

Skins Personales

Los usuarios pueden aplicar efectos visuales a sus drops:

1. None - Sin skin (gratis)
2. Sparkles - Partículas brillantes (25,000 yumes)
3. Rainbow - Efecto arcoíris animado (50,000 yumes)
4. Shadow - Sombras dramáticas (logro: 100 drops)
5. Golden Aura - Aura dorada resplandeciente (logro: 10 legendarias)
6. Legendary Aura - Aura legendaria + partículas (logro: 25 legendarias)

Métodos de Desbloqueo

• Default: Gratis, disponible para todos
• Purchase: Comprar con yumes ganados
• Achievement: Desbloquear completando logros específicos

---

🎯 Sistema de Misiones

Completa misiones diarias y semanales para ganar recompensas extra.

Tipos de Misiones

Diarias (se resetean cada 24 horas):

• Reclama 3 drops (recompensa: 2,000 yumes)
• Reclama 1 drop raro o superior (recompensa: 3,000 yumes)
• Reclama un drop en menos de 5 segundos (recompensa: 5,000 yumes)
• Craftea 1 drop (recompensa: 4,000 yumes)

Semanales (se resetean cada lunes):

• Reclama 20 drops (recompensa: 15,000 yumes + 1,500 XP)
• Mantén una racha de 7 días (recompensa: 25,000 yumes + 2,500 XP)
• Reclama 5 drops épicos o legendarios (recompensa: 30,000 yumes + 3,000 XP)
• Completa 5 crafts (recompensa: 20,000 yumes + 2,000 XP)
• Participa en un evento temático (recompensa: 10,000 yumes + 1,000 XP)

Progreso de Misiones

El progreso se muestra en tiempo real en el panel web con:

• Barra de progreso visual
• Contador de completados vs totales
• Tiempo restante para el reset
• Botón de reclamar recompensa cuando está completo

---

🎪 Eventos Temáticos

Los administradores pueden activar eventos especiales con drops exclusivos.

Tipos de Eventos

1. Double Rewards (Doble Recompensa)

   • Todas las recompensas de drops se duplican
   • Duración configurable (1h - 24h)
   • Ideal para celebraciones

2. Legendary Rush (Rush Legendario)

   • Aumenta 5x la probabilidad de drops legendarios
   • Duración configurable
   • Evento de alto valor

3. Fragment Frenzy (Frenesí de Fragmentos)

   • 100% de probabilidad de obtener fragmentos
   • Doble cantidad de fragmentos
   • Ideal para crafteo masivo

4. Speed Challenge (Desafío de Velocidad)

   • Bonus extra por reclamar en menos de 3 segundos
   • Spawn rate aumentado
   • Competitivo

5. Rare Parade (Desfile de Raros)

   • Solo drops raros, épicos y legendarios
   • Sin drops comunes
   • Evento premium

Drops Exclusivos de Eventos

Durante eventos, pueden aparecer drops especiales únicos:

• ⭐ Event Star - Solo durante eventos
• 🎉 Party Gift - Celebraciones especiales
• 🌟 Cosmic Drop - Eventos espaciales
• 🔥 Flame Burst - Eventos de fuego

Historial de Eventos

El panel web muestra:

• Eventos activos con tiempo restante
• Historial de eventos pasados
• Estadísticas de cada evento (drops spawneados, claims totales)
• Próximos eventos programados

---

📊 Analytics & Predictions IA

Sistema avanzado de análisis y predicciones personalizadas.

Analytics Generales

Análisis Temporal:

• Actividad por hora del día (gráfico de 24h)
• Actividad por día de la semana
• Identificación de las 3 horas pico
• Mejores días de la semana

Estadísticas por Rareza:

• Total de drops por rareza
• Claims totales y tasa de claim
• Drops no reclamados (perdidos)
• Promedio de yumes ganados

Tendencias (30 vs 60 días):

• Cambio porcentual en drops spawneados
• Cambio en claims
• Cambio en usuarios activos
• Tendencia de yumes distribuidos

Insights Automáticos con IA:

• Detección de patrones significativos
• Recomendaciones de configuración
• Alertas de baja actividad
• Sugerencias de eventos

Predicciones Personalizadas

Perfil de Usuario:

• Total de claims histórico
• Tasa de éxito (%)
• Racha actual y mejor racha
• Velocidad promedio de claim

Predicciones:

• Próximo drop estimado (tiempo y rareza probable)
• Hora óptima de spawn para el usuario
• Rareza favorita del usuario
• Velocidad promedio de claim

Proyecciones:

• Ganancias estimadas diarias
• Ganancias estimadas semanales
• Ganancias estimadas mensuales

Recomendaciones Personalizadas:

• Mejores horas para estar activo
• Estrategias de crafteo sugeridas
• Misiones prioritarias
• Tips para mejorar tasa de claim

---

🎮 Sistema de Rachas (Streaks)

Las rachas recompensan la constancia diaria.

Cómo Funcionan las Rachas

• Reclama al menos 1 drop cada día para mantener la racha
• Si no reclamas durante 24 horas, la racha se reinicia
• Las rachas se guardan en tu historial

Bonificaciones por Racha

Racha	Bonus
3 días	+5% yumes en todos los drops
7 días	+10% yumes + logro desbloqueado
14 días	+15% yumes
30 días	+25% yumes + skin especial
50 días	+35% yumes
100 días	+50% yumes + logro mítico

---

🔔 Sistema de Notificaciones

Mantente informado de todos los eventos importantes.

Tipos de Notificaciones

1. Drop Spawn - Nuevo drop aparecido (ping @everyone o rol específico)
2. Legendary Drop - Drop legendario aparecido (ping especial)
3. Event Start - Evento temático iniciado
4. Event End - Evento terminado
5. Craft Complete - Tu craft ha terminado
6. Quest Complete - Misión completada
7. Achievement Unlocked - Nuevo logro desbloqueado
8. Streak Milestone - Hito de racha alcanzado

Configuración

Los administradores pueden configurar en el panel:

• Activar/desactivar cada tipo de notificación
• Elegir rol a mencionar (@everyone, @aquí, rol personalizado)
• Configurar cooldown entre notificaciones
• Establecer formato de mensaje

---

🌐 Panel Web

El sistema incluye un completo panel de administración web con 10 pestañas.

Pestañas Disponibles

Todas las pestañas (para Administradores):

1. Overview - Resumen general y estadísticas del servidor
2. Types - CRUD completo de tipos de drops personalizados
3. History - Historial completo con búsqueda y filtros
4. Leaderboards - Rankings con filtros temporales
5. Quests - Gestión de misiones diarias/semanales
6. Events - Activar y gestionar eventos temáticos (premium)
7. Analytics - Analytics avanzados con predicciones IA (premium)
8. Crafting Stats - Estadísticas globales del uso de crafting en el servidor (premium)
9. Scheduled - Programar drops automáticos (premium)
10. Config - Configuración general del sistema

Crafting Stats - Vista para Administradores

La pestaña Crafting Stats muestra estadísticas globales del servidor sobre el uso del sistema de crafting:

• Total de crafts completados y en progreso
• Fragmentos en circulación por rareza
• Distribución de crafts por rareza
• Recetas más populares
• Top 10 crafters del servidor

Los usuarios gestionan su crafting mediante comandos de Discord (/drops craftear). Los administradores solo ven estadísticas agregadas, no pueden gestionar el crafting de otros usuarios.

Características del Panel

• Actualización en tiempo real vía WebSocket
• Responsive - Funciona en móvil, tablet y desktop
• Scroll horizontal en pestañas para móviles
• Gráficos interactivos con Recharts
• Búsqueda y filtros avanzados
• Modo premium con características exclusivas

---

⚙️ Configuración Técnica

Configuración en el Panel

Sistema Habilitado:

• Activar/desactivar el sistema completo

Auto-drops:

• Activar spawns automáticos
• Intervalo entre drops (5-60 minutos)
• Canal para drops automáticos

Duración de Drops:

• Tiempo antes de expirar (30-300 segundos)

Notificaciones:

• Configurar qué notificaciones enviar
• Rol a mencionar

Pesos de Rareza:

• Ajustar manualmente las probabilidades
• Ver pesos dinámicos actuales
• Forzar actualización de pesos

Datos Persistentes

Todos los datos se guardan en:

/var/www/yume-chan/bot/data/events-drops.json

Incluye:

• Configuración por guild
• Inventarios de usuarios
• Historial de drops
• Estadísticas
• Marketplace y trades
• Eventos activos

---

🚀 WebSocket Real-Time

El sistema utiliza WebSocket para actualizaciones instantáneas sin necesidad de refrescar.

Eventos WebSocket

• dropSpawned - Nuevo drop apareció
• dropClaimed - Drop reclamado
• dropExpired - Drop expiró sin reclamar
• eventStarted - Evento iniciado
• eventEnded - Evento terminado
• craftCompleted - Craft completado
• questCompleted - Misión completada
• achievementUnlocked - Logro desbloqueado

Invalidación Automática de Queries

React Query se invalida automáticamente al recibir eventos, manteniendo la UI sincronizada.

---

📝 Ejemplos de Uso

Escenario 1: Usuario Reclamando Drop

1. Drop aparece en el canal configurado
2. Usuario ve el embed con botón "Reclamar"
3. Usuario hace click en menos de 5 segundos
4. Recibe yumes + posible fragmento + logro "Claim Rápido"
5. Se actualiza su racha diaria
6. Progresa misiones activas

Escenario 2: Crafteo Legendario

1. Usuario acumula fragmentos reclamando drops durante semanas
2. Desbloquea receta "Legendary Perfect" (nivel 30)
3. Usa /drops craftear craft_legendary_perfect
4. Espera 10 minutos o ve progreso en el panel
5. Usa /drops reclamar-crafts
6. Elige drop legendario específico que desea
7. Drop agregado a inventario para usar o vender

Escenario 3: Evento Temático

1. Admin activa evento "Legendary Rush" por 3 horas
2. Se notifica a todos los usuarios con ping
3. Probabilidad de legendarias aumenta 5x
4. Usuarios activamente reclaman drops durante el evento
5. Se genera historial y estadísticas del evento
6. Misión semanal "participar en evento" se completa automáticamente

---

💡 Tips y Estrategias

Para Usuarios

• Mantén tu racha: Reclama al menos 1 drop diario para bonus acumulativo
• Craftea estratégicamente: Guarda fragmentos épicos para recetas legendarias
• Estate activo en eventos: Los eventos temáticos dan recompensas masivas
• Completa misiones: Las misiones dan XP adicional para rankings
• Reclama rápido: Claims en menos de 5 segundos dan logros especiales

Para Administradores

• Configura auto-drops: Mantén el servidor activo con spawns regulares
• Activa eventos regulares: Eventos incrementan engagement
• Revisa analytics: Usa predicciones IA para optimizar configuración
• Ajusta raridades: Si hay mucha o poca actividad, ajusta pesos
• Crea drops personalizados: Drops temáticos únicos para tu servidor

---

🔗 Integraciones

Battle Pass

• XP de logros de drops cuenta para el Battle Pass
• Misiones de drops integradas en tracks del Battle Pass
• Recompensas premium para usuarios con Battle Pass

Rankings Avanzados

• 40+ logros de drops integrados
• Leaderboards sincronizados
• Tracking automático de claims en /ranking

Sistema de Economía

• Yumes ganados se sincronizan con economía global
• Crafting usa balance de yumes del usuario
• Marketplace integrado con sistema bancario

---

❓ Preguntas Frecuentes

¿Puedo perder mi racha si no reclamo drops? Sí, debes reclamar al menos 1 drop cada 24 horas para mantener tu racha activa.

¿Los fragmentos se pierden al craftear? Sí, los fragmentos se consumen al usar una receta, pero obtienes un drop de mayor rareza.

¿Puedo vender drops que reclamé? Solo puedes vender drops que hayas crafteado tú mismo, no drops reclamados directamente.

¿Cómo desbloqueo recetas legendarias? Debes reclamar 30+ drops para alcanzar el nivel requerido y desbloquear las recetas legendarias.

¿Los eventos temáticos son permanentes? No, los eventos tienen duración limitada (1-24 horas) configurada por los administradores.

¿Qué pasa si dos usuarios clickean al mismo tiempo? El primero en clickear (según timestamp del servidor) reclama el drop.

¿Los pesos dinámicos afectan a eventos? No, durante eventos temáticos se usan probabilidades especiales del evento.

---

🎉 ¡Comienza Ahora!

1. Activa el sistema en el panel web
2. Configura auto-drops para mantener actividad
3. Personaliza tipos de drops para tu servidor
4. Anuncia el sistema a tus usuarios
5. Lanza tu primer evento temático

Panel Web: https://panel.yumechanbot.com/drops

¡Disfruta del sistema de drops más completo de Discord! 🎁✨