Javascript/FDIeSports_Discord_bot/README.md
2021-11-19 14:02:26 +01:00

4.0 KiB

FDIeSports_Discord_bot 🤖

Índice

  1. Descripción
  2. Autor
  3. Advertencia
  4. Generar un token para tu bot
  5. Añadir el Bot a tu servidor de Discord
  6. Ejecución
  1. Licencia

1. Descripción 📖

Bot de Discord para la Asociación Diskobolo de la Facultad de Informática de la Universidad Complutense de Madrid.


2. Autor ✒️

Fernando Méndez (https:/fermdez.ddns.net | @HumperCobra)


3. Advertencia ⚠️

Desbes generar tu propio token para el bot y añadirlo a "BOT_TOKEN" : "AQUÍ_A_TU_TOKEN" en el archivo config.json.


4. Generar un token para tu bot 💰

  1. Entra en: https://discord.com/developers/applications/
  2. Haz click en New Application.
  3. Añade un nombre para el bot y pulsa en Create.
  4. En la pestaña de Bot, pulsamos en Add Bot y hacemos click en Yes, do it!.
  5. Aquí podremos copiar el Token del Bot, pulsando en Copy.

5. Añadir el Bot al servidor 🖥️

  1. Continuando desde la página que estábamos en el paso anterior, pulsar en OAuth2.
  2. En SCOPES selecionar bot.
  3. En BOT PERMISSIONS seleccionar Administrator
  4. Hacemos click en Copy y pegamos el enlace generado en el navegador con nuestra cuenta de discord iniciada.
  5. Seleccionamos el servidor al que queremos añadir el bot.

6. Ejecución 🛠️

6.1 Instalación node_modules 🔧

  1. Creamos un directorio para el bot y guardamos ahí el archivo bot.js.
  2. Creamos el archivo config.json, donde escribimos el Token del Bot, con el siguente formato:
      {
          "BOT_TOKEN" : "TOKEN_DE_TU_BOT",
      }
    
  3. Instalar node.js
  • En Windows/Mac: https://nodejs.org/es/download/.
  • Si tienes Linux (Debian/Ubuntu), usa los siguientes comandos:
      $ sudo apt-get update
      $ sudo apt-get upgrade
      $ sudo apt-get install curl
    
      $ cd ~
      $ curl -sL https://deb.nodesource.com/setup_16.x | sudo -E bash -
    
      $ sudo apt-get install -y nodejs
    
      $ cd ./ruta_del_directorio_del_bot/
      $ npm install
    
  1. Comprobar que se ha instalado con el comando:
  >/$ node --version
  1. Dentro del directorio del bot, ejecutar los siguientes comandos:
  >/$ npm init --yes
  >/$ npm install discord.js
  1. Comprobar que se ha generado el directorio node_modules.

6.2 Poner el Bot en producción ⚙️

6.2.1 En Windows 💻

 > cd ./ruta_del_directorio_del_bot/
 > node bot.js
  • El proceso se puede automatizar creando un archivo .bat y añadiéndolo al programador de tareas.

6.2.2 En Linux (Debian/Ubuntu) 🐧

  • Instalamos nodejs, si no lo hicimos en el punto anterior:
 $ sudo apt-get update
 $ sudo apt-get upgrade
 $ sudo apt-get install curl

 $ cd ~
 $ curl -sL https://deb.nodesource.com/setup_16.x | sudo -E bash -

 $ sudo apt-get install -y nodejs

 $ cd ./ruta_del_directorio_del_bot/
 $ npm install
  • Ejecutamos el bot con el comando:
  $ node bot.js
  • El proceso se puede automatizar creando un script.

6.3 Añadir nuevas librerías 📚

  • Primero abrir un terminal/PowerShell/CMD (dependiendo de nuestro SO) e ir al directorio de nuestro bot:
    cd ./ruta_del_directorio_del_bot/
    
  • Si por ejemplo queremos añadir la librería weather-js, deberemos escribir el siguiente comando:
    npm install weather-js
    

7. Licencia 📄

Educational Community License v2.0 (ECL-2.0).