Inicio rápido

Esta página proporciona una breve introducción a la librería. Se asume que tiene la librería instalada, si no es así, eche un vistazo a la sección de Instalación.

Un pequeño Bot

Vamos a guiarte a crear un bot que responda a un mensaje específico.

Se parece a esto:

import disnake

client = disnake.Client()

@client.event
async def on_ready():
    print(f'We have logged in as {client.user}')

@client.event
async def on_message(message):
    if message.author == client.user:
        return

    if message.content.startswith('$hello'):
        await message.channel.send('Hello!')

client.run('your token here')

Llamemos a este archivo example_bot.py. Asegúrate de no llamarlo disnake, ya que tendrá conflicto con la librería.

Hay muchas cosas que hacer aquí, así que vamos a explicarlo paso a paso.

  1. La primera línea importa la librería, si esto genera un error ModuleNotFoundError o ImportError, entonces diríjase a la sección de Instalación para instalarlo correctamente.

  2. A continuación, creamos una instancia de un Client. Este cliente es nuestra conexión a Discord.

  3. Luego utilizamos el decorador Client.event() para registrar un evento. Esta librería tiene muchos eventos. Como esta librería es asíncrona, hacemos las cosas al estilo «callback»

    Un callback es esencialmente una función que es llamada cuando algo sucede. En nuestro caso, el evento on_ready() es llamado cuando el bot ha terminado de iniciar sesión y configurar las cosas, y el evento on_message() es llamado cuando el bot ha recibido un mensaje.

  4. Dado que el evento on_message() se ejecuta para cada mensaje recibido, tenemos que asegurarnos de que ignoramos los mensajes de nosotros mismos. Lo hacemos comprobando si Message.author es el mismo que el Client.user.

  5. Después, comprobamos si el Message.content empieza con '$hello'. Si es así, entonces enviamos un mensaje en el canal en el que se utilizó con Hello!. Esta es una forma básica de manejar los comandos, que puede ser automatizada posteriormente con el framework disnake.ext.commands – Bot commands framework.

  6. Finalmente, ejecutamos el bot con nuestro token de acceso. Si necesita ayuda para conseguir su token o crear un bot, eche un vistazo a la sección Creating a Bot Account.

Ahora que hemos creado un bot, tenemos que ejecutar el bot. Por suerte esto es simple, ya que se trata de un script de Python, podemos ejecutarlo directamente.

En Windows:

$ py -3 example_bot.py

En otros sistemas operativos:

$ python3 example_bot.py

Ahora puede probar a jugar con su bot básico.