Что такое…

Что такое битовая маска — и почему 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 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →