Instalación

📦 Instalación

Guía completa para instalar y configurar DiscordBot-TK en tu servidor.

⚡ Requisitos Previos

Sistema

• Node.js v18 o superior
• NPM o PNPM (recomendado)
• Git para clonar el repositorio

Discord

• Bot de Discord creado en Discord Developer Portal
• Token del bot y Client ID
• Permisos de administrador en el servidor

🚀 Instalación Rápida

1. Clonar el Repositorio

git clone https://github.com/tu-usuario/discordbot-tk.git
cd discordbot-tk

2. Instalar Dependencias

# Con NPM
npm install

# Con PNPM (recomendado)
pnpm install

3. Configurar Variables de Entorno

Copia el archivo .env.example a .env y configúralo:

# Bot Configuration
BOT_TOKEN=tu_token_del_bot
CLIENT_ID=tu_client_id

# User Configuration
OWNER_ID=tu_user_id

# Database
DATABASE_PATH=./data/bot.db

# Bot Settings
PREFIX=!

4. Iniciar el Bot

# Desarrollo
npm run dev

# Producción
npm start

🔧 Configuración del Bot de Discord

1. Crear Aplicación

1. Ve a Discord Developer Portal
2. Haz clic en “New Application”
3. Nombra tu aplicación “DiscordBot-TK”

2. Crear Bot

1. Ve a la sección “Bot”
2. Haz clic en “Add Bot”
3. Copia el Token y guárdalo en .env
4. Habilita los siguientes Privileged Gateway Intents:
   • Message Content Intent
   • Server Members Intent
   • Presence Intent

3. Obtener Client ID

1. Ve a “General Information”
2. Copia el Application ID (Client ID)
3. Guárdalo en .env

🎯 Invitar el Bot

Generar URL de Invitación

1. Ve a “OAuth2” > “URL Generator”

2. Selecciona:

   • Scopes: bot y applications.commands
   • Bot Permissions:
     • Administrator (recomendado para facilidad)
     • O permisos específicos:
       • Manage Channels
       • Manage Roles
       • Manage Messages
       • Send Messages
       • Embed Links
       • Attach Files
       • Use Slash Commands
       • View Channel History

3. Copia la URL generada e invita el bot a tu servidor

📁 Estructura de Archivos

Después de la instalación, tendrás esta estructura:

discordbot-tk/
├── src/
│   ├── commands/         # Comandos del bot
│   ├── events/          # Eventos de Discord
│   ├── handlers/        # Manejadores de funciones
│   ├── utils/           # Utilidades
│   └── locales/         # Archivos de traducción
├── data/                # Base de datos SQLite
├── logs/                # Logs del bot
├── docs/                # Documentación
├── .env                 # Variables de entorno
└── package.json         # Dependencias

✅ Verificar Instalación

Una vez iniciado el bot, deberías ver:

[INFO] Bot iniciado correctamente
[INFO] Comandos registrados: X comandos
[INFO] Conectado como: TuBot#1234
[INFO] Servidores: X servidores

🔍 Solución de Problemas

Error: Invalid Token

• Verifica que el token en .env sea correcto
• Regenera el token en Discord Developer Portal si es necesario

Error: Missing Permissions

• Asegúrate de que el bot tenga permisos de administrador
• Verifica que los Privileged Intents estén habilitados

Error: Cannot find module

• Ejecuta npm install o pnpm install
• Verifica que Node.js esté instalado correctamente

📞 Siguiente Paso

Una vez instalado correctamente, continúa con la configuración inicial del bot.