> 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/guias/configuration.md).

# Configuración General

Esta guía te ayudará a configurar GUBO Bot en tu servidor de Discord de manera sencilla y rápida.

***

## 📑 Contenido

* [Requisitos Previos](#requisitos-previos)
* [Configuración Inicial](#configuracion-inicial)
* [Dashboard Web](#dashboard-web)
* [Gestión de Plugins](#gestion-de-plugins)
* [Configuración del Servidor](#configuracion-del-servidor)
* [Permisos del Bot](#permisos-del-bot)
* [Planes Free vs Premium](#planes-free-vs-premium)
* [Solución de Problemas](#solucion-de-problemas)

***

## ✅ Requisitos Previos

Antes de comenzar, asegúrate de tener:

* **Servidor de Discord**: Donde serás administrador
* **Permisos de Administrador**: Para invitar y configurar el bot
* **Navegador web**: Para acceder al dashboard de configuración
* **Cuenta de Discord**: Para autenticarte en el dashboard

***

## 🚀 Configuración Inicial

### Paso 1: Invitar el Bot

1. **Visita el enlace de invitación:**
   * [Invitar GUBO Bot](https://discord.com/oauth2/authorize?client_id=1427032926503174164\&scope=bot%20applications.commands\&permissions=1099780320374)
2. **Selecciona tu servidor:**
   * Elige el servidor donde quieres añadir el bot
   * Solo verás servidores donde eres administrador
3. **Autoriza los permisos:**
   * Revisa la lista de permisos necesarios
   * Haz clic en "Autorizar"
   * Completa la verificación de seguridad (captcha)
4. **Verifica que el bot esté online:**
   * El bot debe aparecer en la lista de miembros
   * Su estado debe ser **En línea** (círculo verde)

***

### Paso 2: Primer Comando

Prueba que el bot funcione correctamente:

```
/help
```

Si el comando funciona, verás un menú interactivo con todos los comandos disponibles.

***

## 🌐 Dashboard Web

El **Dashboard** es tu centro de control para configurar todos los aspectos del bot.

### Acceder al Dashboard

1. **Visita:** <https://gubo.com.ar>
2. **Inicia sesión** con tu cuenta de Discord
3. **Autoriza** el acceso cuando se te solicite
4. **Selecciona tu servidor** de la lista

### Secciones del Dashboard

#### 🏠 Vista General

* Estado actual del bot en tu servidor
* Resumen de plugins activos
* Estadísticas básicas (miembros, mensajes, etc.)
* Acceso rápido a configuraciones principales

#### 🧩 Plugins

* Lista de todos los plugins disponibles
* Activar/desactivar cada plugin
* Acceder a configuración detallada de cada uno
* Indicadores de Plan Free vs Premium

#### ⚙️ Configuración del Servidor

* Idioma del bot en tu servidor
* Prefijos personalizados (si aplica)
* Zona horaria
* Configuraciones globales

#### 💎 Plan y Suscripción

* Ver tu plan actual (Free o Premium)
* Mejorar a Premium
* Gestionar tu suscripción
* Ver fechas de renovación

***

## 🧩 Gestión de Plugins

### ¿Qué son los Plugins?

Los plugins son módulos funcionales que añaden características específicas al bot. Puedes activar solo los que necesites.

### Plugins Disponibles

| Plugin                | Descripción                               | Plan         |
| --------------------- | ----------------------------------------- | ------------ |
| **👋 Welcome**        | Mensajes de bienvenida a nuevos miembros  | Free/Premium |
| **👋 Goodbye**        | Mensajes de despedida                     | Free/Premium |
| **🛡️ Moderation**    | Sistema de moderación automática y manual | Free/Premium |
| **🎫 Tickets**        | Sistema de soporte con tickets            | Free/Premium |
| **💰 Economy**        | Sistema de economía con tienda            | 💎 Premium   |
| **💸 Donations**      | Integración de donaciones con recompensas | 💎 Premium   |
| **🎭 Reaction Roles** | Roles por reacciones de emoji             | Free/Premium |

### Activar un Plugin

1. Ve a la sección **Plugins** en el dashboard
2. Encuentra el plugin que deseas activar
3. Haz clic en el interruptor **Activar/Desactivar**
4. El plugin quedará activo inmediatamente

### Configurar un Plugin

1. Haz clic en el **nombre del plugin** o en **Configurar**
2. Completa los campos según tus necesidades
3. Haz clic en **Guardar Cambios**
4. Los cambios se aplican automáticamente

### Desactivar un Plugin

1. Ve a la sección **Plugins**
2. Encuentra el plugin activo
3. Haz clic en el interruptor para **Desactivar**
4. El plugin dejará de funcionar inmediatamente

***

## 🎮 Configuración del Servidor

### Idioma

Cambia el idioma de los mensajes del bot:

1. Ve a **Configuración** > **General**
2. Selecciona tu idioma preferido
3. Haz clic en **Guardar**

**Idiomas disponibles:**

* 🇪🇸 Español
* 🇺🇸 English
* 🇫🇷 Français
* 🇩🇪 Deutsch
* 🇵🇹 Português
* 🇷🇺 Русский
* 🇯🇵 日本語
* 🇰🇷 한국어
* 🇨🇳 中文

***

### Zona Horaria

Configura la zona horaria para que los horarios en logs y mensajes sean correctos:

1. Ve a **Configuración** > **General**
2. Selecciona tu zona horaria
3. Haz clic en **Guardar**

***

## 🔐 Permisos del Bot

Para que el bot funcione correctamente, necesita ciertos permisos en tu servidor.

### Permisos Esenciales

Estos permisos son **obligatorios** para el funcionamiento básico:

* ✅ **Ver Canales** - Para detectar mensajes y eventos
* ✅ **Enviar Mensajes** - Para responder y enviar notificaciones
* ✅ **Insertar Enlaces** - Para mostrar embeds e imágenes
* ✅ **Adjuntar Archivos** - Para imágenes de bienvenida/despedida
* ✅ **Usar Comandos de Aplicación** - Para comandos slash

### Permisos por Plugin

Algunos plugins requieren permisos adicionales:

#### 🛡️ Moderation

* ✅ **Expulsar Miembros** - Para el comando `/kick`
* ✅ **Banear Miembros** - Para el comando `/ban`
* ✅ **Moderar Miembros** - Para el comando `/timeout`
* ✅ **Gestionar Mensajes** - Para eliminar mensajes automáticamente

#### 🎫 Tickets

* ✅ **Gestionar Canales** - Para crear canales de tickets
* ✅ **Gestionar Permisos** - Para configurar canales privados

#### 💰 Economy / 💸 Donations

* ✅ **Gestionar Roles** - Para asignar roles comprados

#### 🎭 Reaction Roles

* ✅ **Gestionar Roles** - Para asignar roles por reacciones
* ✅ **Añadir Reacciones** - Para crear paneles de roles

### Verificar Permisos

**En Discord:**

1. Haz clic derecho en el bot en la lista de miembros
2. Selecciona **Permisos**
3. Revisa que tenga todos los permisos necesarios

**En Configuración del Servidor:**

1. Ve a **Configuración del Servidor** > **Roles**
2. Encuentra el rol del bot (generalmente tiene el mismo nombre)
3. Verifica y activa los permisos necesarios

***

## 💎 Planes Free vs Premium

### Plan Free

**Incluido de por vida, sin costo:**

* ✅ Comandos básicos de moderación
* ✅ Sistema de tickets básico
* ✅ Mensajes de bienvenida y despedida
* ✅ 1 panel de reaction roles
* ✅ Soporte comunitario

### Plan Premium

**Características exclusivas:**

* ✅ **Todo lo del Plan Free**, más:
* ✅ AutoMod con filtros inteligentes
* ✅ Sistema de advertencias automático
* ✅ Múltiples categorías de tickets
* ✅ Transcripciones de tickets
* ✅ Sistema de economía completo
* ✅ Tienda de roles (permanentes y temporales)
* ✅ Integración de donaciones (Stripe/PayPal/MercadoPago)
* ✅ Reaction roles ilimitados
* ✅ Embeds personalizados avanzados
* ✅ Tarjetas de bienvenida generadas dinámicamente
* ✅ Prioridad en soporte

### Mejorar a Premium

1. Ve al dashboard: <https://gubo.com.ar>
2. Selecciona tu servidor
3. Haz clic en **Mejorar a Premium**
4. Elige tu plan de suscripción
5. Completa el proceso de pago
6. ¡Disfruta de todas las características Premium!

***

## 🔧 Configuración Avanzada

### Canales Especiales

Algunos plugins funcionan mejor con canales dedicados:

**Recomendaciones:**

* `#bienvenida` - Para mensajes de Welcome
* `#despedidas` - Para mensajes de Goodbye
* `#tickets` - Para panel de tickets
* `#tienda` - Para publicar la tienda de Economy
* `#logs-moderación` - Para logs de moderación (Premium)
* `#transcripciones` - Para transcripciones de tickets (Premium)

### Jerarquía de Roles

Para que el bot pueda gestionar roles correctamente:

1. Ve a **Configuración del Servidor** > **Roles**
2. Arrastra el rol del bot **por encima** de los roles que debe gestionar
3. El bot solo puede asignar roles que estén **debajo** de su rol

**Ejemplo de jerarquía correcta:**

```
1. 👑 Dueño
2. 🛡️ GUBO Bot  ← Rol del bot
3. 🔨 Moderadores
4. 💎 VIP
5. 👤 Miembros
6. @everyone
```

***

## 🛠️ Solución de Problemas

### ❌ El bot no responde a comandos

**Soluciones:**

1. **Verifica que el bot esté online**
   * Debe aparecer con estado verde en la lista de miembros
   * Si está offline, revisa el estado en [status.gubo.bot](https://status.gubo.bot)
2. **Revisa los permisos**
   * El bot necesita "Usar Comandos de Aplicación"
   * Verifica permisos tanto del servidor como del canal
3. **Espera la propagación**
   * Los comandos slash pueden tardar hasta 1 hora en aparecer
   * Reinicia Discord si es necesario

***

### ❌ No puedo acceder al dashboard

**Soluciones:**

1. **Limpia caché del navegador**
   * Ctrl + Shift + Delete (Windows)
   * Cmd + Shift + Delete (Mac)
   * Elimina cookies y datos del sitio
2. **Autoriza de nuevo**
   * Desautoriza la app en Discord (Configuración > Aplicaciones Autorizadas)
   * Vuelve a iniciar sesión en el Dashboard
3. **Verifica tu rol**
   * Debes ser administrador del servidor
   * O tener permisos de "Gestionar Servidor"

***

### ❌ Los cambios no se aplican

**Soluciones:**

1. **Verifica que guardaste**
   * Haz clic en "Guardar Cambios"
   * Espera la confirmación visual (mensaje de éxito)
2. **Refresca la página**
   * Presiona F5 o Ctrl + R
   * Verifica que los cambios persistan después de recargar
3. **Espera unos segundos**
   * Los cambios pueden tardar 5-10 segundos en aplicarse
   * El bot se actualiza automáticamente sin necesidad de reiniciar

***

### ❌ Plugin no funciona después de activarlo

**Soluciones:**

1. **Completa la configuración**
   * Algunos plugins requieren configuración adicional
   * Revisa que todos los campos obligatorios estén completos
   * Asegúrate de haber guardado los cambios
2. **Verifica permisos específicos**
   * Cada plugin puede necesitar permisos diferentes
   * Consulta la guía del plugin específico para ver los permisos necesarios
3. **Revisa el plan**
   * Algunos plugins o características son exclusivos de Premium
   * Verifica que tengas el plan adecuado activo

***

## 📚 Guías de Plugins

Para configuración detallada de cada plugin, consulta:

* [👋 Welcome Plugin](/gubo-docs/comunidad/welcome.md)
* [👋 Goodbye Plugin](/gubo-docs/comunidad/goodbye.md)
* [🛡️ Moderation Plugin](/gubo-docs/moderacion/moderation.md)
* [🎫 Tickets Plugin](/gubo-docs/moderacion/tickets.md)
* [💰 Economy Plugin](/gubo-docs/engagement/economy.md)
* [💸 Donations Plugin](/gubo-docs/engagement/donations.md)
* [🎭 Reaction Roles Plugin](/gubo-docs/engagement/reaction-roles.md)

***

## 📞 Soporte

Si necesitas ayuda adicional:

1. ✅ Revisa esta guía completa
2. ✅ Consulta la [Guía de Inicio Rápido](/gubo-docs/guias/quickstart.md)
3. ✅ Revisa la documentación del plugin específico
4. ✅ Únete a nuestro [servidor de soporte](https://discord.gg/gubo-support)
5. ✅ Contacta al soporte técnico de GUBO

***

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

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

***