Что такое битовая маска — и почему permissions=8 делает бота админом

Ты делаешь бота для Discord. Инструкция говорит: «вот ссылка-приглашение, вставь свой id». В конце ссылки — permissions=8. Ты жмёшь, добавляешь бота на сервер. И он получает права администратора. Все права. Сразу.
Почему восемь? Почему не «admin=true»? Потому что это число — не количество и не уровень. Это битовая маска: восемь переключателей, упакованных в одно число. Разберёмся, как её читать — и ты больше не будешь выдавать ботам лишнего.
Что такое битовая маска
Битовая маска — это способ хранить много флагов «да/нет» в одном числе. Каждый флаг занимает свой бит — свою позицию в двоичной записи.
Представь панель из выключателей. Первый — «может приглашать». Второй — «может выгонять». Третий — «может банить». Четвёртый — «администратор». Поднятый выключатель — 1, опущенный — 0.
Позиции в двоичном коде весят по-разному: 1, 2, 4, 8, 16 и дальше удваиваются. Поэтому:
- только первый выключатель — число 1;
- только второй — 2;
- только третий — 4;
- только четвёртый — 8.
Вот и разгадка: permissions=8 — это поднятый четвёртый выключатель. В Discord четвёртый бит — ADMINISTRATOR. Ничего больше в маске нет, но больше и не надо: админ может всё.
Как сложить несколько прав
Хочешь, чтобы бот только читал и писал сообщения? Найди веса нужных прав и сложи. В Discord:
- видеть канал —
1024; - отправлять сообщения —
2048; - читать историю —
65536.
1024 + 2048 + 65536 = 68608. Это число и ставь в ссылку. Каждое право стоит на своей позиции, поэтому сумма никогда не перепутается: по числу 68608 всегда можно восстановить, какие выключатели подняты.
В коде флаги склеивают не плюсом, а оператором | («побитовое ИЛИ») и проверяют через & («побитовое И»):
const VIEW = 1 << 10 // 1024
const SEND = 1 << 11 // 2048
const perms = VIEW | SEND // 3072
if (perms & SEND) {
console.log('может писать')
}
1 << 10 читается как «единица, сдвинутая на 10 позиций влево» — то есть десятый бит. Так флаги и объявляют: видно номер выключателя, а не загадочное число.
Где ты её ещё встретишь
chmod 755. В терминале ты наверняка видел chmod 755 script.sh. Каждая цифра — маленькая маска из трёх битов: чтение (4), запись (2), запуск (1).
7= 4 + 2 + 1 — владелец может всё;5= 4 + 1 — группа читает и запускает;5— остальные тоже читают и запускают.
А chmod 777 — все могут всё, включая запись. Поэтому его и советуют не ставить «чтобы заработало».
Настройки в базе. Иногда в базе данных вместо десяти колонок-булевых лежит одно поле flags. Компактно, но человеку неудобно читать. Встретишь — знай, что это маска.
Клавиши и события. Состояние «Shift зажат, Ctrl нет» тоже часто хранят масками — в играх и низкоуровневых библиотеках.
Ловушка: JavaScript и большие маски
Вот где новички спотыкаются. Побитовые операторы в JavaScript работают только с 32 битами. Дальше начинается странное:
1 << 31 // -2147483648 (стало отрицательным)
1 << 32 // 1 (сдвиг пошёл по кругу)
А у Discord прав уже около пятидесяти. Самые новые сидят на позициях за сороковой. Поэтому Discord отдаёт права строкой, а библиотеки вроде discord.js хранят флаги как BigInt — числа без потолка, с буквой n на конце: 1n << 40n.
Если ИИ написал тебе проверку прав через обычные числа — проверь на новом праве. Скорее всего, она молча ответит «нет».
Что из этого взять
- Выдаёшь права боту или приложению — не бери
8«на всякий случай». Сложи только нужные. Если бота взломают, урон будет ограничен этими правами. - Видишь странное число в настройках — разложи его на степени двойки. 68608 = 65536 + 2048 + 1024. Сразу понятно, что внутри.
- Маски больше 32 флагов — только
BigIntили строки.
Зачем маски, если можно хранить массив названий?
Маска компактнее и быстрее проверяется: одно число вместо списка строк. Для API и сетевых протоколов это важно. Для твоего приложения массив названий часто читаемее — выбирай по ситуации.
Как посчитать маску без калькулятора?
Discord и многие сервисы дают калькулятор прав в панели разработчика. А в консоли браузера хватит одной строки: (68608).toString(2) покажет, какие биты подняты.
Битовая маска — это то же, что enum?
Нет. Enum выбирает одно значение из списка. Маска хранит сразу несколько включённых флагов.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





