Configuración

⚙️ Configuración

Guía completa para configurar DiscordBot-TK en tu servidor y aprovechar todas sus funcionalidades.

🚀 Configuración Inicial

Primer Uso

Una vez que el bot esté online en tu servidor, estos son los pasos recomendados:

1. Verificar que el bot funciona

   /ping

2. Configurar idioma del servidor

   /language

   Elige entre español e inglés para todas las interacciones.

3. Configurar sistemas principales

   • /ticket-setup - Sistema de tickets
   • /welcome-setup - Sistema de bienvenida
   • /setup-roles - Sistema de roles

🛠️ Variables de Entorno

Archivo .env

# Configuración del Bot
BOT_TOKEN=tu_token_aqui
CLIENT_ID=tu_client_id
OWNER_ID=tu_user_id

# Base de Datos
DATABASE_PATH=./data/bot.db

# Configuración Opcional
PREFIX=!
NODE_ENV=production

Explicación de Variables

• BOT_TOKEN: Token del bot desde Discord Developer Portal
• CLIENT_ID: ID de la aplicación Discord
• OWNER_ID: Tu ID de usuario para comandos de administrador
• DATABASE_PATH: Ruta de la base de datos SQLite
• PREFIX: Prefijo para comandos de texto (obsoleto con slash commands)

🎫 Sistema de Tickets

Configuración Completa

/ticket-setup

Este comando te guiará a través de:

1. Categoría de Tickets - Donde se crearán los canales
2. Canal del Panel - Donde aparecerá el panel con botones
3. Canal de Logs - Para registrar eventos
4. Rol del Staff - Quién puede gestionar tickets
5. Categorías Personalizadas - Tipos de tickets

Personalización Avanzada

El sistema permite configurar múltiples categorías de tickets:

// Ejemplo de categorías personalizadas
{
  "support": {
    "name": "Soporte Técnico",
    "description": "Ayuda técnica general",
    "emoji": "🔧"
  },
  "report": {
    "name": "Reportar Bug",
    "description": "Reportar errores",
    "emoji": "🐛"
  },
  "suggest": {
    "name": "Sugerencias",
    "description": "Ideas para el servidor",
    "emoji": "💡"
  }
}

🛬 Sistema de Bienvenida

Configuración Básica

/welcome-setup

Opciones Disponibles

1. 📢 Establecer Canal - Canal de bienvenidas
2. 💬 Configurar Mensaje - Mensaje personalizado
3. 🖼️ Configurar Imagen - URL de imagen personalizada
4. 🧪 Probar Bienvenida - Mensaje de prueba
5. 🔄 Alternar Sistema - Activar/desactivar

Variables de Personalización

Variable	Descripción	Ejemplo
{user}	Menciona al usuario	@Usuario
{user.tag}	Nombre completo	Usuario#1234
{user.username}	Solo nombre	Usuario
{user.id}	ID del usuario	123456789
{server}	Nombre del servidor	Mi Servidor
{memberCount}	Total de miembros	150

Ejemplo de Mensaje

🎉 ¡Bienvenido {user} a **{server}**!

Eres nuestro miembro #{memberCount}
¡Esperamos que disfrutes tu estadía!

📋 Lee las reglas en #reglas
💬 Chatea con nosotros en #general

🎮 Sistema de Niveles

Configuración

El sistema de niveles funciona automáticamente, pero puedes:

1. Ver tu nivel

   /rank

2. Ver ranking del servidor

   /leaderboard

Personalización

Los niveles se ganan automáticamente por actividad:

• Mensajes: +15-25 XP por mensaje
• Cooldown: 1 minuto entre mensajes que dan XP
• Niveles: Calculados con fórmula exponencial

🎭 Sistema de Roles

Configuración de Roles por Reacción

/setup-roles

Este sistema permite:

• Roles por reacción a mensajes específicos
• Roles automáticos por nivel
• Gestión de permisos avanzada

🔨 Moderación

Comandos Disponibles

Comando	Descripción	Uso
/ban	Banear usuario	/ban @usuario razón
/kick	Expulsar usuario	/kick @usuario razón
/timeout	Aislar usuario	/timeout @usuario tiempo
/warn	Advertir usuario	/warn @usuario razón
/clear	Limpiar mensajes	/clear 10

Configuración de Logs

Los logs de moderación se envían automáticamente al canal configurado con /ticket-setup o puedes configurar uno específico.

📊 Base de Datos

Estructura

El bot usa SQLite con la siguiente estructura:

data/
├── bot.db              # Base de datos principal
├── backups/            # Respaldos automáticos
└── logs/               # Logs del sistema

Respaldos

• Automáticos: Cada 24 horas
• Manuales: Comando /backup (solo owner)

🌍 Internacionalización

Idiomas Soportados

• Español (es) - Idioma por defecto
• English (en) - Inglés completo

Cambiar Idioma

/language

Todos los comandos, mensajes y embeds se adaptan automáticamente al idioma seleccionado.

🔍 Solución de Problemas

Problemas Comunes

1. El bot no responde

   • Verifica que esté online
   • Comprueba permisos en el canal
   • Revisa que tenga permisos de slash commands

2. Comandos no aparecen

   • Espera hasta 1 hora para la sincronización global
   • Verifica que el bot tenga permisos de aplicaciones

3. Errores de base de datos

   • Comprueba que la carpeta data/ exista
   • Verifica permisos de escritura

Logs de Debug

Los logs se guardan automáticamente en:

logs/
├── bot-YYYY-MM-DD.log    # Logs diarios
├── error-YYYY-MM-DD.log  # Solo errores
└── debug-YYYY-MM-DD.log  # Debug detallado

📞 Siguiente Paso

Una vez configurado, explora los sistemas individuales:

• Sistema de Tickets
• Sistema de Bienvenida
• Sistema de Niveles
• Moderación