Sistema de Bienvenida

🛬 Sistema de Bienvenida

Sistema completo de bienvenida para nuevos miembros, similar a bots populares como Welcomer y Koya.

✨ Características Principales

📋 Panel de Configuración Intuitivo

Interfaz visual con menús desplegables
Configuración paso a paso
Vista previa del estado actual
Función de prueba integrada

🎨 Personalización Avanzada

Variables Dinámicas

El sistema soporta las siguientes variables en los mensajes:

{user} o {user.mention} - Menciona al usuario (@usuario)
{user.tag} - Nombre completo del usuario (Nombre#1234)
{user.username} - Solo el nombre de usuario
{user.id} - ID único del usuario
{server} o {server.name} - Nombre del servidor
{memberCount} - Número total de miembros

Ejemplos de Mensajes

¡Bienvenido {user} a **{server}**!
Eres el miembro #{memberCount}. ¡Esperamos que disfrutes tu estadía!

🖼️ Imágenes de Bienvenida

Soporte para imágenes personalizadas por URL
Embeds con información del usuario
Diseño moderno y responsivo

🌍 Soporte Multiidioma

Completamente traducido en español e inglés
Todas las interfaces y mensajes soportan i18n
Detección automática del idioma del servidor

🚀 Uso

Configuración Inicial

Ejecutar el comando de configuración:
```
/welcome-setup
```
Configurar el canal:
- Selecciona “Establecer Canal” del menú
- Elige el canal donde se enviarán las bienvenidas
Personalizar el mensaje:
- Selecciona “Configurar Mensaje”
- Usa las variables disponibles para personalizar
- Ejemplo: ¡Hola {user}! Bienvenido a {server}
Habilitar el sistema:
- Selecciona “Alternar Sistema”
- El sistema se activará para nuevos miembros

Configuración Opcional

Configurar Imagen

Selecciona “Configurar Imagen”
Proporciona una URL de imagen válida
La imagen aparecerá en el embed de bienvenida

Probar la Configuración

Usa “Probar Bienvenida” para enviar un mensaje de prueba
Verifica que todo funcione antes de activar el sistema

🔧 Configuración Avanzada

Panel de Estado

El panel principal muestra:

Canal Actual: Dónde se envían los mensajes
Mensaje Actual: Vista previa del mensaje personalizado
Imagen de Bienvenida: URL de la imagen configurada
Estado del Sistema: Si está habilitado o deshabilitado

Opciones del Menú

📢 Establecer Canal - Configurar canal de bienvenida
💬 Configurar Mensaje - Personalizar mensaje con variables
🖼️ Configurar Imagen - Establecer imagen personalizada
🧪 Probar Bienvenida - Enviar mensaje de prueba
🔄 Alternar Sistema - Habilitar/deshabilitar todo el sistema

🎨 Personalización de Mensajes

Plantillas Recomendadas

Servidor de Gaming

🎮 ¡{user} se unió a la aventura!

¡Bienvenido a **{server}**! Eres el aventurero #{memberCount}.

🏆 Revisa #reglas para comenzar
🎪 Únete a #general para socializar
🎯 ¡Que comience la diversión!

Servidor de Programación

💻 ¡Nuevo desarrollador detectado!

¡Hola {user}! Bienvenido a **{server}** 👋

📚 Revisa #recursos para materiales de estudio
💬 Pregunta en #ayuda si necesitas soporte
🚀 ¡Happy coding!

Miembro #{memberCount} | {server}

Servidor de Comunidad

🌟 ¡{user} acaba de llegar!

¡Te damos la bienvenida a **{server}**! 🎉

👋 Preséntate en #presentaciones
📋 Lee nuestras #reglas
🎪 ¡Diviértete con la comunidad!

Eres nuestro miembro #{memberCount} ❤️

📊 Base de Datos

La configuración se guarda en la base de datos del servidor:

{
  "welcome": {
    "enabled": true,
    "channel_id": "123456789",
    "message": "¡Bienvenido {user} a {server}!",
    "image_url": "https://ejemplo.com/imagen.png"
  }
}

🔍 Troubleshooting

Problemas Comunes

Canal no encontrado

Síntoma: “El canal configurado no fue encontrado”
Solución: Reconfigurar el canal en /welcome-setup

Permisos insuficientes

Síntoma: El bot no puede enviar mensajes
Solución: Verificar que el bot tenga permisos de “Enviar Mensajes” en el canal

Variables no funcionan

Síntoma: Las variables aparecen como texto literal
Solución: Verificar la sintaxis exacta: {user}, {server}, etc.

Logs y Debugging

El sistema registra eventos importantes:

Nuevos miembros que se unen
Errores en el envío de mensajes
Problemas de configuración

🎯 Mejores Prácticas

Diseño de Mensajes

Mantén los mensajes concisos pero informativos
Usa emojis para hacer el mensaje más atractivo
Incluye información útil como canales importantes
Personaliza según el tema de tu servidor

Configuración del Canal

Usa un canal dedicado para bienvenidas
Configura permisos para que solo el bot pueda enviar mensajes
Considera el flujo de usuarios nuevos en tu servidor

Testing

Siempre prueba antes de activar el sistema
Verifica que las variables funcionen correctamente
Comprueba que la imagen se muestre si está configurada

🔮 Funcionalidades Futuras

Mensajes de despedida personalizables
Roles automáticos para nuevos miembros
Múltiples plantillas de mensajes
Estadísticas de bienvenidas
Integración con sistema de verificación

El sistema de bienvenida está completamente integrado con el resto del bot y es 100% compatible con el sistema de tickets, moderación y configuración existente.