Бесплатные инструменты

Калькулятор прав Дискорд

Отметьте нужные боту права и скопируйте число для ссылки-приглашения или запроса к API. Значение меняется сразу, и всё считается в браузере.

Общие
Участники
Текст
Голос
Приложения
События
Расширенные

Как пользоваться калькулятором

  1. Отметьте только те права, которые боту действительно нужны.
  2. Скопируйте число, которое появится выше.
  3. Подставьте его в ссылку-приглашение или используйте в коде.

Ссылка для приглашения бота выглядит так, только вместо YOUR_ID будет client ID вашего приложения, а в конце ваше число:

https://discord.com/oauth2/authorize?client_id=YOUR_ID&scope=bot+applications.commands&permissions=68608

Скоуп bot добавляет бота на сервер, а applications.commands разрешает ему регистрировать слэш-команды.

Что означает это число

Discord хранит права как набор битов. У каждого права свой бит, а итоговое число это сумма всех выбранных. Например, просмотр каналов равен 1024, отправка сообщений 2048, чтение истории 65536. Значит, бот с этими тремя правами получит значение 68608. API передаёт права строкой, потому что числа давно выросли и не во всех языках безопасно помещаются в обычный integer. В коде работайте с ними как с большими целыми числами.

Что дают главные права

  • Администратор (8): все права сразу, плюс игнорирование настроек отдельных каналов.
  • Управлять сервером (32): изменение настроек сервера, например названия.
  • Управлять ролями (268435456): создание и правка ролей ниже самой высокой роли бота.
  • Управлять каналами (16): создание, изменение и удаление каналов.
  • Выгонять (2) и банить (4) участников: работает только на тех, чья высшая роль ниже роли бота.
  • Управлять сообщениями (8192): удаление и закрепление чужих сообщений.
  • Управлять вебхуками (536870912): создание вебхуков, которые пишут под любым именем и аватаркой.
  • Упоминать всех (131072): пинги @everyone, @here и всех ролей.

Чем опасно право Администратор

Выдать боту Администратора проще всего, и именно поэтому так делать не стоит. Бот получает полный контроль и обходит все ограничения по каналам. Если в нём найдут уязвимость или утечёт токен, злоумышленник сможет удалить каналы, забанить участников и раздать себе роли. Нормальный бот сообщает, какие права ему нужны, и обходится ими. С ботами, которые требуют Администратора без объяснений, будьте осторожнее, а заодно прочитайте гайд про безопасность в дискорде.

Почему бот всё равно не может что-то сделать?

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

Нужен ли Администратор боту-модератору?

Обычно нет. Большинству таких ботов хватает короткого списка: выгонять и банить участников, управлять сообщениями, отправлять в тайм-аут. Точный перечень смотрите в документации бота.

Можно изменить права уже после добавления бота?

Да. Администратор сервера в любой момент может отредактировать роль бота, так что новая ссылка чаще всего не нужна.

Что будет при permissions=0?

Бот зайдёт без собственных прав и получит только то, что разрешают его роли и базовые настройки сервера.

Выбираете бота? Посмотрите лучшие боты для дискорд сервера. А если в настройках просят ID, поможет проверка ID.