Discordia tiene una excelente API para escribir bots personalizados, y una muy activa comunidad de bots. Hoy vamos a echar un vistazo a cómo empezar a hacer el tuyo propio.
Necesitarás un poco de conocimientos de programación para codificar un bot, por lo que no es para todos, pero afortunadamente hay algunos módulos para lenguajes populares que lo hacen muy fácil de hacer. Usaremos el más popular, discordia.js.
¿De qué vamos a hablar?
Empezar
Dirígete a Discord’s portal de botsy cree una nueva aplicación.
Querrá anotar el ID de cliente y el secreto (que debe mantener en secreto, por supuesto). Sin embargo, este no es el bot, solo la “Aplicación”. Tendrás que agregar el bot en la pestaña “Bot”.
Tome nota de este token también, y manténgalo en secreto. No confirmes, bajo ninguna circunstancia, esta clave en Github. Su bot será hackeado casi de inmediato.
Instalar Node.js y obtener codificación
Para ejecutar código Javascript fuera de una página web, necesita Nodo. Descárguelo, instálelo y asegúrese de que funcione en un terminal (o en el símbolo del sistema, ya que todo esto debería funcionar en sistemas Windows). El comando predeterminado es “nodo”.
También recomendamos instalar la herramienta nodemon. Es una aplicación de línea de comandos que monitorea el código de su bot y se reinicia automáticamente en los cambios. Puede instalarlo ejecutando el siguiente comando:
npm i -g nodemon
Necesitarás un editor de texto. Puede usar el bloc de notas, pero le recomendamos que lo haga. Átomo o VSC.
Aquí está nuestro “Hola Mundo”:
const Discord = require('discord.js'); const client = new Discord.Client(); client.on('ready', () => { console.log(`Logged in as €{client.user.tag}!`); }); client.on('message', msg => { if (msg.content === 'ping') { msg.reply('pong'); } }); client.login('token');
Este código se toma del discordia.js ejemplo. Vamos a desglosarlo.
- Las dos primeras líneas son para configurar el cliente. La línea uno importa el módulo en un objeto denominado “Discord” y la línea dos inicializa el objeto cliente.
- El
client.on('ready')
block se disparará cuando se inicie el bot. Aquí, solo está configurado para registrar su nombre en el terminal. - El
client.on('message')
Block se disparará cada vez que se publique un nuevo mensaje en cualquier canal. Por supuesto, deberá verificar el contenido del mensaje, y eso es lo que elif
bloquear hace. Si el mensaje solo dice “ping”, entonces responderá con “¡Pong!” - La última línea inicia sesión con el token desde el portal de bots. Obviamente, el token en la captura de pantalla aquí es falso. Nunca publiques tu token en Internet.
Copie este código, pegue su token en la parte inferior y guárdelo como index.js
en una carpeta dedicada.
Cómo ejecutar el bot
Dirígete a tu terminal y ejecuta el siguiente comando:
nodemon --inspect index.js
Esto inicia el script y también enciende el depurador de Chrome, al que puede acceder escribiendo chrome://inspect/
en Omnibar de Chrome y luego abriendo “herramientas de desarrollo dedicadas para Node”.
Ahora, solo debería decir “Iniciado sesión como < nombre del robot>”, pero aquí he agregado una línea que registrará todos los objetos de mensaje recibidos en la consola:
Entonces, ¿qué compone este objeto de mensaje? Muchas cosas, en realidad:
En particular, tiene la información del autor y la información del canal, a la que puede acceder con msg.author y msg.channel. Recomiendo este método de registro de objetos en las herramientas de desarrollo de Chrome Node, y solo mirar a su alrededor para ver qué lo hace funcionar. Puede que encuentres algo interesante. Aquí, por ejemplo, el bot registra sus respuestas a la consola, por lo que las respuestas del bot se activan client.on('message')
. Entonces, hice un robot de spam:
Nota: Ten cuidado con esto, ya que realmente no quieres lidiar con la recursión.
Cómo agregar el bot a su servidor
Esta parte es más difícil de lo que debería ser. Tienes que tomar esta URL:
https://discordapp.com/oauth2/authorize?client_id=CLIENTID&scope=bot
Y reemplace CLIENTID con el ID de cliente de su bot, que se encuentra en la pestaña de información general del página de aplicación. Sin embargo, una vez hecho esto, puede dar el enlace a sus amigos para que también agreguen el bot a sus servidores.
Muy bien, entonces, ¿qué más puedo hacer?
Más allá de la configuración básica, cualquier otra cosa depende completamente de usted. Pero, esto no sería un gran tutorial si nos detuvimos en hello world, así que repasamos algunos de los documentación, para que tengas una mejor idea de lo que es posible. Te sugiero que leas todo lo que puedas, ya que está muy bien documentado.
Recomendaría agregar console.log(client)
al inicio del código y echando un vistazo al objeto cliente de la consola:
A partir de aquí, puedes aprender mucho. Dado que puede agregar un bot a varios servidores a la vez, los servidores son parte de la Guilds
objeto de mapa. En ese objeto están los individuos Gremios (que es el nombre de la API para “servidor”) y esos objetos de gremio tienen listas de canales que contienen toda la información y listas de mensajes. La API es muy profunda y puede llevar un tiempo aprenderla, pero al menos es fácil de configurar y comenzar a aprender.