Создание простого Discord бота с помощью библиотеки discord.py
Асинхронная библиотека discord.py содержит все что нужно для бота, с помощью нее даже можно работать с голосовыми каналами сервера. В этой статье я расскажу как создать простенького бота для вашего discord сервера.
Получение токена и Client ID для вашего бота
Для получения токена и ID бота небходимо создать свое приложение и в разделе General Information скопировать Client ID.
А в разделе настроек создать бота и скопировать его токен. Задача не сложная, думаю все с этим справятся.
Собственно пишем бота
Устанавливаем discord.py с помощью pip:
После успешной установки создаем файл bot.py, где будем писать бота.
Импортируем все необходимое:
Создаем переменную с вашим токеном, про который я писал выше:
Для начала сделаем простенькую команду, аргумент которой бот будет просто пересылать:
И в конце запускаем бота с вашим токеном:
В итоге должно получится вот такое:
Теперь необходимо добавить бота на сервер. Сделать это можно с помощью ссылки:
Число необходимых прав можно получить в разделе настроек бота.
Теперь можно запускать бота:
После нескольких секунд, можно заметить его в сети:
И наконец-то попробовать отправить команду:
Заключение
Вот так можно легко запустить у себя на сервере бота. Как можно заметить библиотека делает практически все за тебя и остается только добавлять свой функционал с использованием python. В следующий раз я покажу как следить за событиями, подключатся к голосовым каналам (избегая проблем с linux и Windows), использовать роли и права участников и другое.
Создание Discord-бота на Python. Часть 1
Версия Python: 3.8.2
Версия discord.py: 1.3.3
Приветствую, хабровчане и другие пользователи интернета. Сегодня я начну цикл статей, посвящённых созданию Discord-бота с помощью библиотеки discord.py. Мы рассмотрим создание как и примитивного бота, как и «продвинутого» бота с модулями. В этой статье мы сделаем стандартную команду и ещё одну небольшую команду. Начнём!
Создание бота и получение токена
Для того, чтобы добавить бота на сервер нужно создать свое приложение и во вкладке General Information скопировать Client ID.
Здесь заменяем CLID на ранее скопированный Client ID.
Во вкладке Bot создаём бота и копируем токен.
Написание кода
Устанавливаем саму библиотеку.
Создаём файл config.py (так удобнее), и создаём там словарь.
Создаём main-файл, название может быть любое.
Импортируем библиотеки и наш файл конфига:
Создаём «тело» бота, название может быть любое:
Начинаем писать основной код.
В конце запускаем бота с помощью:
Должно получится так:
Бонусный туториал!
Сделаем вывод случайных картинок с лисами
Для этого импортируем еще пару библиотек:
Приступим к написанию команды.
Должно получится так:
Конец
На этом 1 часть закончена. Скоро будет опубликована 2 часть.
Discord бот на Python
В данной статье мы создадим Discord бот, используя при этом только Python.
Краткая информация о Discord для тех, кто еще о нем не знает
Discord — это, фактически, универсальная платформа голосового и текстового общения для геймеров.
Игроки, стримеры, студенты и разработчики используют Discord, чтобы обсуждать игры, отвечать на вопросы, общаться в чате во время игры в хорошем качестве, в том числе с членами своей команды. В нем даже есть игровой магазин с критическими отзывами и возможностью подписки. По сути, это центр игровых сообществ.
Хотя есть много вещей, которые вы можете создать с помощью API Discord, в этом руководстве мы остановимся на создании бота на Python.
Необходимые приготовления
Чтобы создать Discord бот, вам понадобится:
Что такое боты?
Бот (сокращение от «робот») — это программа, которая выполняет автоматические, повторяющиеся и заранее определенные задачи. Боты обычно имитируют человеческое поведение или подменяют его. Поскольку все их действия автоматизированы, они работают намного быстрее, чем обычные пользователи.
Боты очень часто используются для ответов на типовые вопросы, возникающие в различных сообществах. Они действуют как своего рода представители человека для выполнения различных функций. Основной особенностью такого бота является то, что он устраняет необходимость вручную отвечать каждому участнику и полностью автоматизирует данный процесс.
Для чего нужны чат-боты
Автоматизация ответов на основные вопросы
В любой области деятельности всегда есть вопросы, которые пользователи задают чаще всего. И на эти вопросы каждый раз надо давать одни и те же ответы. Лучшее решение в таком случае — чат-бот.
Ускорение рабочих процессов
Чат-боты, в отличии от людей, никогда не устают. Все люди могут работать только ограниченный период времени, в то время как у ботов таких ограничений нет. Использование чат-ботов в бизнесе хорошо дополняет работу людей, повышает производительность труда и сокращает человеческий труд.
Экономия денег и времени
При правильном использовании дружелюбного чат-бота привлечение клиентов происходит с минимальными затратами и максимальной эффективностью.
Марк Лутц «Изучаем Python»
Скачивайте книгу у нас в телеграм
Пишем код для чат-бота
Сперва убедитесь, что на вашем компьютере установлен Python. Если его еще нет, то загрузите его с официального сайта.
Среду программирования можно использовать любую, какая вам больше нравится. Например, PyCharm, VS Code или Sublime.
Теперь выберите опцию New application (новое приложение) в правом верхнем углу страницы и дайте вашему новому приложению имя. Как видите, можно даже добавить изображение к аватару вашего бота. Мы можем сделать это позже. Сейчас пойдем в раздел Bot (на странице слева) и выберем опцию Add bot (добавить бота).
Затем откройте ссылку под секцией scope в новом окне и выберите сервер, на котором вы желаете видеть ваш бот.
Для этого введем следующую команду:
Основная задача нашего тестового бота будет состоять в том, чтобы давать ответ всем пользователям на их сообщение «Hello». Но вы, конечно, можете его настроить в соответствии с вашими потребностями.
Для начала импортируем необходимые библиотеки:
Создадим переменную Client :
Напишем следующий код для определения статуса бота:
Это сообщение будет отображаться всякий раз, когда вы размещаете своего бота в сети. Вы также можете проверить статус бота из самого Discord.
Это сообщение подтверждает, что наш бот готов к использованию на сервере.
Теперь, когда бот готов к работе, мы можем ответить пользователям на их приветствие hello :
Для запуска бота нам понадобится токен. Он находится в разделе Bot на сайте Discord. Мы заходили туда при создании бота.
Теперь настало время запустить нашего бота!
Откройте CMD и наберите следующую команду:
Если так не выходит, то наберите вот это:
Точно таким же образом пишем бот для приветствия новых участников:
Возможные проблемы при создании бота
Все может быть не так просто, как это кажется на первый взгляд. Вы обязательно должны помнить о проблемах, с которыми можете столкнуться при создании бота. Некоторые из них мы перечислили ниже:
Заключение
Мы рассмотрели, как создать Discord бот на Python. Разумеется, это был простейший бот. Но вы, конечно же, можете написать свой собственный код и добавить множество различных функций, например OCR.
Как сделать Discord Bot в Python
В этом уроке вы узнаете, как создать бот Discord на Python, чтобы вы могли максимально использовать эту фантастическую платформу.
В мире, где видеоигры так важны для многих людей, жизненно важно общение и общение вокруг игр. Discord предлагает как те, так и другие, в одной хорошо продуманной упаковке. В этом уроке вы узнаете, как создать бот Discord на Python, чтобы вы могли максимально использовать эту фантастическую платформу.
К концу этой статьи вы узнаете:
Вы начнете с изучения, что такое Discord и почему это ценно.
Что такое Discord?
Discord – это голосовая и текстовая коммуникационная платформа для геймеров.
Игроки, стримеры и разработчики используют Discord для обсуждения игр, ответов на вопросы, общения в чате и многого другого. Здесь даже есть игровой магазин с критическими отзывами и сервисом подписки. Это почти универсальный магазин для игровых сообществ.
Что такое бот?
Dicord растет в популярности. Таким образом, автоматизированные процессы, такие как запрет несоответствующих пользователей и реагирование на запросы пользователей, жизненно важны для процветания и развития сообщества.
Например, допустим, вы управляете новой гильдией Discord, и пользователь присоединяется впервые. Возбужденный, вы можете лично обратиться к этому пользователю и приветствовать его в своем сообществе. Вы также можете рассказать им о своих каналах или попросить их представиться.
Пользователь чувствует себя желанным гостем и получает удовольствие от обсуждений, происходящих в вашей гильдии, а они, в свою очередь, приглашают друзей.
Со временем ваше сообщество становится настолько большим, что больше не представляется возможным лично связаться с каждым новым участником, но вы все равно хотите отправить им что-нибудь, чтобы признать их новым членом гильдии.
С ботом можно автоматически реагировать на присоединение нового члена вашей гильдии. Вы даже можете настроить его поведение в зависимости от контекста и контролировать его взаимодействие с каждым новым пользователем.
Это здорово, но это только один маленький пример того, как бот может быть полезен. У вас так много возможностей для творчества с ботами, если вы знаете, как их создавать.
Примечание. Хотя Discord позволяет создавать ботов, которые имеют дело с голосовой связью, эта статья будет придерживаться текстовой части сервиса.
Есть два ключевых шага при создании бота:
Как сделать Discord Bot на портале для разработчиков
Прежде чем вы сможете погрузиться в любой код Python для обработки событий и создания захватывающих автоматизаций, вам необходимо сначала создать несколько компонентов Discord:
Вы узнаете больше о каждой части в следующих разделах.
Создав все эти компоненты, вы свяжете их вместе, зарегистрировав бота в своей гильдии.
Создание учетной записи Discord
Первое, что вы увидите, это целевая страница, на которой вам нужно будет либо авторизоваться, если у вас уже есть аккаунт, либо создать новый аккаунт:
Если вам необходимо создать новую учетную запись, нажмите кнопку « Регистрация» под кнопкой « Войти» и введите данные своей учетной записи.
Важно: вам нужно будет подтвердить свою электронную почту, прежде чем вы сможете двигаться дальше.
Когда вы закончите, вы будете перенаправлены на домашнюю страницу портала разработчика, где вы создадите свое приложение.
Создание приложения
Чтобы создать новое приложение, выберите « Новое приложение» :
Далее вам будет предложено назвать ваше приложение. Выберите имя и нажмите « Создать» :
Поздравляем! Вы сделали заявку Discord. На появившемся экране вы можете увидеть информацию о вашем приложении:
Имейте в виду, что любая программа, взаимодействующая с API-интерфейсом Discord, требует приложения Discord, а не только ботов. API-интерфейсы, связанные с ботами, являются лишь частью общего интерфейса Discord.
Однако, поскольку в этом руководстве рассказывается, как создать бот Discord, перейдите на вкладку Bot в левом списке навигации.
Создание бота
Как вы узнали из предыдущих разделов, пользователь бота – тот, кто слушает и автоматически реагирует на определенные события и команды в Discord.
Чтобы ваш код действительно отображался в Discord, вам нужно создать пользователя бота. Для этого выберите Добавить бота :
Как только вы подтвердите, что хотите добавить бота в свое приложение, вы увидите нового пользователя бота на портале:
Теперь бот готов и готов к работе, но куда?
Пользователь бота бесполезен, если он не взаимодействует с другими пользователями. Далее вы создадите гильдию, чтобы ваш бот мог взаимодействовать с другими пользователями.
Создание гильдии
Примечание. Хотя гильдия и сервер взаимозаменяемы, в данной статье термин « гильдия» будет использоваться главным образом потому, что API придерживаются одного и того же термина. Термин сервер будет использоваться только при обращении к гильдии в графическом интерфейсе.
Например, скажем, вы хотите создать пространство, где пользователи могут собираться вместе и рассказывать о вашей последней игре. Вы бы начали с создания гильдии. Тогда в вашей гильдии у вас может быть несколько каналов, таких как:
Создав свою гильдию, вы пригласите других пользователей заполнить ее.
Итак, чтобы создать гильдию, зайдите на домашнюю страницу Discord :
На этой домашней странице вы можете просматривать и добавлять друзей, личные сообщения и гильдии. Отсюда выберите значок + в левой части веб-страницы, чтобы добавить сервер :
Когда вы закончите создание своей гильдии, вы сможете увидеть пользователей справа и каналы слева:
Последний шаг на Discord – регистрация вашего бота в вашей новой гильдии.
Добавление бота в гильдию
Бот не может принимать приглашения, как обычный пользователь. Вместо этого вы добавите своего бота, используя протокол OAuth2.
Техническая деталь: OAuth2 – это протокол для работы с авторизацией, где служба может предоставить клиентскому приложению ограниченный доступ на основе учетных данных приложения и разрешенных областей.
Для этого вернитесь на портал разработчика и выберите страницу OAuth2 на левой навигационной панели:
В этом окне вы увидите Генератор URL OAuth2.
Этот инструмент генерирует URL-адрес авторизации, который обращается к API-интерфейсу Discord OAuth2 и авторизует доступ к API с использованием учетных данных вашего приложения.
В этом случае вы захотите предоставить пользователю бота вашего приложения доступ к API Discord с использованием учетных данных OAuth2 вашего приложения.
Теперь Discord сгенерировал URL авторизации вашего приложения с выбранной областью и разрешениями.
Отказ от ответственности: хотя мы используем Администратора для целей этого учебного пособия, вы должны быть максимально детализированы при предоставлении разрешений в реальных приложениях.
Выберите « Копировать» рядом с URL-адресом, который был сгенерирован для вас, вставьте его в браузер и выберите свою гильдию в раскрывающемся списке:
Примечание: вы можете получить reCAPTCHA, прежде чем двигаться дальше. Если это так, вам нужно доказать, что вы человек.
Если вы вернетесь в свою гильдию, то увидите, что бот был добавлен:
В итоге вы создали:
Теперь вы знаете, как создать бот Discord с помощью портала разработчика. Далее идут забавные вещи: реализация вашего бота на Python!
Как сделать Discord Bot в Python
Начните с установки discord.py с pip :
Создание Discord Connection
Первым шагом в реализации вашего бота является создание подключения к Discord. С помощью discord.py этого вы создаете экземпляр Client :
A Client – это объект, представляющий связь с Discord. A Client обрабатывает события, отслеживает состояние и обычно взаимодействует с API-интерфейсами Discord.
Здесь вы создали Client и реализовали его on_ready() обработчик событий, который обрабатывает событие, когда Client он установил соединение с Discord и завершил подготовку данных, отправленных Discord, таких как состояние входа в систему, данные гильдии и канала и т. Д.
Другими словами, on_ready() будет вызван (и ваше сообщение будет напечатано), как только client будет готов к дальнейшим действиям. Вы узнаете больше о обработчиках событий позже в этой статье.
Когда вы работаете с такими секретами, как токен Discord, рекомендуется записать его в свою программу из переменной среды. Использование переменных среды помогает вам:
Вам нужно заменить
Установить dotenv с помощью pip :
Наконец, client.run() запускается ваш Client токен вашего бота.
Взаимодействие с API Discord
Например, предположим, что вы хотели записать имя и идентификатор гильдии, в которой вы зарегистрировали своего бота, на консоль.
Сначала вам нужно добавить новую переменную среды:
Не забывайте, что вам нужно заменить два заполнителя фактическими значениями:
Примечание. Несмотря на то, что в этом уроке вы можете быть уверены, что ваш бот подключен только к одной гильдии (так client.guilds[0] будет проще), важно понимать, что пользователь бота может быть подключен ко многим гильдиям.
Следовательно, более надежное решение состоит в том, чтобы просмотреть client.guilds то, что вы ищете.
Запустите программу, чтобы увидеть результаты:
Большой! Вы можете увидеть имя вашего бота, имя вашего сервера и идентификационный номер сервера.
Еще одна интересная часть данных, которую вы можете извлечь из гильдии, это список пользователей, которые являются членами гильдии:
Когда вы запустите программу, вы должны увидеть хотя бы имя учетной записи, с которой вы создали гильдию, и имя самого пользователя бота:
Эти примеры едва касаются поверхности API, доступных на Discord, обязательно ознакомьтесь с их документацией, чтобы увидеть все, что они могут предложить.
Далее вы узнаете о некоторых служебных функциях и о том, как они могут упростить эти примеры.
Использование служебных функций
Давайте еще раз посмотрим на пример из последнего раздела, где вы напечатали имя и идентификатор гильдии бота:
discord.utils.find() это одна утилита, которая может улучшить простоту и удобочитаемость этого кода, заменив for цикл на интуитивно понятную абстрактную функцию:
В этом случае вы пытаетесь найти гильдию с тем же именем, которое вы сохранили в DISCORD_GUILD переменной среды. Найдя find() элемент в итерируемом объекте, который удовлетворяет предикату, он вернет элемент. Это по сути эквивалентно break утверждению в предыдущем примере, но чище.
discord.py даже абстрагировал эту концепцию на один шаг вперед с помощью get() утилиты :
get() принимает итерируемые и некоторые ключевые аргументы. Аргументы ключевого слова представляют атрибуты элементов в итерируемых элементах, которые должны быть удовлетворены для get() возврата элемента.
В этом примере вы указали name=GUILD атрибут, который должен быть удовлетворен.
Отвечая на события
Но что такое событие?
Используя пример, который вы уже видели, on_ready() обработчик событий обрабатывает событие, Client которое установило соединение с Discord и подготовило его данные ответа.
Есть два способа discord.py реализовать обработчик событий:
Вы уже видели реализацию с использованием декоратора. Далее рассмотрим, как создать подкласс Client :
Нет никакой разницы между двумя стилями реализации событий, но этот учебник будет в основном использовать версию декоратора, потому что он выглядит аналогично тому, как вы реализуете Bot команды, о чем мы немного поговорим.
Теперь, когда вы узнали, как создать обработчик событий, давайте рассмотрим несколько различных примеров обработчиков, которые вы можете создать.
Приветствуя новых людей
Ранее вы видели пример ответа на событие, когда член вступает в гильдию. В этом примере пользователь вашего бота может отправить им сообщение, приветствуя их в сообществе Discord.
Как и раньше, вы обрабатывали on_ready() событие, печатая имя пользователя бота в отформатированной строке. Новым, однако, является реализация on_member_join() обработчика событий.
await приостанавливает выполнение окружающей сопрограммы до тех пор, пока не завершится выполнение каждой сопрограммы.
Теперь давайте проверим новое поведение вашего бота.
Сначала запустите новую версию bot.py и подождите, пока on_ready() событие не сработает, записав ваше сообщение по адресу stdout :
Выберите Пригласить людей рядом со списком гильдий, где вы выбрали свою гильдию. Установите флажок Установить эту ссылку, чтобы никогда не истек и скопируйте ссылку:
Теперь, скопировав ссылку приглашения, создайте новую учетную запись и присоединитесь к гильдии, используя ссылку приглашения:
Во-первых, вы увидите, что Discord по умолчанию представил вас в гильдию с автоматическим сообщением. Что еще более важно, обратите внимание на значок в левой части экрана, который уведомляет вас о новом сообщении:
Когда вы выберете его, вы увидите личное сообщение от вашего пользователя бота:
Отлично! Ваш бот-пользователь теперь взаимодействует с другими пользователями с минимальным кодом.
Далее вы узнаете, как отвечать на конкретные сообщения пользователей в чате.
Отвечая на сообщения
Давайте добавим к предыдущей функциональности вашего бота, обработав on_message() событие.
on_message() происходит, когда сообщение публикуется на канале, к которому у вашего бота есть доступ. В этом примере вы ответите на сообщение ’99!’ одной строчкой из телешоу « Бруклинские девять-девять» :
Другая часть важна:
Поскольку Client невозможно определить разницу между пользователем бота и учетной записью обычного пользователя, ваш on_message() обработчик должен защитить от потенциально рекурсивного случая, когда бот отправляет сообщение, которое он сам может обработать.
Помимо потенциально спамовой природы этого обработчика событий, он также имеет разрушительный побочный эффект. Сообщение, которым отвечает бот, содержит то же сообщение, которое он собирается обработать!
Итак, если один человек на канале скажет другому «С Днем Рождения», тогда бот тоже включится… снова… и снова… и снова:
Вот почему важно сравнивать message.author их с client.user (пользователем вашего бота) и игнорировать любые его собственные сообщения.
Итак, давайте исправим bot.py :
Наконец, отправляйтесь в Discord, чтобы проверить это:
Большой! Теперь, когда вы увидели несколько различных способов обработки некоторых распространенных событий Discord, вы узнаете, как обращаться с ошибками, которые могут вызывать обработчики событий.
Обработка исключений
Новый raise-exception обработчик сообщений позволяет вам вызывать DiscordException команду включения.
Запустите программу и введите raise-exception в канал Discord:
Теперь вы должны увидеть, Exception что поднял ваш on_message() обработчик в консоли:
Итак, поскольку он on_message() принимает один аргумент, message мы ожидаем, args[0] что он будет message отправлен пользователем в канале Discord:
Запустите bot.py и отправьте raise-exception сообщение еще раз, чтобы просмотреть вывод в err.log :
Подключение бота
A Bot является подклассом, Client который добавляет немного дополнительной функциональности, которая полезна при создании пользователей ботов. Например, объект Bot может обрабатывать события и команды, вызывать проверки правильности и многое другое.
Как видите, Bot можете обрабатывать события так же, как это Client делают. Однако обратите внимание на различия между Client и Bot :
Использование Bot команд
В общем, команда – это порядок, который пользователь дает боту, чтобы он что-то делал. Команды отличаются от событий, потому что они:
Давайте посмотрим на старое событие, чтобы лучше понять, как оно выглядит:
Есть несколько важных характеристик, которые следует понимать при использовании Command :
A Context содержит данные, такие как канал и гильдия, которые пользователь вызвал Command из.
Теперь, когда ваш бот запущен, вы можете отправиться в Discord, чтобы опробовать новую команду:
С точки зрения пользователя, практическое отличие состоит в том, что префикс помогает формализовать команду, а не просто реагирует на конкретное on_message() событие.
Это дает и другие большие преимущества. Например, вы можете вызвать help команду, чтобы увидеть все команды, которые вы Bot обрабатываете:
Теперь, когда пользователь вызывает help команду, ваш бот представит описание вашей команды:
Имейте в виду, что все эти функции существуют только для Bot подкласса, но не для Client суперкласса.
Command имеет еще одну полезную функциональность: возможность использовать Converter для изменения типов своих аргументов.
Автоматическое преобразование параметров
Еще одним преимуществом использования команд является возможность преобразования параметров.
Иногда требуется, чтобы параметр был определенного типа, но аргументы Command функции по умолчанию являются строками. A Converter позволяет вам преобразовать эти параметры в тип, который вы ожидаете.
Например, если вы хотите создать Command для своего бота пользователя, который будет имитировать бросание костей (зная, что вы уже узнали), вы можете определить его так:
Вы решили roll принять два параметра:
Далее вы узнаете об Check объекте и о том, как он может улучшить ваши команды.
Проверка предикатов команд
A Check – это предикат, который оценивается перед выполнением a, Command чтобы гарантировать, что Context окружение Command вызова допустимо.
В предыдущем примере вы сделали нечто подобное, чтобы убедиться, что пользователь, отправивший сообщение, которое обрабатывает бот, сам не был пользователем бота:
commands Расширение предоставляет более чистое и более удобный механизм для выполнения такой проверки, а именно с использованием Check объектов.
Во-первых, вам нужно создать новую роль члена в администраторе. Зайдите в гильдию Discord и выберите меню <Имя сервера>→ Настройки сервера :
Затем выберите Роли из списка навигации слева:
Наконец, выберите знак + рядом с ROLES, введите имя admin и выберите Сохранить изменения :
Теперь вы создали admin роль, которую вы можете назначить конкретным пользователям. Далее вы обновитесь bot.py до Check роли пользователя, прежде чем позволить ему инициировать команду:
Вы также используете, discord.utils.get() чтобы не создавать канал с тем же именем, что и существующий канал.
Попробуйте все это снова, и вы должны увидеть ошибку в канале Discord:
Большой! Теперь, чтобы решить проблему, вам нужно дать себе роль администратора :
С ролью администратора ваш пользователь передаст Check и сможет создавать каналы с помощью команды.
Примечание. Помните, что для назначения роли у вашего пользователя должны быть правильные разрешения. Самый простой способ убедиться в этом – войти в систему с пользователем, с которым вы создали гильдию.
Также обратите внимание, что вы можете передать необязательный channel_name аргумент, чтобы присвоить каналу имя, которое вы хотите!
Вывод
Поздравляем! Теперь вы узнали, как создать бот Discord в Python. Вы можете создавать ботов для взаимодействия с пользователями в созданных вами гильдиях или даже ботов, которых другие пользователи могут приглашать для взаимодействия со своими сообществами. Ваши боты смогут отвечать на сообщения и команды и множество других событий.
В этом уроке вы узнали основы создания своего собственного бота Discord. Теперь вы знаете: