Создание 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
В этой статье мы создаем своего дискорд-бота на боксе с нуля.
Подготовка
Предварительные действия на боксе такие же, как и в нашей статье про Telegram:
Регистрация бота
Создание бота происходит в два этапа на сайте мессенджера. Сначала создаем приложение: «Разработчикам»(в футере) → «Applications», нажимаем кнопку «New Application» в правой верхней части страницы:
Выбираем имя приложения (выбирайте мудро, хоть его и можно изменить позже):
Готово. Здесь можно переименовать приложение, дать описание, загрузить аватарку:
Теперь добавим к нему бота. В меню слева вкладка «Bot» → «Add Bot» → «Yes, do it!».
Токен бота можно получить по кнопке Copy:
Если вдруг токен попал не только в ваши руки, его всегда можно заменить кнопкой Regenerate.
Добавление бота на сервер
Переходим на вкладку «OAuth2» и создаем для него свой URL для приглашения:
Чуть ниже выбираем права для бота. Если это бот для администрирования сервера, то можно, конечно, выбрать «Administrator», но нужно быть осторожными с этим.
Выдаем права, действительно нужные боту для администрирования сервера:
Теперь бота можно добавить на сервер. Копируем ссылку и открываем её в браузере. В диалоговом окне выбираем сервер:
Проверяем его привилегии:
Всё, бот на сервере:
Код бота
Активируем виртуальное окружение и ставим нужную библиотеку:
Добавляем директорию для бота, не выходя виртуального окружения:
Создаем конфиг бота:
Наполняем его содержимым
Дальше код бота. Создаем bot.py и сразу редактируем его vim’ом:
Первыми строками активируем виртуальное окружение и импортируем нужные модули:
Обозначаем боту, с какого символа начинаются его команды:
И создаем первую команду — бот будет отправлять реплай с текстом “I’M ALIVE!” на сообщение “!status”:
Добавляем в код функцию запуска:
Закрываем редактор и запускаем бота:
Отправим сообщение в Discord:
Запуск бота
Создаем Linux-демона — он будет следить, что бот работает. Открываем файл (mlg, если нужно, меняем на своё имя сервиса):
Добавляем в него строки:
И запускаем демона:
Проверить, что всё работает, можно так:
Дополнение кода бота
Бот улучшается в два этапа:
Для примера добавим в бота какое-нибудь рандомное API. Открываем файл бота:
И добавляем в него пару библиотек и ещё одну функцию обработки команд:
Закрываем файл и перезапускаем демона, чтобы изменения вступили в силу:
Результатом будет рандомный мем:
Готово! Боты в Discord умеют многое, и мы можем и дальше расширять его возможности, изучая документацию.
Как создать Discord бота с помощью Python
Из этого туториала Вы узнаете, как полностью создать собственного бота Discord в облаке.
Вам не нужно ничего устанавливать на свой компьютер, и вам не нужно ничего платить за размещение своего бота.
Мы будем использовать целый ряд инструментов, в том числе Discord API, библиотеки Python, и платформы облачных вычислений под названием Repl.it.
Как создать учетную запись Discord Bot
Чтобы работать с библиотекой Python и API Discord, мы должны сначала создать учетную запись Discord Bot.
Вот шаг к созданию учетной записи Discord Bot.
1. Убедитесь, что вы вошли на сайт Discord.
3. Щелкните кнопку «Новое приложение».
4. Дайте приложению имя и нажмите «Создать».
5. Перейдите на вкладку «Бот» и нажмите «Добавить бота». Вам нужно будет подтвердить действие, нажав «Yes, do it!»
Оставьте настройки по умолчанию для Public Bot и Require OAuth2 Code Grant.
Ваш бот создан. Следующим шагом будет копирование токена.
Этот токен является паролем вашего бота, поэтому не сообщайте его никому. Это может позволить кому-то войти в ваш бот и делать разные плохие вещи.
Вы можете регенерировать токен, если он случайно станет доступен.
Как пригласить вашего бота присоединиться к серверу
Теперь вам нужно подключить своего пользователя-бота к серверу. Для этого вы должны создать для него URL-адрес приглашения.
Перейдите на вкладку «OAuth2». Затем выберите «бот» в разделе «scopes».
Теперь выберите нужные разрешения для бота. Наш бот будет в основном использовать текстовые сообщения, поэтому нам не нужно много разрешений. Вам может потребоваться больше, в зависимости от того, что вы хотите, чтобы ваш бот делал. Будьте осторожны с разрешением «Администратор».
После выбора соответствующих разрешений нажмите кнопку «Copy» над разрешениями. Это скопирует URL-адрес, который можно использовать для добавления бота на сервер.
Вставьте URL-адрес в свой браузер, выберите сервер, на который будет приглашен бот, и нажмите «Авторизовать».
Чтобы добавить бота, вашей учетной записи необходимы разрешения «Управление сервером».
Теперь, когда вы создали пользователя-бота, мы начнем писать код Python для бота.
Как написать код для базового бота Discord с помощью библиотеки discord.py
Как создать реплику и установить disocrd.py
Создайте новый Repl и выберите «Python» в качестве языка.
Если вы предпочитаете кодировать бота локально, вы можете использовать эту команду в MacOS для установки discord.py:
Если вы используете Windows, вы должны вместо этого использовать следующую строку:
Как настроить события Discord для вашего бота
Сделаем бота, который отвечает на конкретное сообщение. Этот простой код бота вместе с объяснением кода взят из документации discord.py. Позже мы добавим в бота дополнительные функции.
Добавьте этот код в main.py. (Вы можете назвать файл как-нибудь иначе, только не discord.py.) Я вскоре объясню, что делает весь этот код.
Внутри файла добавьте следующую строку, включая ваш фактический токен, который вы скопировали ранее:
Теперь давайте рассмотрим, что делает каждая строка в коде вашего бота Discord.
У нас есть код для бота, поэтому теперь нам просто нужно его запустить.
Как запустить бота
Теперь нажмите кнопку запуска вверху, чтобы запустить своего бота в repl.it.
Если вы пишете бота локально, вы можете использовать эти команды в терминале для запуска бота:
Теперь перейдите в свою комнату в Discord и введите «$hello». Ваш бот должен ответить «Hello!».
Как улучшить бота
Теперь, когда у нас есть базовый бот, мы его улучшим. Не зря он называется «Encourage Bot».
Этот бот будет отвечать сообщением ‘Hello!’ всякий раз, когда кто-то отправляет сообщение, содержащее грустное или удручающее слово.
Любой желающий сможет добавить ободряющие сообщения для использования бота, а отправленные пользователем сообщения будут храниться в базе данных Repl.it.
Бот также вернет случайную вдохновляющую цитату из API, когда кто-то наберет в чате сообщение «$inspire».
Мы начнем с добавления функции «$inspire».
Как добавить в бота вдохновляющие цитаты
Мы будем получать вдохновляющие цитаты из API под названием zenquotes.io. Нам нужно импортировать еще пару модулей Python, добавить функцию get_quote() и обновить код нашего бота, чтобы вызвать функцию.
Вот обновленный код. После кода я объясню новые части.
Функция get_quote() очень проста. Во-первых, она использует модуль запросов для запроса данных из URL-адреса API. API возвращает случайную вдохновляющую цитату. Эту функцию можно легко переписать для получения котировок из другого API, если текущий перестанет работать.
Затем внутри функции мы используем json.loads() для преобразования ответа API в JSON. Методом проб и ошибок я понял, как перевести цитату из JSON в нужный строковый формат. Цитата возвращается из функции в виде строки.
Последняя часть кода обновляется ближе к концу. Ранее он искал сообщение, которое начиналось с «$hello». Теперь он ищет «$inspire». Вместо того, чтобы возвращать «Hello!», Он получает цитату quote = get_quote() и возвращает цитату.
На этом этапе вы можете запустить свой код и попробовать его.
Как добавить в бота обнадеживающие сообщения
Теперь мы реализуем функцию, при которой бот отвечает обнадеживающими сообщениями, когда пользователь отправляет сообщение с грустным словом.
Как добавить грустные слова в бота
Для начала нам нужно создать список Python, содержащий грустные слова, на которые будет отвечать бот.
Добавьте следующую строку после создания переменной client :
Не стесняйтесь добавлять в список больше слов.
Как добавить в бота обнадеживающие сообщения
Теперь мы добавим список ободряющих сообщений, которыми бот ответит.
Добавьте следующий список после созданного вами списка sad_words :
Как и раньше, не стесняйтесь добавлять в список другие фразы по вашему выбору. Сейчас я использую всего три элемента, потому что позже мы добавим возможность пользователям добавлять больше ободряющих фраз для использования ботом.
Как отвечать на сообщения
Вот обновленный код:
Это хорошее время для тестирования бота. Теперь вы знаете достаточно, чтобы создать собственного бота.
Пишем Discord бота на Python используя фреймворк discord.ext
Сегодня мы создадим Discord бота на Python, для этого не надо прикладывать каких то фантастических усилий.
Подготовка к работе
Для начала посещаем портал разработчиков и жмём кнопку «New Application» («Создать приложение»), вводим название нашего будущего бота и жмём «Create» («Создать»).
Диалоговое окно
Теперь нам нужно создать аккаунт для бота — переходим в категорию «Bot» и жмём «Add Bot» («Добавить бота»), в появляющемся диалоговом окне подтвердим это — «Yes, do it!».
Настройки бота
Копируем токен используя соответсвующую кнопку.
Интересный факт: Токен разделён на 3 части с помощью точек. Первая часть — зашифрованый с помощью base64 ID бота, вторая — время создания токена, третья — секретный ключ.
А сейчас нам нужно установить библиотеку discord.py. Для этого нужно использовать утилиту pip.
«Костяк» программной части бота. Эвенты, команды
После установки библиотеки можем приступать к написанию кода.
Почему она должна быть асинхронна? Потому что возьмём для примера команду которую исполняют одновременно 2 раза разные пользователи. def может заставить бота повиснуть изза того что она не может быть исполнена вместе с другими процессами, но async def занимает только один поток вместо того что бы не давать другим процессам программы исполняться.
Этот аргумент хранит информацию про сообщение, автора сообщения, гильдию, канал и т.п. и быть он всегда должен первым аргументом.
И что же мы делаем в ответ на команду? Мы запускаем асинхронную функцию ctx.send что бы отправить сообщение в тот канал в котором была отправлена команда
Тестируем наш костяк
Для начала нам нужно пригласить бота на сервер — и мы возвращаемся на портал разработки, переходим в категорию OAuth2 и в поле «Scopes» отмечаем только галочку на bot и получаем приглашение.
Запускаем бота, и тестируем работает ли команда
Заключение
Возможно в следующих туториалах:
Работа с эмбедами
Разбитие бота на коги
Как сделать 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. Теперь вы знаете: