Как пользоваться калькулятором
- Отметьте только те права, которые боту действительно нужны.
- Скопируйте число, которое появится выше.
- Подставьте его в ссылку-приглашение или используйте в коде.
Ссылка для приглашения бота выглядит так, только вместо 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.