Estadisticas

Sistema completo de estadisticas del servidor similar a Statbot, pero 100% integrado en Yume-chan.

Funcionalidades

Feature	Descripcion
Message Tracking	Cuenta mensajes por usuario, canal, hora, dia, semana, mes
Voice Tracking	Tiempo en canales de voz con sesiones detalladas
Presence Tracking	Estado online/idle/dnd/offline por usuario
Game Tracking	Juegos que juegan los usuarios
Statdocks	Canales de voz con contadores en tiempo real
Statroles	Roles automaticos basados en actividad
Leaderboards	Rankings por mensajes, voz, actividad
Historial	Datos historicos para graficos

---

Comandos Basicos

Ver Estadisticas del Servidor

/stats server

Muestra un resumen de estadisticas del servidor:

• Mensajes totales y de hoy
• Tiempo total en voz
• Miembros trackeados
• Estado del sistema

Ver Estadisticas de Usuario

/stats user [@usuario]

Muestra estadisticas detalladas de un usuario:

• Mensajes (total, hoy, semana, mes)
• Tiempo en voz (total, hoy, semana, mes)
• Hora pico de actividad
• Top juegos jugados
• Ultima actividad

Ver Estadisticas de Canal

/stats channel [#canal]

Muestra estadisticas de un canal especifico:

• Mensajes totales
• Hora pico de actividad
• Tiempo total de voz (si es canal de voz)

---

Statdocks (Contadores de Canal)

Los Statdocks son canales de voz que muestran estadisticas en su nombre. Los usuarios no pueden unirse a ellos.

Crear Categoria de Stats

/stats setup create

Crea una categoria con los contadores basicos:

📊 ESTADÍSTICAS
├── 👥 Miembros: 1,234
├── 🟢 Online: 456
├── 🎤 En Voz: 12
└── 💎 Boosts: 5

Añadir Contador

/stats setup add <tipo>

Tipos de contadores disponibles:

Tipo	Descripcion	Ejemplo
members	Total de miembros	👥 Miembros: 1,234
online	Miembros online	🟢 Online: 456
inVoice	En canales de voz	🎤 En Voz: 12
boosts	Server boosts	💎 Boosts: 5
roles	Total de roles	🏷️ Roles: 25
channels	Total de canales	📁 Canales: 50
bots	Bots en el servidor	🤖 Bots: 3
humans	Miembros humanos	👤 Humanos: 1,231
messagesToday	Mensajes de hoy	💬 Msgs Hoy: 789
voiceNow	Usuarios en voz ahora	🎙️ Voz Activa: 8

Quitar Contador

/stats setup remove <tipo>

Elimina un contador especifico.

Eliminar Todo

/stats setup delete

Elimina la categoria y todos los contadores.

Activar/Desactivar Tracking

/stats setup toggle <feature> <true/false>

Activa o desactiva tipos de tracking:

• messages - Tracking de mensajes
• voice - Tracking de voz
• presence - Tracking de presencia
• games - Tracking de juegos

---

Statroles

Los Statroles son roles que se asignan automaticamente cuando un usuario alcanza cierta cantidad de actividad.

Crear Statrole

/stats statroles add <@rol> <tipo> <cantidad> [periodo] [quitar]

Parametros:

• rol - Rol a asignar
• tipo - messages o voice (horas)
• cantidad - Cantidad requerida
• periodo - total, today, week, month (opcional, default: total)
• quitar - Quitar rol si ya no cumple (opcional, default: false)

Ejemplos:

/stats statroles add @Chatter messages 1000
/stats statroles add @VoiceActive voice 10 week true
/stats statroles add @TopMonthly messages 500 month true

Ver Statroles

/stats statroles list

Muestra todos los statroles configurados.

Eliminar Statrole

/stats statroles remove <@rol>

Elimina un statrole.

---

Leaderboards

Top Mensajes

/stats top messages [periodo]

Muestra los usuarios con mas mensajes.

Periodos:

• total - Desde siempre (default)
• today - Solo hoy
• week - Esta semana
• month - Este mes

Top Voz

/stats top voice [periodo]

Muestra los usuarios con mas tiempo en canales de voz.

Top Canales

/stats top channels [periodo]

Muestra los canales con mas actividad.

---

Resetear Estadisticas

/stats reset <tipo>

Resetea estadisticas (solo administradores).

Tipos:

• all - Todo (CUIDADO!)
• messages - Solo mensajes
• voice - Solo voz
• daily - Solo datos diarios

---

Panel de Servidor

Configura todo desde el Panel de Servidor:

Pestaña Resumen

• Estadisticas generales
• Contadores activos
• Statroles configurados
• Estado del tracking

Pestaña Leaderboards

• Top mensajes
• Top voz
• Filtro por periodo

Pestaña Statroles

• Crear statroles
• Ver statroles existentes
• Eliminar statroles

Pestaña Contadores

• Ver contadores activos
• Comandos disponibles

Pestaña Configuracion

• Activar/desactivar tracking
• Ver estado del sistema

---

Notas Tecnicas

• Los contadores se actualizan cada 5 minutos (limite de Discord)
• Los statroles se verifican cada hora
• Los datos diarios se resetean a medianoche
• Los datos semanales se resetean los lunes
• Los datos mensuales se resetean el dia 1
• Se guarda historial de los ultimos 90 dias

---

Comparacion con Statbot

Feature	Statbot	Yume-chan
Message Tracking	Si	Si
Voice Tracking	Si	Si
Presence Tracking	Si	Si
Game Tracking	Si	Si
Statdocks	Si	Si
Statroles	Si	Si
Leaderboards	Si	Si
Integracion Economia	No	SI
Panel Web	Pago	GRATIS
Sin Limites	Pago	GRATIS