Preguntas frecuentes

Respuestas a las dudas más comunes sobre Discord.js y Discord.py

Tabla de contenidos

1. Comenzando con Bots de Discord

2. Instalación y Configuración

3. Errores Comunes

4. Comandos y Eventos

5. Permisos y Roles

6. Audio y Voz

7. Bases de Datos

8. Despliegue y Hosting

9. Performance y Optimización

10. Troubleshooting Avanzado

---

Comenzando

¿Qué es mejor para empezar: Discord.js o Discord.py?

Factor	Discord.js	Discord.py	Recomendación
Principiante absoluto	⭐⭐⭐	⭐⭐⭐⭐⭐	Discord.py por sintaxis más legible
Experiencia con JS	⭐⭐⭐⭐⭐	⭐⭐	Discord.js aprovecha conocimiento
Ecosistema de librerías	⭐⭐⭐⭐⭐	⭐⭐⭐⭐	Discord.js (npm vastísimo)
Documentación	⭐⭐⭐⭐	⭐⭐⭐⭐⭐	Discord.py más completa

Veredicto: Si nunca programaste, empieza con Discord.py. Si vienes de desarrollo web, usa Discord.js.

¿Necesito saber JavaScript/Python antes de hacer bots?

Sí, es altamente recomendable. Aunque puedes copiar ejemplos básicos, para hacer bots útiles necesitas:

JavaScript:

• Variables (const, let)

• Funciones (function, arrow functions)

• Promesas (async/await)

• Objetos y Arrays

• Manejo de errores (try/catch)

Python:

• Variables y tipos de datos

• Funciones (def, async def)

• Clases y objetos

• Listas y diccionarios

• Manejo de excepciones (try/except)

📚 Recursos recomendados:

• JS: MDN Web Docs

• Python: Python.org Tutorial

¿Cuánto tiempo toma aprender a hacer bots?

Nivel	Tiempo Estimado	Qué Puedes Hacer
Básico	1-2 semanas	Ping/pong, comandos simples
Intermedio	1-3 meses	Sistema de moderación, embeds
Avanzado	6+ meses	Bases de datos, APIs externas
Experto	1+ año	Sharding, arquitecturas complejas

Depende de tu experiencia previa y tiempo dedicado diariamente.

¿Es gratis hacer bots de Discord?

Crear el bot: ✅ Totalmente gratis

• Discord Developer Portal es gratuito

• Librerías Discord.js y discord.py son open source

Hosting:

• Gratis: Glitch, Replit (limitado)

• Pago: VPS, Heroku, Railway ($5-20/mes)

APIs externas: Algunas gratuitas, otras de pago

---

Instalación y configuración

Error: "Cannot find module 'discord.js'"

Causa: No instalaste la librería correctamente.

Solución:

# Verifica que estés en la carpeta correcta
pwd

# Instala discord.js
npm install discord.js

# Si persiste, elimina node_modules y reinstala
rm -rf node_modules package-lock.json
npm install

Error: "No module named 'discord'"

Causa: discord.py no está instalado o estás usando el entorno incorrecto.

Solución:

# Verifica el entorno virtual
source venv/bin/activate  # Linux/Mac
venv\Scripts\activate     # Windows

# Instala discord.py
pip install discord.py

# Verifica instalación
python -c "import discord; print(discord.__version__)"

¿Por qué mi bot no aparece online?

Causas comunes:

1. Token inválido:

// JS - Verifica el token
console.log(process.env.DISCORD_TOKEN); // No debe ser undefined

# Py - Verifica el token
import os
print(os.getenv('DISCORD_TOKEN'))  # No debe ser None

1. Archivo .env no cargado:

// Asegúrate de tener al inicio:
require('dotenv').config();

# Asegúrate de tener:
from dotenv import load_dotenv
load_dotenv()

1. Intentos faltantes (común desde 2021):

const client = new Client({
    intents: [GatewayIntentBits.Guilds, GatewayIntentBits.GuildMessages]
});

---

Errores comunes

"Missing Permissions" - ¿Cómo solucionarlo?

Error	Causa	Solución
Missing Access	Bot sin permisos en el canal	Revisar permisos del rol del bot
Missing Permissions	Acción específica prohibida	Otorgar permisos necesarios
Forbidden (403)	Bot intentando algo sin permisos	Verificar jerarquía de roles

