> For the complete documentation index, see [llms.txt](https://gubo.gitbook.io/gubo-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gubo.gitbook.io/gubo-docs/comunidad/goodbye.md).

# Goodbye Plugin

El plugin Goodbye permite despedir automáticamente a los miembros cuando abandonan tu servidor de Discord. Ofrece opciones de personalización que incluyen mensajes personalizados, embeds elegantes e imágenes de despedida.

***

## 📑 Contenido

* [Características Principales](#caracteristicas-principales)
* [Configuración](#configuracion)
* [Variables Dinámicas](#variables-dinamicas)
* [Ejemplos de Configuración](#ejemplos-de-configuracion)
* [Plantilla por Defecto](#plantilla-por-defecto)
* [Casos de Uso Comunes](#casos-de-uso-comunes)
* [Mejores Prácticas](#mejores-practicas)
* [Notas Técnicas](#notas-tecnicas)
* [Solución de Problemas](#solucion-de-problemas)

***

## 📑 Características Principales

### Plan Free

* ✅ Mensajes de texto básicos de despedida
* ✅ Variables dinámicas (`{{user}}`, `{{guild}}`)
* ✅ Configuración de canal personalizado

### Plan Premium 💎

* ✅ **Embeds personalizados** con colores configurables
* ✅ **Imágenes de despedida** personalizadas
* ✅ Diseño visual mejorado
* ✅ Mayor flexibilidad en la presentación

***

## ⚙️ Configuración

### Acceder a la Configuración

1. Ve al **Dashboard** en <https://gubo.com.ar>
2. Selecciona tu servidor
3. Ve a la sección **Plugins**
4. Haz clic en **Goodbye Plugin**

### Opciones Disponibles

#### Configuración Básica

| Opción                  | Descripción                          | Plan         | Predeterminado         |
| ----------------------- | ------------------------------------ | ------------ | ---------------------- |
| **Plugin Activado**     | Habilita o deshabilita el plugin     | Free/Premium | Desactivado            |
| **Canal de Despedidas** | Canal donde se enviarán los mensajes | Free/Premium | Ninguno                |
| **Mensaje**             | Texto personalizado de despedida     | Free/Premium | Mensaje predeterminado |

#### Configuración Visual

| Opción              | Descripción                            | Plan         |
| ------------------- | -------------------------------------- | ------------ |
| **Usar Embed**      | Formato elegante con color             | 💎 Premium   |
| **Color del Embed** | Color en formato hexadecimal (#ff0000) | 💎 Premium   |
| **Imagen**          | URL de imagen para el mensaje          | Free/Premium |

***

## 📑 Variables Dinámicas

Personaliza tus mensajes con estas variables que se reemplazan automáticamente:

| Variable    | Descripción                   | Ejemplo de Salida |
| ----------- | ----------------------------- | ----------------- |
| `{{user}}`  | Mención del usuario que se va | `@Usuario#1234`   |
| `{{guild}}` | Nombre del servidor           | `Mi Servidor`     |

### Ejemplo de Uso

```
Mensaje: "Adiós {{user}}, gracias por estar en {{guild}}. ¡Te extrañaremos!"
Resultado: "Adiós @Juan#1234, gracias por estar en Mi Servidor. ¡Te extrañaremos!"
```

***

## 📝 Ejemplos de Configuración

### 1️⃣ Configuración Básica (Free)

**Para:** Servidor simple que quiere despedir a los miembros

**Pasos en el Dashboard:**

1. Activa el plugin Goodbye
2. Selecciona el canal: `#despedidas`
3. Escribe tu mensaje: `Adiós {{user}}, gracias por ser parte de {{guild}}. ¡Te extrañaremos! 👋`

**Resultado:** Mensaje simple de texto cuando alguien abandona el servidor

***

### 2️⃣ Configuración con Imagen (Free)

**Para:** Servidor que quiere una despedida visual

**Pasos en el Dashboard:**

1. Activa el plugin Goodbye
2. Selecciona el canal: `#log-miembros`
3. Escribe tu mensaje: `{{user}} ha abandonado {{guild}}. Esperamos verte de nuevo pronto.`
4. Añade la URL de tu imagen en "Imagen"

**Resultado:** Mensaje con imagen adjunta

***

### 3️⃣ Configuración Premium con Embed (💎 Premium)

**Para:** Servidor que quiere despedidas elegantes

**Pasos en el Dashboard:**

1. Activa el plugin Goodbye
2. Activa "Usar Embed"
3. Elige color: Rojo (#ff0000)
4. Escribe tu mensaje: `**{{user}}** nos ha dejado. Gracias por tu tiempo en **{{guild}}**.`
5. Añade una imagen de fondo (URL)

**Resultado:** Embed rojo con imagen y mensaje formateado

***

### 4️⃣ Configuración Premium Completa (💎 Premium)

**Para:** Servidor premium con despedida profesional

**Pasos en el Dashboard:**

1. Activa el plugin Goodbye
2. Activa "Usar Embed"
3. Elige color: Morado (#8b00ff)
4. Escribe tu mensaje: `💔 **{{user}}** ha salido del servidor. ¡Adiós!`
5. Añade un GIF animado en "Imagen"

**Resultado:** Embed morado con GIF animado y mensaje con formato markdown

***

## 💡 Casos de Uso Comunes

### 1. Servidor de Comunidad General

**Objetivo:** Despedida amigable y acogedora

**Configuración sugerida:**

* **Canal:** `#despedidas`
* **Mensaje:** `Adiós {{user}}, gracias por ser parte de {{guild}}. ¡Siempre serás bienvenido de vuelta! 👋`
* **Embed:** No (Free) o Azul suave `#0099ff` (Premium)
* **Imagen:** Imagen de despedida amigable

***

### 2. Servidor de Gaming 🎮

**Objetivo:** Despedida temática gaming

**Configuración sugerida:**

* **Canal:** `#general` o `#log`
* **Mensaje:** `GG {{user}}! Nos vemos en el campo de batalla. 🎮`
* **Embed:** Naranja `#ff4500` (💎 Premium)
* **Imagen:** GIF de tu juego favorito

***

### 3. Servidor Educativo 📚

**Objetivo:** Despedida profesional

**Configuración sugerida:**

* **Canal:** `#avisos`
* **Mensaje:** `{{user}} ha abandonado {{guild}}. Les deseamos éxito en su camino. 🎓`
* **Embed:** Azul marino `#1e3a8a` (💎 Premium)
* **Imagen:** Logo institucional

***

### 4. Servidor de Soporte Técnico 🛡️

**Objetivo:** Mensaje simple y directo

**Configuración sugerida:**

* **Canal:** `#logs`
* **Mensaje:** `{{user}} ha salido del servidor de soporte.`
* **Embed:** Gris `#4b5563` (💎 Premium)
* **Imagen:** Ninguna (mensaje limpio)

***

## ✅ Mejores Prácticas

### 1. Elección del Canal

* ✅ Usa un canal dedicado para despedidas (ej: `#despedidas`, `#log-miembros`)
* ✅ Evita canales de alta actividad para no saturar
* ✅ Considera usar el mismo canal que para bienvenidas si tiene sentido

### 2. Diseño de Mensajes

* ✅ Mantén los mensajes breves y respetuosos
* ✅ Evita mensajes negativos o sarcásticos
* ✅ Usa emojis con moderación para dar tono amigable
* ✅ Considera el tono de tu comunidad

### 3. Uso de Embeds (Premium) 🔥

* ✅ Elige colores que contrasten con los de bienvenida
* ✅ Colores recomendados para despedidas:
* ❤️ Rojo: `#ff0000` (tradicional)
* 🧡 Naranja: `#ff4500` (cálido)
* 💜 Morado: `#8b00ff` (neutral)
* 💙 Azul oscuro: `#0066cc` (profesional)

### 4. Imágenes

* ✅ Usa URLs de imágenes confiables y permanentes (CDN recomendado)
* ✅ Tamaño recomendado: 1920x1080 o 1280x720
* ✅ Formatos soportados: PNG, JPG, GIF
* ✅ Mantén el tamaño de archivo bajo (<5MB recomendado)

### 5. Privacidad

* ✅ **El plugin no envía despedidas a bots** - Esto se maneja automáticamente
* ✅ Respeta la privacidad del usuario (evita información sensible)
* ✅ Mantén un tono respetuoso en tus mensajes

***

## 🛡️ Solución de Problemas

### ❌ No se envían mensajes de despedida

**Posibles causas y soluciones:**

1. **Plugin deshabilitado**

* ✅ Verifica que el plugin esté activado en el Dashboard
* ✅ Asegúrate de haber guardado los cambios

2. **Canal no configurado**

* ✅ Selecciona un canal válido en la configuración
* ✅ Puedes copiar el ID del canal con el modo desarrollador de Discord activado

3. **Permisos insuficientes**

* ✅ El bot necesita permisos de `Ver Canal` y `Enviar Mensajes`
* ✅ Revisa los permisos del rol del bot en la configuración del servidor
* ✅ Verifica los permisos específicos del canal de despedidas

4. **Canal eliminado**

* ✅ Si eliminaste el canal, selecciona uno nuevo en la configuración
* ✅ Guarda los cambios después de seleccionar el nuevo canal

***

### ❌ No se muestra el embed (Premium)

**Posibles causas:**

1. **Plan no Premium**

* ✅ Los embeds solo están disponibles en el plan Premium 💎
* ✅ Verifica tu plan actual en el Dashboard

2. **Embed desactivado**

* ✅ Activa la opción "Usar Embed" en el Dashboard
* ✅ Guarda los cambios después de activarla

3. **Color inválido**

* ✅ Usa formato hexadecimal válido: `#ff0000`
* ✅ Formatos aceptados: `#RGB` o `#RRGGBB`
* ✅ Puedes usar un selector de color online para obtener códigos válidos

***

### ❌ La imagen no se muestra

**Posibles causas:**

1. **URL inválida**

* ✅ Verifica que la URL sea accesible públicamente
* ✅ Prueba la URL en tu navegador

2. **URL bloqueada**

* ✅ Usa CDNs confiables (Discord CDN, Imgur, etc.)
* ✅ Evita URLs con autenticación requerida

3. **Formato no soportado**

* ✅ Usa PNG, JPG o GIF
* ✅ Evita formatos exóticos (WEBP puede tener problemas)

***

### ❌ Se despiden bots

**Solución:**

* ✅ Esto **no debería ocurrir** - El plugin filtra bots automáticamente
* ✅ Si esto sucede, por favor contacta al soporte técnico con detalles del problema

***

### 📑 Mensaje aparece genérico (en inglés)

**Solución:**

* ✅ Personaliza tu mensaje en el Dashboard escribiéndolo en español
* ✅ Si no configuras un mensaje personalizado, se usa la plantilla predeterminada en inglés
* ✅ Recuerda guardar los cambios después de editar tu mensaje

***

## 📑 Comparativa Plan Free vs Premium

| Característica             | Free | Premium 💎 |
| -------------------------- | ---- | ---------- |
| Mensajes de texto          | ✅    | ✅          |
| Variables dinámicas        | ✅    | ✅          |
| Canal personalizado        | ✅    | ✅          |
| Imágenes                   | ✅    | ✅          |
| **Embeds personalizados**  | ❌    | ✅          |
| **Color personalizado**    | ❌    | ✅          |
| **Diseño visual mejorado** | ❌    | ✅          |

***

## 📑 Paleta de Colores Recomendada

```
Despedidas Formales:
- Azul Marino:    #1e3a8a
- Gris Oscuro:    #4b5563

Despedidas Cálidas:
- Naranja:        #ff4500
- Rojo Suave:     #dc2626

Despedidas Neutras:
- Morado:         #8b00ff
- Azul:           #0099ff

Despedidas Elegantes:
- Negro:    #000000
- Gris Plata:     #94a3b8
```

***

## 📑 Soporte

Si tienes problemas con el plugin Goodbye:

1. ✅ Revisa esta guía completa
2. ✅ Consulta la sección de [Solución de Problemas](#solucion-de-problemas)
3. ✅ Verifica los permisos del bot en tu servidor
4. ✅ Contacta al soporte técnico de GUBO

***

**Última actualización:** Enero 2026

**Versión de la guía:** 1.0.0

***