Los bots de Discord vienen en todas las formas y tamaños y se pueden usar para una amplia gama de propósitos que van desde moderar el comportamiento del usuario en su servidor, aplicar automáticamente castigos como silenciar o prohibir a los jugadores que se pasan de la raya, hasta jugar música para que todos disfruten.
Las instrucciones a continuación asumen que ya tienes una cuenta y un servidor de Discord. De lo contrario, debe configurar esto en discordapp.com antes de continuar.
Si bien los bots de Discord están escritos en el lenguaje JavaScript, no es necesario ser un codificador experimentado para crearlos. De hecho, el proceso es mucho menos intimidante de lo que imaginas. Sigue leyendo para aprender cómo hacer un Discord Bot que cumpla tus órdenes.
Este tutorial está destinado a usuarios que ejecutan sistemas operativos macOS o Windows.
Descargar e instalar Node.js
Antes de comenzar con la creación del bot de Discord, primero querrá instalar Node.js, un entorno de tiempo de ejecución de JavaScript creado en el motor V8 de Google Chrome.
-
Abra un navegador web y vaya a la página de descarga oficial de Node.js.
- Seleccione el paquete de instalación apropiado para su plataforma particular (macOS o Windows) y haga clic en su enlace de descarga.
- Abra el archivo descargado y siga las indicaciones en pantalla para instalar Node.js.
- Una vez completado, inicie la aplicación Símbolo del sistema (Windows) o Terminal (macOS).
-
Escriba el siguiente texto cuando se le solicite y presione Enter en su teclado: node -v
- Si se devuelve un número de versión, entonces Node.js está instalado correctamente. De lo contrario, vuelva a realizar los pasos anteriores y asegúrese de que se haya completado la instalación.
Crear una aplicación Discord
Ahora que ha eliminado los requisitos previos, es hora de crear una nueva aplicación a la que se pueda agregar su bot más tarde.
- Abra un navegador y vaya al Portal de desarrolladores de Discord para su servidor, inicie sesión si es necesario.
-
Haga clic en Nueva aplicación.
-
Ingrese un nombre para su nueva aplicación en el campo de edición provisto y haga clic en Crear cuando esté listo.
-
Ahora debería mostrarse la pantalla de información general para su nueva aplicación, como se muestra en la captura de pantalla adjunta. Seleccione Bot, que se encuentra en el panel de menú izquierdo.
-
Haga clic en Agregar bot.
-
Aparecerá un mensaje que le preguntará si está seguro de que desea agregar un bot a su aplicación. Haz clic en ¡Sí, hazlo!
-
Su nuevo bot ahora debe estar creado, con su información y opciones mostradas en la sección BUILD-A-BOT. Seleccione Haga clic para revelar el token.
-
Ahora debería mostrarse una larga cadena de caracteres en lugar del enlace mencionado anteriormente. Haga clic en Copiar para enviar este token a su portapapeles.
-
Pegue este token en un archivo de texto por ahora usando Notepad, TextEdit o una aplicación similar.
Debe eliminar este archivo y eliminarlo de la Papelera de reciclaje o Papelera una vez que haya completado este tutorial.
Codificación de su bot
Ha creado un bot y lo ha agregado a su servidor. Luego viene la parte divertida, codificar tu bot para que haga lo que tú quieras.
- Inicie la aplicación Símbolo del sistema (Windows) o Terminal (macOS).
-
Escriba el siguiente texto cuando se le solicite y presione Enter o Return en su teclado: mkdir discord-test -bot
Puedes reemplazar discord-test-bot con el nombre que elijas.
-
A continuación, escriba el siguiente comando para atravesar el directorio recién creado: cd discord-test-bot
-
El símbolo del sistema ahora debería actualizarse y mostrar el nombre de la carpeta del proyecto de la carpeta de su bot. Escriba lo siguiente y presione Enter o Return: npm init -y
-
Ahora se debe crear un archivo llamado package.json en la carpeta de su proyecto, como se muestra en la captura de pantalla anterior. Escriba lo siguiente en el símbolo del sistema y presione Entrar o Regresar: npm install --save discord.js
-
Es posible que ahora se muestre una lista de mensajes de ADVERTENCIA, que se pueden ignorar siempre que no se muestren errores (ERR) y el mensaje en la parte inferior de la ventana del símbolo del sistema o de la terminal diga "7 paquetes agregados" o “8 paquetes agregados”. Escriba lo siguiente y presione Enter o Return para crear el archivo auth.json: touch auth.json
Si recibe un mensaje de error cuando intenta usar el comando touch, es posible que primero deba instalarlo ingresando la siguiente sintaxis en el símbolo del sistema: npm install touch-cli -g
-
Habrá un mensaje de confirmación indicando que se creó este archivo, pero puede escribir ls -al (macOS) o dir (Windows) para ver el contenido del directorio de su proyecto y confirmar por sí mismo que auth.json está en la lista.
- Inicie su código o editor de texto preferido, como Atom, Notepad o TextEdit, y navegue hasta la carpeta de su nuevo proyecto.
-
Abra el archivo auth.json e ingrese el texto que se muestra en la captura de pantalla adjunta, reemplazando AUTH-TOKEN con la cadena de token de autenticación que almacenó anteriormente en el tutorial. Guarde el archivo cuando termine.
Usted debe copiar y pegar toda la cadena de autenticación entre las comillas que se muestran. Si te f alta incluso un carácter, tu bot no funcionará como se espera.
- Vuelva al editor y cree un nuevo archivo en la carpeta de su proyecto llamado bot.js.
-
El archivo bot.js contendrá el código que dicta el comportamiento de su bot, que depende completamente de usted. Sin embargo, para los propósitos de este tutorial, recomendamos usar el siguiente código y probar su bot de principio a fin para asegurarse de que todo funcione como se esperaba. A continuación, puede volver atrás y editar el contenido de bot.js como mejor le parezca.
const Discord=require('discord.js');
const cliente=new Discord. Client();
const auth=require('./auth.json');
cliente.on('listo', ()=> {
console.log(`Iniciado sesión como ${client.user.tag}!`);
});
cliente.on('mensaje', mensaje=> {
if (mensaje.contenido==='hola') {
msg.reply('¡hola!');
}
});
cliente.login(auth.token);
Este código de muestra escribirá un mensaje en la consola de la línea de comandos cuando se llame al bot, confirmando un inicio de sesión exitoso y conteniendo su etiqueta de usuario.
- Guarde su archivo bot.js actualizado.
- Vuelva al símbolo del sistema o terminal y escriba lo siguiente para ejecutar el script de su bot: node bot.js
- Si ha hecho todo correctamente hasta este punto, debería aparecer el siguiente texto en su símbolo del sistema o ventana de terminal: Inicie sesión como discord-test-bot
Integre el código de bot con su servidor
Ya casi estás…
- Abra un navegador y vaya al Portal de desarrolladores de Discord para su servidor, inicie sesión si es necesario.
-
Seleccione la aplicación que creamos anteriormente desde la pantalla MIS APLICACIONES, si se le solicita.
-
Haga clic en OAuth2, ubicado en el panel de menú izquierdo.
-
Desplácese hasta la parte inferior de la pantalla hasta que localice la sección SCOPES. Coloque una marca de verificación junto a la opción bot haciendo clic en ella una vez.
-
Desplácese hacia abajo nuevamente hasta la sección PERMISOS DE BOT, colocando marcas de verificación junto a cada tipo de permiso que su bot individual podría necesitar para funcionar como se espera. A los efectos de este bot de ejemplo, necesitamos los siguientes permisos: Enviar mensajes, Leer historial de mensajes
Es probable que su bot en particular necesite un conjunto de permisos significativamente diferente. Es importante comprender lo que implica cada permiso antes de habilitarlo, para que los usuarios de bots no puedan explotarlo con fines nefastos.
-
Haga clic en Copiar, ubicado entre las secciones ÁMBITOS y PERMISOS DE BOT y acompañado de una URL larga.
- Abra una nueva pestaña del navegador y pegue esta URL en la barra de direcciones, presionando Enter o Return para cargar la página.
-
Ahora debería mostrarse la interfaz CONECTAR A DISCORD, como se muestra en la captura de pantalla adjunta. Haga clic en Seleccione un servidor y elija el nombre de su servidor de la lista provista.
-
Haga clic en Autorizar.
-
Coloque una marca de verificación junto a No soy un robot haciendo clic en su casilla de verificación una vez.
-
Ahora debería mostrarse un mensaje de confirmación, indicando que su bot está autorizado y se ha agregado a su servidor.
Cómo probar su bot en el servidor
Puede probar su bot iniciando el cliente Discord y enviándole comandos o mensajes que correspondan a su código particular. En este ejemplo, envíe la palabra hola a su bot y debería responder con ¡hola!