Как узнать права комнаты discord python

Создание бота на основе discord.py. Часть 1

Это первая статья про создание бота для Discord. В конце статьи находятся ссылки на следующие части, со временем они будут дополняться. Статьи следуют друг за другом, без каких-либо «информационных дыр». Если нашли опечатку или неточность, отпишите о проблеме в комментариях или в личных сообщениях, максимально оперативно всё поправим! А теперь переходим непосредственно к созданию бота.

В данной части

1. Создание тестового сервера
2. Включение режима разработчика
3. Создание приложения и получение токена
4. Добавление бота на сервер
5. Установка библиотеки discord.py
6. Первые строчки кода

Создание сервера

Гайд будет максимально подробный, поэтому и начинать будем с создания тестового сервера. Зачем он нужен? Лишь для вашего удобства и безопасности, если у вас уже есть большой сервер, тем более не стоит сразу добавлять на него разрабатываемого бота. Никто не защищён от багов и дыр в безопасности.

1. Заходим в дискорд
2. Слева видим список серверов, листаем в самый низ до кнопки «Создать сервер«.
3. Создаём сервер по любому из предложенных шаблонов.

Включаем режим разработчика

Это необязательно, но очень желательно. В режиме разработчика появляются некоторые полезные элементы для удобства разработки, например, в меню пользователя появляется пункт, который позволяет скопировать его ID.

Чтобы включить этот режим, заходим в настройки.

В категории «Настройки приложения» ищем «Расширенные«.

И включаем режим разработчика.

Получение токена

Для начала нам нужно зайти на страницу создание приложений и нажать New Application.

После этого вам предложат назвать ваше приложение (Потом можно будет изменить).

После создания, попадаем на страницу настройки приложения. В меню выбираем «Bot«.

На данной странице нажимаем на «Add Bot«. Скопируем токен и сохраним его.

Так же, сразу можно выдать дополнительные разрешения боту, чтобы потом об этом не задумываться.

Добавление бота на сервер

В меню ищем пункт OAuth2 –> URL Generator.

В поле SCOPES выбираем bot и applications.commands. В появившемся ниже поле выбираем Administrator, это более удобно для тестирования. Но когда бот будет работать в продакшене, лучше выставлять только те права, которые правда нужны, потому что никто не защищён от потери токена, а с правами администратора это может стать очень большой проблемой.

Копируем появившеюся ниже ссылку и вставляем в адресную строку браузера. Если у вас не выполнен вход в браузере, его необходимо произвести. После чего выбираем тестовый сервер из списка и нажимаем «Продолжить» и далее «Авторизовать«.

Ура! Наш бот на тестовом сервере!

Установка библиотеки

Для начала нужно установить python, данный этап не расписан, но желательно установить версию 3.10 (Последняя версия на момент написания 3.10.5). Если у вас Windows, для проверки можете использовать следующую команду

py --version

В ответ получите версию вашего python. Устанавливать будем не стабильную, а разрабатываемую версию, для этого пропишем следующую команду. (Это можно делать уже внутри проекта). Хотя некоторые IDE устанавливаю git вместе с собой, можете скачать его отдельно.

py -m pip install git+https://github.com/rapptz/discord.py

Если всё же хотите установить стабильную, релизную версию, пропишите следующую команду.

py -3 -m pip install -U discord.py py -3 -m pip install -U discord.py[voice]

Подробнее про установку библиотеки и саму библиотеку можно прочитать тут.

Первые строчки кода

Пришло время писать код! Программирование в статьях будет происходить в PyCharm, хоть это и довольно тяжёлая IDEA, она удобная и бесплатная для студентов.

Не советую создавать проект через внутренний интерфейс, может появиться множество ненужных папок и файлов, вместо этого создадим папку проекта вручную и откроем как пустой проект.

Для этого заходим в PyCharm, далее File –> Open.

P.s. Не обращайте внимания на другую тему IDE.

В появившемся окне ищем созданную папку, выбираем её и нажимаем «Ok«. Обратите внимание на то, что нужно просто нажать по папке, а не проваливаться в неё.

Если PyCharm автоматически не создал main.py, создайте его вручную.

Вставляем код ниже и запускаем.

import discord # Подключаем библиотеку from discord.ext import commands intents = discord.Intents.default() # Подключаем "Разрешения" intents.message_content = True # Задаём префикс и интенты bot = commands.Bot(command_prefix='>', intents=intents) # С помощью декоратора создаём первую команду @bot.command() async def ping(ctx): await ctx.send('pong') bot.run('token') 

В консоли вы увидите логи запуска бота. Они могут быть красными, не бойтесь, сначала прочитайте сами сообщения, они скорее, всего просто информационные.

Идём в дискорд и используем нашу первую команду.

Немного объясним данную структуру. Поскольку это обычная команда, вся информация хранится в ctx(Переменная одноимённого класса). Она имеет следующие поля:

['args', 'author', 'bot', 'channel', 'cog', 'command', 'command_failed', 'guild', 'invoked_parents', 'invoked_subcommand', 'invoked_with', 'kwargs', 'me', 'message', 'prefix', 'subcommand_passed', 'valid', 'voice_client']

И следующие команды:

['fetch_message', 'history', 'invoke', 'pins', 'reinvoke', 'reply', 'send', 'send_help', 'trigger_typing', 'typing']

Если вы знакомы с синтаксисом языка, то данный список можно получить с помощью встроенной функции dir.

print(dir(ctx))

На более правильно прочитать документацию про Context.

Заключение

Сразу отвечу всем комментаторам. Да — подобных статей море, в том числе есть официальная документация. Но поскольку в моих планах есть создать серию статей, я хотел бы, что бы в них было описано всё, начиная с самых азов.

И небольшое примечание. Статьи строятся на основании того, что у вас есть опыт и знания программирования на python.

Бот для Discord API на Python (discord.py) с командами

Сегодня разберём создание бота для популярной соцсети Discord. Эта платформа предназначена для общения посредством голосовых чатов и сообщений и чем-то схожа с телеграмом.

Недавно я столкнулся с задачей написания подобного бота. Поскольку на просторах интернета, нет внятных гайдов, решил сделать свой. Про официальную документацию можно не говорить, там чёрт ногу сломит. В YouTube охватывают лишь самое начало. Я постараюсь более детально погрузиться в discord.py и работу с Discord API.

Структура проекта и установка библиотек

1. Компьютер или ноутбук
2. Редактор кода (Notepad++ тоже подойдет).
3. Python версии 3.9 и выше.
4. Соединение с интернетом

Установка для Windows:

pip install discord.py

Установка для MacOS:

pip3 install discord.py

+---discord | +---cogs | | +---everyone.py | | +---logs.py | | \---moder.py | +---config.py | \---main.py

Структура максимально простая, все модули для обработки команд будут храниться в директории cogs. Остальное можно структурировать как угодно.

Создание бота и получение токена

Заходим на этот сайт https://discord.com/developers/docs/intro и нажимаем на «applications». После проходим авторизацию (видео инструкция тут ).

Создаем новое приложение:

Дальше переходим во вкладку Bot и создаем бота. Тут вы сможет создать и скопировать токен:

После всех манипуляций выбираем уровень доступа для бота — administrator.

Как добавить бота на сервер

Переходим во вкладку OAuth2 General, ставим такие настройки и сохраняем:

Потом переходим в URL General, выбираем те же самые настройки и копируем ссылку ниже:

Переходим по ссылке и выбираем на какой сервер хотим добавить бота. Добавлять можно только на тот сервер, который вы администрируете (у вас есть права администратора на нем). Дальше следуем иструкциям Discord.

Разработка бота

Main.py

import asyncio import os import discord from discord.ext import commands import config

Подробнее остановимся на commands и config .

В commands будет инициализироваться и храниться бот. В дальнейшем через этот объект класса будем обращаться к методам.

Config – там будут храниться все глобальные переменные — токены, ID каналов, ID ролей и т д.

discord_intents = discord.Intents.all() discord_intents.members = True

discord_intents – мы наделяем бота полными правами доступа (когда будем добавлять его, то он запросит разрешение для управления)

bot – тут собирается бот. Аргументы: command_prefix — на какой спец символ будет откликаться бот; intents — права доступа.

discord_intents = discord.Intents.all() discord_intents.members = True bot = commands.Bot(command_prefix=config.prefix, intents=discord_intents) bot.remove_command("help") @bot.event @commands.has_any_role(*config.admin_id_role) async def on_ready(): await bot.change_presence(status=discord.Status.idle, activity=discord.Game(config.prefix+"info")) await bot.wait_until_ready() @bot.command() @commands.has_any_role(*config.admin_id_role) async def load(ctx, extension): bot.load_extension(f"cogs.") print(f"load module: cogs.") @bot.command() @commands.has_any_role(*config.admin_id_role) async def unload(ctx, extension): bot.unload_extension(f"cogs.") print(f"unload module: cogs.") @bot.command() @commands.has_any_role(*config.admin_id_role) async def reload(ctx, extension): bot.unload_extension(f"cogs.") bot.load_extension(f"cogs.") print(f"reload module: cogs.") async def load_extensions(): for filename in os.listdir("./cogs"): if filename.endswith(".py"): await bot.load_extension(f"cogs.") async def main(): print('zit goot') await load_extensions() await bot.start(config.token) if __name__ == "__main__": # bot.run(config.token) asyncio.run(main())

Пробежимся по функциям.

On_ready – срабатывает при загрузке бота. bot.change_presence — тут мы устанавливаем активность (Discord может показывать во что вы сейчас играете).

Дальше подгружаются все винтики. Почему пакеты в Discord называют винтики? Потому что в официальной документации разработчики назвали именно так;)

Load и unload — позволяют отключить и подключить винтики. Загрузка происходит с помощью обращения к методам объекта бота.

Reload — по сути вызывает по очереди unload и load.

Цикл for перебирает все файлы и загружает их в первый раз.

Ну и в конце мы запускаем бота, передавая в него токен.

Config.py

token = '12345' prefix = '!' recurring_guild_id = 1234 admin_id_role = '938435735701311538' id_mute_role = '938437343751319613' id_user_role = '938437452920672327'

Этот файл будет хранить в себе только служебные переменные — токены, ID ролей, ID серверов.

Директория cogs

Everyone.py

import discord import time import config from discord.ext import commands class Everyone(commands.Cog): def __init__(self, bot): self.bot = bot @commands.Cog.listener() async def on_ready(self): print('everyone is ready') @commands.command() async def info(self, ctx): embed = discord.Embed(title=f">> Команды ", icon_url=f"") embed.add_field(name=f"***mute*** --- отключить возможность говорить и писать человеку", value=f"Пример: mute @1234", inline=False) embed.add_field(name=f"***unmute*** --- вернуть все возможности человку", value=f"Пример: unmute @1234", inline=False) embed.add_field(name=f"***ban*** --- добавить человека в черный список и выгнать", value=f"Пример: ban @1234", inline=False) embed.add_field(name=f"***unban*** --- убрать человека из чероного списка", value=f"Пример: unban @1234", inline=False) embed.add_field(name=f"***kick*** --- выгрнать человека", value=f"Пример: kick @1234", inline=False) embed.add_field(name=f"***clear*** --- удалить последние сообщения", value=f"Пример: clear 40", inline=False) embed.set_footer(text=f"BOT • ") await ctx.channel.purge(limit=1) await ctx.send(embed=embed) async def setup(bot): await bot.add_cog(Everyone(bot))

