[#IC] Crea tu bot de Discord (basico) con Discord.js

Bienvenidos Taringueros! Antes que nada te pido que dejes cargar el post un ratito, ya que contiene 77 imagenes en total (creo) sin contar el gif de arriba jajajaja Se termino de cargar? Estupendo! En este post vas a aprender a crear y programar tu propio bot de Discord. ¿Que es un bot de Discord? Un bot de discord, para resumir, es una aplicacion programable con C++, Python, Ruby, PHP, JavaScript, etc. Que se conecta mediante una cuenta especial a Discord y puedes utilizarla en Servers, para entregar contenido, utilidades, escuchar musica, cagarse de risa y demas cosas que puede permitir el lenguaje. Mas bien es como tu aplicacion, pero disponible para to2 los que quieran usarla. ¿Que necesitaremos? En este post, vamos a trabajar con Javascript, y la libreria correspondiente: Discord.js, una sencilla libreria apta para empezar en el mundo de los bots. Necesitamos tambien: - Node.JS ( https://nodejs.org/en/download/current/) - El Bloc de Notas - Discord (https://discordapp.com) - Paciencia - Manaos de sabor a Cola Empecemos!!! Paso 1) Creando el Bot: Vamos a crear el usuario que utilizara el bot para poder funcionar, asi que vamos a la siguiente pagina web: https://discordapp.com/developers/docs/intro Nos logueamos con nuestra cuenta de Discord, o nos registramos en la pagina. y despues, hacemos clic aqui: Nos llevara a esta pagina: Yo ya tengo un bot creado que se llama "PanchoBot", pero en este caso yo voy a crear uno nuevo, asi que ponemos en "New App" Luego nos llevara aqui, donde los parametros a configurar (y obligatorios) son... 1) Nombre de nuestra App o Bot (Obligatorio) 2) La descripcion de nuestro bot (Esto sirve para no confundirse si tienes muchos bots, y para tener en cuenta para que es el bot) Si quieres, puedes dejar este campo vacio 3) La imagen de perfil que tendra nuestro bot Como subo la imagen de perfil? Hacemos clic en la parte azul de "APP ICON", se abrira una ventana donde deberas escojer una imagen Yo escojere esta imagen que descargue de por ahi, igual, en cualquier momento se la puede cambiaraun despues de que el bot este creado. Finalmente hacemos clic en "Create App" y nos llevara a la siguiente pagina: Para crear el usuario para el bot, hacemos clic en "Create a Bot User", nos saldra la siguiente advertencia: Lo que basicamente dice el mensaje, es que si lo creas, este usuario sera permanente para toda la vida y no se podra borrar, y es irreversible, y te dice que escojas con cuidado, esto es para que estes seguro de lo que estes haciendo, ya que hay personas, que van, crean el usuario y el proyecto queda en la nada Una vez de que nos decidamos a hacerlo, pulsamos en "Yes, do it!" para crear el usuario, finalmente aparecera esto: Marcamos la casilla que dice "Public Bot", esto es para que tu bot lo pueda añadir cualquier persona a tu server sin solicitar autorizacion. Ya tenemos el usuario creado!!! Pero ahora, como lo añadimos al server? Debemos crear un link de invitacion, no es la gran cosa, es muy facil crearlo! Copia este link y pegalo en un bloc de notas: https://discordapp.com/oauth2/authorize?&client_id=(el id del bot va aqui)&scope=bot y luego vamos a copiar el ID de tu bot: El tuyo puede variar al que se muestra aqui En mi caso, ese es el ID de mi bot Copialo y reemplaza el texto ya existente en el parametro "client_id" del link, asi: y listo, ahora lo ponemos en el navegador: Nos saldra la siguiente pagina, aqui seleccionamos el server donde queremos agregar el usuario bot que creamos, yo seleccionare el server "Pruebas" que cree para esta ocasion: y luego pulsamos en "Autorizar": Y marcamos la casilla de autorizacion para demostrar que no somos otro bot de mierda: Y listo papu, el bot ya esta agregado a nuestro server: El siguiente paso seria ir a discord, nosotros veremos que hay un nuevo miembro en el server, pero esta desconectado, ese es nuestro bot Tambien puedes agregar el bot en cualquier server donde tengas un rango Administrativo, o pedirle a un admin de un server que te lo agregue, siempre dando el link que generaste anteriormente para que te puedan invitar el bot: ============================================================================== Paso 2) El token Muy bien, aprendimos a crear un espacio para nuestro bot, lo pudimos agregar al servidor, etc. Pero, ahora hay que programarlo para que funcione, si no de que valdria la pena tener un bot que no hace nada? Para eso, vamos a empezar a programar (en Javascript) nuestro primer bot. Primero que nada, volveremos a la pagina de informacion de nuestro bot y haremos clic en "Click to reveal" donde esta el parametro "Token" Este es nuestro token (flecha azul), el token vendria a ser nuestro email y contraseña especiales para que el programa acceda al usuario bot que hemos creado, este token, no lo debes compartir ni difundir a nadie, ya que otra persona podria utilizarlo para colocar su script en tu bot. En caso de que lo hayas hecho por accidente, presiona "Generate a new token?" y acepta todas las advertencias para generar un token nuevo, esto desconectara a tu bot y a cualquier otro que comparta el mismo token y no funcionara mientras reemplaces el token viejo con el nuevo en el codigo. Obviamente yo despues de publicar este post, cambiare mi token para evitar cosas locas :u Copia y pega el token en un bloc de notas, y guardalo en un lugar seguro, ya que mas adelante en este post nos servira para poder terminar el bot. ============================================================================= Paso 3) Programando Ahora para poder empezar a programar el bot, necesitamos descargar el Node.JS una plataforma que nos permitira ejecutar el codigo Javascript en nuestra PC, lo puedes descargar accediendo a su pagina oficial: https://nodejs.org/en/download/current Escojemos la version de bits que nosotros poseemos en nuestra PC, 32 o 64 bits ============================================================================= ¿Como se si tengo una PC de 32 o 64 bits? Paso 1) Haz clic derecho sobre "Equipo" en el menu Inicio, y selecciona Propiedades Paso 2) Se abrira una nueva ventana donde en la seccion que dice "Tipo de Sistema" podras ver si es de 32 bits o 64 bits ============================================================================= Ahora que ya sabemos que nuestra PC es de 32 bits (en mi caso), escojemos la version de 32 bits La descarga del Node.js, pesa solo 15MB, para instalarlo, solo hagan doble clic sobre el archivo .msi Probablemente les aparezca la siguiente ventana, donde tenemos que poner en ejecutar, para poder iniciar la instalacion Y empezamos a instalar: Desafortunadamente, yo no puedo instalarlo porque ya lo tengo instalado, pero es muy sencilla la instalacion, solo instalenlo como si fuera un programa cualquiera. Bien, una vez instalado, nos creamos una nueva carpeta en un lugar facil de acceder, procura que esta carpeta este vacia, y no contenga simbolos ni espacios en el nombre. Y en un espacio vacio de la carpeta, pulsamos CTRL + SHIFT y mientras lo mantenemos pulsado hacemos clic derecho para abrir el menu contextualy seleccionamos la opcion que dice "Abrir ventana de comandos aqui": Para el dolubo que no sepa cual es la tecla SHIFT, esta es: Una vez hecho esto, se nos abrira el siguiente CMD o consola de comandos: Ahora escribimos lo siguiente: "npm init" (Sin las comillas) Nos preguntara el nombre de nuestra App, vamos a escribir el nombre pero sin usar Mayusculas! Yo le pondre el nombre de mi bot, osea "testingbot" sin las mayusculas y pulsamos Enter para enviar la respuesta, para el que no sepa cual es el enter, esta es (la que esta marcada en azul): Luego nos preguntara la version de nuestra app, por defecto esta en 1.0.0, lo dejaremos asi nomas y pulsamos Enter, para dejar vacio esa parte. Nos pedira que describamos nuestra app, si es necesario no pongan nada, es solo referencial, pulsamos Enter. Ahora nos pedira un "entry point", este es el archivo principal de la aplicacion que node manejara, por defecto esta en "index.js" asi que lo dejamos asi no mas y pulsamos Enter. Nos pedira un "test command" o comando de prueba, no ponemos nada, solo pulsamos Enter. Nos pedira un repositorio GIT, para el que no sepa que carajo es esto, es un lugar donde los deveopers o ("programadores" suben su codigo publicamente y las personas son libres de contribuir con su granito de arena en el codigo, esto solo es opcional, a menos de que despues quieras compartir el codigo en busca de ayuda En mi caso lo dejare vacio, y pulsamos Enter Nos pedira palabras clave o "keywords" para identificar nuestro proyecto, lo dejamos en blanco y continuamos Ahora nos pedira el autor de la aplicacion, nosotros ponemos ahi nuestro nombre o nuestro username Ahora nos pedira una licencia, no se preocupen, esta seria la licencia que estara bajo nuestro proyecto, en si, el node.js es gratis xd Por defecto, esta puesto en "ISC", asi que lo dejamos en blanco y continuamos con Enter Finalmente nos preguntara si deseamos escribir los datos de la nueva aplicacion, decimos que "yes" y pulsamos Enter para escribir los cambios Y ya habremos terminado la plantilla de nuestra app Ahora instalaremos la libreria discord.js en nuestro proyecto, que es indispensable para el funcionamiento de nuestro bot, asi que ejecutaremos el comando "npm install discord.js --save" (sin las comillas) y pulsamos enter para ejecutar el comando Esperamos unos minutos hasta que se descargue la libreria (unos 20kb) en la carpeta. el resultado final, seria similar a esto: Si volvemos a la carpeta, encontraremos que ya no esta vacia, y hay nuevos archivos: Ahora abriremos un nuevo bloc de notas, y seleccionaremos Archivo > Guardar Como.... En la lista desplegable de "Tipo: " seleccionaremos "Todos los Archivos (*.*) y de nombre le ponemos "index.js" (sin las comillas) y lo guardamos junto con los demas archivos de la carpeta. El resultado final del proceso seria este: Bueno, en el archivo index.js, sera su bot, ahi podran programar todo su comportamiento, y el responsable principal de su funcionamiento, el archivo esta algo vacio, asi que vamos a empezar a programar (No te olvides de terminar cada linea de codigo con un punto y coma ";" El console.log, es para enviar el texto entrecomillado a la consola desde donde lo ejecutemos, en este caso, cuando se ejecute el bot, imprimira en la consola "El bot esta listo para bardear" Crearemos una constancia, llamada Discord, que requiera el modulo "discord.js" Crearemos otra constancia mas en otra linea llamada "bot", esta disparara un nuevo cliente de Discord, "Discord.Client()" Vamos a crear un nuevo evento llamado "message" dentro de este evento va a ir todo las acciones que el bot hara durante su rutina, si habras notado, he dejado una linea vacia entre las lineas que conforman el evento, a esta linea vacia le presionaremos solamente una vez el TAB (ya que estamos en prescensia de corchetes xd) Para el que no sepa cual es el TAB, este es: El resultado de la linea masomenos seria este: Ahora, podremos escribir las ordenes o actividades que hara el bot, primero que nada, vamos a hacer que el bot diga algo cuando detecte una palabra o frase en el chat, asi que haremos una sentencia "if" Donde message.content, se refiere a la funcion para capturar los mensajes de todos los canales en donde esta unido el bot, y entre comillas, ponemos la palabra que disparara la accion a continuacion, "hola" Ahora, debemos especificarle al bot lo que va a hacer cuando detecte la palabra, asi que abrimos una nueva linea con ENTER, como pusimos corchetes despues de la sentencia "if", debemos presionar el TAB 2 veces para escribir la accion a tomar, asi: Ahora, escribiremos la accion a tomar: Donde message.channel.sendMessage, es para enviar un mensaje de texto por el mismo canal donde se detecto la palabra configurada en el "if" de arriba, y entre comillas, escribimos el mensaje que nuestro bot respondera a esa accion. Ahora, en otra linea, pulsaremos TAB una sola vez y pondremos un corchete para cerrar la sentencia if Ahora ya especificamos todo lo que hara el bot, pero se nos olvido especificar a que cuenta de discord debe acceder, por lo que debajo de todo, abriremos una nueva linea, y pondremos lo siguiente: Espero que hayas guardado el token de tu bot, porque entre las comillas, deberas reemplazar el texto, por el token. Quedando asi: ============================================================================== Paso 4) Encendiendo el bot: Bien, llego el momento de la prueba de fuego, llego el momento de hacer andar nuestro preciado bot. Asi que guardaremos todos los cambios que hicimos en el archivo index.js... Y volvemos a la consola y escribimos "node ." (sin las comillas) para ejecutar el archivo .js, y por consiguiente el bot. Sabras que el bot ya esta listo cuando la funcion console.log, haga efecto: Si volvemos a discord, veremos que nuestro bot ya esta online: Ahora, escribiremos "hola" para ver si el bot nos puede responder.... Exito!!! Nuestro bot esta listo y completamente funcional! ============================================================================== Paso 5) Modificando el codigoy agregando mas funciones Si necesitas modificar el codigo para agregar mas funciones por ej, detectar mas frases, hacer funciones en javascript utiles, o para solucionar bugs, el bot siempre se tiene que reiniciar para que tome los cambios mas recientes, veamos un ejemplo: A) Modificamos el codigo actual con mas funciones: B) Vamos a la consola y pulsamos la combinacion de teclas, CTRL+C para finalizar la ejecuccion del codigo y luego escribimos de nuevo "node ." para encenderlo de nuevo... Para el que no sepa como se hace el CTRL + C.... C) Probamos lo nuevo que pusimos: ============================================================================== Paso 6) Funciones de Javascript El bot es tambien compatible con ciertas funciones de javascript ajenas a discord.js, vamos a hacer que el bot tire un numero random: A) Escribimos el codigo Las funciones de Math, de javascript son perfectas para la ocasion B) Guardamos el archivo y reiniciamos el bot xd y listo, ahora tu bot tiene una funcion para tirar numeros random del 1 al 100 Y eso es todo amiguis, el mundo de javascript es bastante finito en posibilidades, por lo que el unico limite es su imaginacion para lograrlo, a continuacion les dejo la wiki de discord.js donde encontraran todas las funciones que ofrece discord.js Wiki de discord.js: https://discord.js.org/#/docs/main/stable/general/welcome Y eso es todo papus, nos vemos en otro post, deje sus +10 que esto si que es inteligencia colectiva en su esplendor, y eso Tambien, si quieres participar de una comunidad de taringueros re piolas, te esperamos en nuestro server de discord, Anarko, donde podras consultarme directamente en caso que tengas alguna duda y de paso te podes divertir a lo maximo Link de invitacion: https://discord.gg/RkQNv8q Hasta la proxima!!!