Cómo verificar permisos:

// JS
if (!message.guild.members.me.permissions.has(PermissionsBitField.Flags.KickMembers)) {
    return message.reply('No tengo permisos para expulsar miembros');
}

# Py
if not ctx.guild.me.guild_permissions.kick_members:
    return await ctx.send('No tengo permisos para expulsar miembros')

"Cannot send an empty message" - Discord API Error

Causa: Intentas enviar un mensaje vacío o solo con espacios.

Solución:

// JS - Validar contenido
if (!message.trim()) {
    return channel.send('❌ No puedo enviar mensajes vacíos');
}
await channel.send(message);

# Py - Validar contenido
if not message.strip():
    return await ctx.send('❌ No puedo enviar mensajes vacíos')
await ctx.send(message)

Rate Limit Exceeded (429) - ¿Qué hago?

Discord tiene límites:

• 5 mensajes por 5 segundos por canal

• 50 reacciones por 5 segundos

• 2000 requests por hora globalmente

Solución:

// JS - Manejo de rate limits
client.on('rateLimit', (info) => {
    console.log(`Rate limit alcanzado: ${info.timeout}ms, ruta: ${info.route}`);
});

# Py - discord.py maneja automáticamente
# Pero puedes configurar:
import discord
discord.opus.load_opus()  # Para mejor performance

Mejores prácticas:

• No envíes mensajes en bucles rápidos

• Usa setTimeout/asyncio.sleep entre requests

• Combina mensajes cuando sea posible

---

Comandos y eventos

¿Por qué mis comandos no funcionan después de agregar on_message?

Problema común en Discord.py:

# ❌ INCORRECTO
@bot.event
async def on_message(message):
    print(f'Mensaje: {message.content}')
    # Falta procesar comandos!

# ✅ CORRECTO
@bot.event
async def on_message(message):
    print(f'Mensaje: {message.content}')
    await bot.process_commands(message)  # ¡Importante!

Alternativa con listeners:

@bot.listen('on_message')
async def log_messages(message):
    print(f'Mensaje: {message.content}')
    # No necesita process_commands

¿Cómo hago que solo yo pueda usar un comando?

Discord.js:

client.on('messageCreate', message => {
    if (message.content === '!admin') {
        if (message.author.id !== 'TU_USER_ID') {
            return message.reply('❌ Solo el dueño puede usar este comando');
        }
        // Comando admin aquí
    }
});

Discord.py:

@bot.command()
@commands.is_owner()
async def admin(ctx):
    await ctx.send('¡Comando de administrador!')

Para múltiples usuarios:

OWNERS = ['123456789', '987654321']

@bot.command()
async def vip(ctx):
    if str(ctx.author.id) not in OWNERS:
        return await ctx.send('❌ No tienes permiso')
    # Comando VIP

¿Por qué mis argumentos necesitan comillas?

Problema:

# Comando: !echo hola mundo
# Solo recibe "hola", ignora "mundo"
@bot.command()
async def echo(ctx, message: str):
    await ctx.send(message)  # Solo envía "hola"

Solución - Usar * para consumir el resto:

@bot.command()
async def echo(ctx, *, message: str):
    await ctx.send(message)  # Envía "hola mundo"

Discord.js equivalente:

// Manualmente dividir argumentos
const args = message.content.slice(prefix.length).trim().split(/ +/);
const command = args.shift().toLowerCase();
const fullMessage = args.join(' ');

---

Permisos y roles

¿Cómo verifico si un usuario tiene un rol específico?

Método	Discord.js	Discord.py
Por nombre	member.roles.cache.some(role => role.name === 'Moderador')	discord.utils.get(member.roles, name='Moderador')
Por ID	member.roles.cache.has('123456789')	member.get_role(123456789)
Múltiples roles	member.roles.cache.hasAny(['id1', 'id2'])	Comparar con lista

Ejemplos prácticos:

// JS
if (message.member.roles.cache.some(role => role.name === 'Moderador')) {
    // Usuario es moderador
}

# Py
if discord.utils.get(ctx.author.roles, name='Moderador'):
    # Usuario es moderador

¿Cómo añado/quito roles a usuarios?

Discord.js:

// Añadir rol
const role = guild.roles.cache.find(role => role.name === 'Miembro');
await member.roles.add(role);

// Quitar rol
await member.roles.remove(role);

// Múltiples roles
await member.roles.add([role1, role2]);

Discord.py:

# Añadir rol
role = discord.utils.get(ctx.guild.roles, name='Miembro')
await member.add_roles(role)

# Quitar rol
await member.remove_roles(role)

# Múltiples roles
await member.add_roles(role1, role2, role3)

⚠️ Importante: El bot debe tener permisos Manage Roles y su rol debe estar por encima del rol que quiere modificar.

---

Audio y voz

Error: "Cannot find module '@discordjs/voice'"

Instalación correcta:

# Discord.js
npm install @discordjs/voice
# También necesitas FFmpeg instalado en tu sistema

# Discord.py
pip install discord.py[voice]
# También necesitas FFmpeg

Verificar FFmpeg:

# Debe mostrar versión, no error
ffmpeg -version

Instalar FFmpeg:

• Windows: FFmpeg.org o choco install ffmpeg

• Mac: brew install ffmpeg

• Ubuntu: sudo apt install ffmpeg

Mi bot se conecta a voz pero no reproduce audio

Checklist de diagnóstico:

1. Permisos del canal:

   • ✅ Connect

   • ✅ Speak

   • ✅ Use Voice Activity

2. Código Discord.js:

import { createAudioPlayer, createAudioResource, joinVoiceChannel } from '@discordjs/voice';

const connection = joinVoiceChannel({
    channelId: channel.id,
    guildId: guild.id,
    adapterCreator: guild.voiceAdapterCreator,
});

const player = createAudioPlayer();
const resource = createAudioResource('song.mp3');
connection.subscribe(player);
player.play(resource);

1. Código Discord.py:

import discord
from discord import FFmpegPCMAudio

vc = await voice_channel.connect()
vc.play(FFmpegPCMAudio('song.mp3'))

---

Bases de datos

¿Qué base de datos usar para mi bot?

Base de Datos	Mejor Para	Pro	Contra
SQLite	Desarrollo, bots pequeños	Fácil setup, sin servidor	No escalable
PostgreSQL	Producción, bots medianos-grandes	Robusto, escalable	Requiere servidor
MongoDB	Datos no estructurados	Flexible, rápido	Curva de aprendizaje
Redis	Caché, datos temporales	Ultra rápido	Solo en memoria

Recomendación por tamaño:

• < 10 servidores: SQLite

• 10-100 servidores: PostgreSQL

• 100+ servidores: PostgreSQL + Redis para caché

Error: "Cannot connect to database"

Checklist:

1. Variables de entorno:

# .env
DATABASE_URL=postgresql://user:password@localhost:5432/botdb

1. Servicio corriendo:

# PostgreSQL
sudo systemctl status postgresql
# o
pg_ctl status

# MongoDB
sudo systemctl status mongod

1. Permisos de conexión:

-- PostgreSQL: crear usuario y base de datos
CREATE USER botuser WITH PASSWORD 'password';
CREATE DATABASE botdb OWNER botuser;
GRANT ALL PRIVILEGES ON DATABASE botdb TO botuser;

---

Despliegue y hosting

Mi bot funciona local pero no en producción

Causas comunes:

1. Variables de entorno faltantes:

# Verifica en el servidor
echo $DISCORD_TOKEN
# Si está vacío, configurarlo
export DISCORD_TOKEN=tu_token

1. Dependencias faltantes:

# Instalar dependencias de producción
npm ci --production  # JS
pip install -r requirements.txt  # Python

1. Puerto incorrecto (para bots con dashboard web):

const PORT = process.env.PORT || 3000;  // Heroku usa process.env.PORT
app.listen(PORT, () => {
    console.log(`Servidor en puerto ${PORT}`);
});

1. Timeout de proceso:

// Mantener el bot vivo
setInterval(() => {
    console.log('Bot activo:', new Date().toISOString());
}, 300000); // Cada 5 minutos

¿Cuál es la mejor plataforma para hosting?

Plataforma	Precio	Pros	Contras	Recomendado Para
Railway	$5-20/mes	Fácil, Git deploy	Pago	Bots medianos
Heroku	$7-25/mes	Confiable, addons	Más caro	Aplicaciones completas
DigitalOcean	$5-10/mes	Control total	Requiere setup manual	Desarrolladores expertos
AWS EC2	$3-15/mes	Escalable	Complejo	Empresas
Replit	Gratis/$7/mes	Fácil para principiantes	Limitado	Aprendizaje/testing

Recomendación: Railway para empezar, DigitalOcean cuando crezcas.

---

Performance y optimización

Mi bot es lento, ¿cómo optimizarlo?

Técnicas principales:

1. Caché inteligente:

// JS - Usar Map para caché
const cache = new Map();
// En lugar de hacer fetch cada vez
if (cache.has(userId)) {
    return cache.get(userId);
}
const userData = await fetchUser(userId);
cache.set(userId, userData);

1. Bulk operations:

# Py - Operaciones en lote
users = [User(name=name) for name in names]
session.bulk_insert_mappings(User, users)

1. Lazy loading:

// Solo cargar cuando sea necesario
const member = await guild.members.fetch(userId);

1. Connection pooling:

// Reusar conexiones de BD
const pool = new Pool({
    connectionString: DATABASE_URL,
    max: 20  // máximo 20 conexiones
});

¿Cuándo necesito sharding?

Límites de Discord:

• 2,500 servidores = 1 shard obligatorio

• 5,000 servidores = 2+ shards recomendados

Señales de que necesitas sharding:

• Bot en 1000+ servidores

• Latencia alta (>300ms consistente)

• Timeouts frecuentes

• Memory leaks

Implementación básica:

// JS - AutoShardedClient
const client = new AutoShardedClient({
    intents: [GatewayIntentBits.Guilds]
});

# Py - AutoShardedBot
bot = commands.AutoShardedBot(
    command_prefix='!',
    intents=discord.Intents.default()
)

---

Troubleshooting avanzado

¿Cómo debuggear errores extraños?

1. Logging avanzado:

// JS
import winston from 'winston';
const logger = winston.createLogger({
    level: 'debug',
    format: winston.format.json(),
    transports: [
        new winston.transports.File({ filename: 'error.log', level: 'error' }),
        new winston.transports.Console()
    ]
});

client.on('debug', info => logger.debug(info));
client.on('warn', info => logger.warn(info));
client.on('error', error => logger.error(error));

# Py
import logging
logging.basicConfig(
    level=logging.DEBUG,
    format='%(asctime)s:%(levelname)s:%(name)s: %(message)s',
    handlers=[
        logging.FileHandler('discord.log'),
        logging.StreamHandler()
    ]
)

2. Manejo de errores no capturados:

// JS
process.on('unhandledRejection', error => {
    console.error('Unhandled promise rejection:', error);
});

process.on('uncaughtException', error => {
    console.error('Uncaught exception:', error);
    process.exit(1);
});

# Py
@bot.event
async def on_error(event, *args, **kwargs):
    import traceback
    print(f'Error en {event}:')
    traceback.print_exc()

Mi bot se crashea aleatoriamente

Causas comunes:

1. Memory leaks:

// ❌ Malo: acumula event listeners
setInterval(() => {
    client.on('messageCreate', handler); // Se agrega cada vez!
}, 1000);

// ✅ Bueno: un solo listener
client.on('messageCreate', handler);

1. Promesas no manejadas:

// ❌ Malo
channel.send(message); // Si falla, crash

// ✅ Bueno
channel.send(message).catch(console.error);

1. Stack overflow por recursión:

# ❌ Malo
async def recursive_function():
    await recursive_function()  # Infinito!

# ✅ Bueno: agregar condición de parada
async def safe_recursive(depth=0):
    if depth > 100:
        return
    await safe_recursive(depth + 1)

Herramientas de monitoreo:

• PM2 para Node.js (restart automático)

• Docker con restart policies

• Health checks con webhooks

---

Vídeos de YouTube recomendados

Tutorial completo Discord.js v14 actualizado 2025

Bot de Discord con Python 2025

Command Handler para Discord.js v14

---

Recursos adicionales

Recurso	Enlace	Descripción
Discord.js Guide	discordjs.guide	Guía oficial completa
Discord.py Docs	discordpy.readthedocs.io	Documentación oficial
Discord Developers	discord.com/developers	Portal oficial de Discord

---

Si tienes una pregunta que no está aquí, únete al servidor de Discord de la comunidad o abre un issue en el repositorio del proyecto. ¡La documentación mejora con tu feedback!