В этом файле будут храниться все команды доступные обычному пользователю. Импорты отдельно разбирать не буду, там и так все понятно.

Вероятно, вы спросите что это за класс. Everyone наследуется от commands.Cog . Винтики работают за счёт объектов — когда мы запускаем бота, то перебираем все объекты и собираем всё вместе.

Для отслеживания команд мы используем декоратор commands.command() . Для корректной работы при создании класса мы передаём в него нашего бота. Дальше описываем в методах логику.

Функция info будет высылать пользователю embed (сообщение) с указанием доступных команд. Внутрь функции передаем ctx (полное его название context) — это полученное сообщение.

Мы создаем объект, в который передаем: заголовок, свет линии с краю, подпись автора и ссылку на изображение. Дальше, обращаясь к методу add_field , добавляем строки с именем и значением — можно их назвать заголовок и текст.

Метод set_footer добавляет маленькую подпись в конце сообщения. В завершение мы обращаемся к await ctx.channel.purge(limit=1) , что удаляет одно сообщение (можно указать любое количество в limit). Await позволяет нам дождаться окончания асинхронного метода.

После этого отправляем сообщение с помощью await ctx.send(embed=embed) , передавая внутрь сформированное сообщение. Или можно просто отправить текст await ctx.send(text=”your message”) .

Эта конструкция нужна библиотеке, что бы она могла увидеть и загрузить винтик:

async def setup(bot): await bot.add_cog(Everyone(bot))

Удобный конструктор embed, который сразу выдает python код, находится тут .

Moder.py

import discord import time from discord.ext import commands import config class Moder(commands.Cog): def __init__(self, bot): self.bot = bot @commands.Cog.listener() async def on_ready(self): print('moder is ready') @commands.command() @commands.has_any_role(config.admin_id_role) async def mute(self, ctx, user: discord.Member, reason=None): channel = self.bot.get_channel(config.log_mes_channel_id) guild = self.bot.get_guild(config.recurring_guild_id) role = guild.get_role(config.id_mute_role) embed = discord.Embed(title=f"Пользователя заглушили", color=0xfac400) embed.set_author(name=f"", icon_url=f"") embed.add_field(name="Причина:", value=f"", inline=True) embed.set_footer(text=f"BOT • ") await user.add_roles(role) await channel.send(embed=embed) await ctx.channel.purge(limit=1) await ctx.send(embed=embed, delete_after=30) @commands.command() @commands.has_any_role(config.admin_id_role) async def unmute(self, ctx, user: discord.Member): channel = self.bot.get_channel(config.log_mes_channel_id) guild = self.bot.get_guild(config.recurring_guild_id) role = guild.get_role(config.id_mute_role) embed = discord.Embed(title=f"Пользователя разглушили", color=0xfac400) embed.set_author(name=f"", icon_url=f"") embed.set_footer(text=f"BOT • ") await user.remove_roles(role) await channel.send(embed=embed) await ctx.channel.purge(limit=1) await ctx.send(embed=embed, delete_after=30) @commands.command() @commands.has_any_role(config.admin_id_role) async def ban(self, ctx, user: discord.Member, *, reason=None): channel = self.bot.get_channel(config.log_mes_channel_id) embed = discord.Embed(title=f"Пользователя забанили", color=0xfac400) embed.set_author(name=f"", icon_url=f"") embed.add_field(name="Причина:", value=f"", inline=True) embed.set_footer(text=f"BOT • ") await channel.send(embed=embed) await user.ban(reason=reason) await ctx.channel.purge(limit=1) await ctx.send(embed=embed, delete_after=30) @commands.command() @commands.has_any_role(config.admin_id_role) async def unban(self, ctx, *, member): banned_users = await ctx.guild.bans() channel = self.bot.get_channel(config.log_mes_channel_id) member_name, member_discriminator = member.split("#") for ban_entry in banned_users: user = ban_entry.user if (user.name, user.discriminator) == (member_name, member_discriminator): await ctx.guild.unban(user) embed = discord.Embed(title=f"Пользователя разбанили", color=0xfac400) embed.set_author(name=f"", icon_url=f"") embed.set_footer(text=f"Silence. • ") await channel.send(embed=embed) await ctx.channel.purge(limit=1) await ctx.send(embed=embed, delete_after=30) return @commands.command() @commands.has_any_role(config.admin_id_role) async def kick(self, ctx, user: discord.Member, *, reason=""): channel = self.bot.get_channel(config.log_mes_channel_id) embed = discord.Embed(title=f"Пользователя выгнали из сервера", color=0xfac400) embed.set_author(name=f"", icon_url=f"") embed.add_field(name="Причина:", value=f"", inline=True) embed.set_footer(text=f"BOT • ") await channel.send(embed=embed) await ctx.channel.purge(limit=1) await ctx.send(embed=embed, delete_after=30) await user.kick() @commands.command() @commands.has_any_role(config.admin_id_role) async def clear(self, ctx, amount=20): channel = self.bot.get_channel(config.log_mes_channel_id) if amount < 200: embed = discord.Embed(title=f"Очистил чат \"\" на сообщений(ия)", color=0xfac400) embed.set_author(name=f"", icon_url=f"") embed.set_footer(text=f"BOT • ") await ctx.channel.purge(limit=int(amount)) await channel.send(embed=embed) await ctx.send(embed=discord.Embed(description=f":wheelchair: удалено сообщений(я)"), delete_after=30) else: await ctx.send(embed=discord.Embed(description=f":Вы не можете удалить больше 200 сообщений"), delete_after=30) async def setup(bot): await bot.add_cog(Moder(bot))

Пройдёмся по функциям сверху вниз.

@commands.has_any_role(config.admin_id_role) - это новый декоратор, он проверяет есть ли у пользователя роль (нужен ID роли). Также можно указывать перечень ролей в массиве (для этого распаковывайте массив).

Mute принимает в себя само сообщение, пользователя (пример @user), и причину. Первым делом мы заготавливаем объект чата, в который будем присылать действия администратора. Потом сам сервер (в документации discord.py сервер называется гильдия). И в конце получаем роль, которую будем давать пользователю.

Когда всё готово, собираем сообщение-уведомление (не забывайте пользоваться конструктором embed тут ). Дальше к объекту пользователя добавляем роль. И отправляем сообщение в логи и в чат, откуда пришла команда. Не забываем удалять отправленную команду.

Unmute зеркальна с функций mute, только для пользователя мы используем метод remove role .

Ban - выгоняет пользователя с сервера и добавляет его в черный список (в дальнейшем его не смогут пригласить на сервер пока он в ЧС).

Для работы в переменных нам потребуется только канал для системы логов. Следом проходим процедуру сборки красивого сообщения и отправляем его как в mute.

Unban - не просто зеркальная функция, потому что тут нам потребуется обращаться к списку ЧС. banned_users делает запрос к ЧС сервера. Дальше мы делаем полный перебор всех заблокированных и сравниваем с нашим пользователем. Как только находим его, убираем юзера из списка и выводим сообщение о разблокировке.

Kick - с этой функций дела обстоят намного проще, так как у пользователя есть метод для изгнания user.kick .

Clear - последняя возможность для администрирования. В нее поступает не только сообщение, но и количество сообщений, которое нужно удалить. Дальше идет защита от опечатки.

ctx.channel.purge(limit=int(amount)) отвечает за удаление сообщений, в limit передаем полученное значение.

Заключение

Библиотека discord.py не проста в понимании и требует много времени на разбор. Но лучших аналогов для Python не найти из-за обширности API.

Если захотите разобраться глубже, самостоятельно изучайте новые методы и классы. Производите глубокий анализ, что откуда исходит (какой вы получаете объект в ответе и как его можно получить еще).

Для дальнейшего развития советую попытаться добавить в бота интеграцию с базой данных. Например есть хорошая БД MongoDB - на ней можно простроить мощную многоуровневую систему администрирования сервера.

Как выдавать роли определенные права (discord.py)

Как выдавать созданной роли в discord права?
Киньте ссылку на источник, где это все подробно рассказано?
ps искал в интернете, но нашел только как задавать цвет.

Отслеживать
12.5k 7 7 золотых знаков 19 19 серебряных знаков 48 48 бронзовых знаков
задан 24 янв 2021 в 15:27
user420913 user420913
discordpy.readthedocs.io/en/latest/api.html#permissions не про права, разве?
26 янв 2021 в 16:47
документация полностью на Англиском, а я его лишь изучаю, я врятли там что-то пойму
– user420913
26 янв 2021 в 16:56
почитав немного документацию так и ничего не понял
– user420913
26 янв 2021 в 17:04
переводчики запретили?)
26 янв 2021 в 17:05
они переводят криво, и часть они не переводят вообще
– user420913
26 янв 2021 в 17:06

1 ответ 1

Сортировка: Сброс на вариант по умолчанию

Найдите роль через

role = discord.utils.get(ctx.message.guild.roles, #через айди будет проще искать 

Далее, изменяем её.

await role.edit(*, reason = "None", **fields) 

Что можно изменить, вы можете найти в Документации.

Отслеживать
ответ дан 27 янв 2021 в 7:19
378 1 1 серебряный знак 10 10 бронзовых знаков

возможно я слишком тупой, но делал все вот так await role.edit(reason = "None", administrator = True) и ничего не вышло, ошибок не выдает, просто не даються никакие права

– user420913
27 янв 2021 в 15:43

Вы права должны указывать (насколько я помню) в словаре: permissions = <Здесь нужные права>. Опять же - обращайтесь к документации.

29 янв 2021 в 7:09

Извиняюсь, вот правильный вариант - perms = discord.Permissions(administrator = True) Далее, уже в функции edit() указываем параметр permissions = perms

Как мне сделать пользователя через id в discord.py?

У меня есть код, который по нажатию на кнопку принимает написанное пользователем следующее сообщение.
Т.е. у меня стоит эмбед с кнопками и когда человек нажимает на кнопку то ему бот пришет: введите пользователя. И когда пользователь упоминает его, то бот выдаёт ошибку:

Ignoring exception in command test1: Traceback (most recent call last): File "C:\Users\Fenix\AppData\Local\Programs\Python\Python39\lib\site-packages\discord\ext\commands\core.py", line 85, in wrapped ret = await coro(*args, **kwargs) File "C:\Users\Fenix\Desktop\modern\Beta(войсы(все))\cogs\private.py", line 165, in createembedforprivateroom await channel4.set_permissions(user, connect=False) File "C:\Users\Fenix\AppData\Local\Programs\Python\Python39\lib\site-packages\discord\abc.py", line 648, in set_permissions raise InvalidArgument('target parameter must be either Member or Role') discord.errors.InvalidArgument: target parameter must be either Member or Role

Как мне убрать эту ошибку, и что бы когда пользователь упоминает другого пользователя, упомянутый заносился в права канала - не заходить.
Мой код вот:

await ctx.send(f'**Упомяните** пользователя у которого хотите **забрать** доступ к комнате!. Для этого у вас есть 20 секунд!', delete_after=20) res = await self.bot.wait_for("message", check=lambda i: i.author == member, timeout=20) cd = res.content \ .replace("", "") user = get(self.bot.get_all_members(), channel4 = self.bot.get_channel(channel1) await channel4.set_permissions(user, connect=False) await ctx.send(f', вы **закрыли доступ** в комнату пользователю ')

Прошу помочь мне с этим вопросом. Если вам недостаточно чего-либо - пишите, допишу.

• Вопрос задан более двух лет назад
• 133 просмотра