Skip to content

Latest commit

 

History

History
115 lines (84 loc) · 3.87 KB

README.md

File metadata and controls

115 lines (84 loc) · 3.87 KB

DiscordBot

Bot de prueba desarrollado en JavaScript usando las dependencias de 'discord.js' -> Tutorial

Instalación y Configuración

Prerrequisitos:

  • Node.js y npm (o yarn): Asegúrate de tener instaladas las últimas versiones de Node.js y npm (o yarn), que son los gestores de paquetes de JavaScript necesarios para ejecutar el proyecto.
  • Cuenta de Desarrollador de Discord: Necesitarás una cuenta en el portal de desarrolladores de Discord para crear un bot y obtener un token.

Clonación del Repositorio

git clone https://github.com/krisMG21/DiscordBot

Instalación de Dependencias

Una vez clonado el repositorio, navega hasta el directorio del proyecto y ejecuta el siguiente comando para instalar las dependencias listadas en el archivo package.json: (Esto instala en el directorio las librerías de Node.js y discord.js, pero nos quita de tener que subirlas a github)

npm install

Configuración del Token de Bot

El token de acceso al bot, se encuentra dentro de un archivo de entorno .env privado.

process.env:

DISCORD_TOKEN = token_privado_del_bot

¿Cómo funciona Discord.js?

Discord.js es una biblioteca de Node.js que facilita la creación de bots para Discord. Proporciona una interfaz intuitiva para interactuar con la API de Discord, permitiendo a los desarrolladores gestionar eventos, mensajes, usuarios y servidores de manera sencilla.

Componentes clave de Discord.js

  • Client: Representa una conexión a Discord. Es el punto de entrada para todas las interacciones con la API.

  • Intents: Definen los eventos a los que el bot se suscribirá. Por ejemplo, puedes suscribirte a eventos de mensajes, reacciones, miembros que se unen, etc.

  • Guilds: Representan los servidores de Discord.

  • Channels: Representan los canales de texto, voz y categorías dentro de un servidor.

  • Users: Representan a los usuarios de Discord.

  • Messages: Representan los mensajes de texto enviados en los canales.

Interacción entre componentes

  • Creación del Client: Se crea una instancia de Client para establecer una conexión con Discord. Ej:

    // index.js
const client = new Client({ intents: [GatewayIntentBits.Guilds] });

  • Suscripción a Eventos: Se utilizan los métodos on o once del Client para suscribirse a eventos específicos. Por ejemplo, client.on('messageCreate', (message) => { ... }) se ejecutará cada vez que se envíe un nuevo mensaje. ej:

    // index.js
client.once(Events.ClientReady, readyClient => {
    console.log(`Ready! Logged in as ${readyClient.user.tag}`);
});

  • Manejo de Eventos: Dentro de los manejadores de eventos, se puede acceder a información relevante como el autor del mensaje, el contenido del mensaje, el canal donde se envió, etc.

    // ../commands/utility/user.js
async execute(interaction) {
    // interaction.user is the object representing the User who ran the command
    // interaction.member is the GuildMember object, which represents the user
    // in the context of the Guild
    await interaction.reply(`This command was run by ${interaction.user.username},
    who is currently in ${interaction.member.guild.name}.`);
},

  • Interacción con la API: Discord.js proporciona métodos para realizar diversas acciones, como enviar mensajes, crear roles, modificar canales, etc.

Contribuyendo

Si deseas contribuir a este proyecto, por favor, sigue estas pautas:

  • Haz fork del repositorio: Crea una copia del repositorio en tu cuenta de GitHub.
  • Crea una rama: Crea una nueva rama para tus cambios.
  • Realiza tus cambios: Edita los archivos y agrega las nuevas funcionalidades.
  • Envía una pull request: Describe claramente los cambios que has realizado y por qué son útiles.