Модули

Сообщения и выбор ролей

Оба формата поддерживают предпросмотр, цвета, изображения, несколько встроенных сообщений, раскрытие, копирование, удаление и перестановку. V1 использует фиксированные поля Discord, V2 — свободные блоки. Следующие разделы объясняют доступные настройки и различия.

Настройка композиции ролей

Допустимы только роли ниже высшей роли бота и вашей высшей роли. Для владельца сервера собственная граница иерархии не действует. @everyone, управляемые роли и роли с правами управления или модерации, включая доступ к журналу аудита, исключены из публичного самостоятельного назначения. Если выбрать роли в варианте без подписи, имя первой роли станет редактируемой подсказкой. Подстановки участника и сервера здесь не заменяются динамически, кроме токена времени V2.

Необходимые права в Discord

Fjord нужны Просмотр канала, Отправка сообщений и Встраивание ссылок в целевом канале, а также Управление ролями. Роль Fjord должна находиться выше всех выдаваемых ролей. Управляемые роли, @everyone и роли с административными разрешениями недоступны.

Внутреннее название обязательно даже для черновика, до 100 символов. Без канала сохраняется только черновик. Публикация требует доступного канала и видимого текста, встроенного сообщения или хотя бы одного полного варианта ролей. Каждый добавленный вариант требует подписи 1–80 символов и 1–25 назначаемых ролей. Эмодзи необязателен, описание до 100 символов показывается только в меню. Текст до выбора необязателен, до 150 символов, по умолчанию используется стандартный. Для множественного выбора задайте максимум одновременных вариантов, до 25. Заполните или удалите неполные варианты, в том числе в черновике.

Текст и упоминания

Обычный текст ограничен 2 000 символами. Используйте инструменты вставки, чтобы добавить роли, каналы и эмодзи сервера в позицию курсора. Упоминания публикуются без уведомлений и не заменяют выбор ролей.

Встраиваемый дизайн

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

V2

Блок изображения может содержать галерею из десяти изображений. «+ Ещё изображение» добавляет изображения, которые можно удалять отдельно. Для каждого изображения и миниатюры доступны необязательное описание до 80 символов и настройка спойлера. Раздел поддерживает три текста до 4000 символов каждый. «+ Ещё текст» добавляет до двух дополнительных текстов. В поле «Дополнение» выберите миниатюру или кнопку-ссылку. Кнопке необходимы надпись до 80 символов и полный HTTP(S)-адрес до 512 символов. Эмодзи и отключение необязательны. Дополнительные тексты и кнопка учитываются в лимите компонентов. Отдельные изображения галереи не считаются дополнительными компонентами.

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

V2 предлагает десять контейнеров с отдельными цветами. Используйте текстовые блоки или разделы с необязательной миниатюрой справа, каждый до 4000 символов с Markdown. Разделители показывают линию или только маленький либо большой отступ. Добавляйте, копируйте, удаляйте и перемещайте блоки стрелками. Пустые текстовые блоки и изображения не создают видимого содержимого. В текстах V2 доступны выбор ролей, каналов и эмодзи сервера.

В V2 нет классических полей автора, ввода ссылки заголовка, полей в строку, значков подписи и переключателя времени. Заголовки и ссылки оформляются Markdown. Пример ниже создаёт мелкую подпись, токен времени — временную метку. В V1 нет свободно размещаемых блоков V2. Форматы нельзя смешивать в одном сообщении.

-# ... · {time.full}

V2 ограничен 40 компонентами на всё сообщение. Учитываются контейнеры, тексты, разделы, миниатюры, галереи, разделители, строки действий, кнопки и меню. Варианты меню не считаются отдельно. Автоматически добавленные разделители и элементы управления тоже учитываются. Например, контейнер с текстом, изображением, разделителем и кнопкой со строкой действий использует шесть компонентов. Поэтому нельзя неограниченно заполнить все десять контейнеров.

Загрузка изображений

Лимиты изображений применяются к каждому файлу. В V1 значок автора, миниатюра и значок подписи допускают по 5 MB. Лимит большого изображения совпадает с указанным ниже лимитом блоков V2. Поддерживаются PNG, JPG/JPEG, WebP и GIF. Выбор файла заменяет изображение, удаление очищает слот. Значки автора и подписи невидимы без соответствующего текста.

Выбирайте PNG, JPG/JPEG, WebP или GIF. Изображения загружаются при сохранении. Для миниатюр предел 5 MB, для блоков изображений — 8 MB.

Наборы ролей, кнопки и меню

Внутреннее название обязательно даже для черновика, до 100 символов. Без канала сохраняется только черновик. Публикация требует доступного канала и видимого текста, встроенного сообщения или хотя бы одного полного варианта ролей. Каждый добавленный вариант требует подписи 1–80 символов и 1–25 назначаемых ролей. Эмодзи необязателен, описание до 100 символов показывается только в меню. Текст до выбора необязателен, до 150 символов, по умолчанию используется стандартный. Для множественного выбора задайте максимум одновременных вариантов, до 25. Заполните или удалите неполные варианты, в том числе в черновике.

Кнопки переключают свою группу ролей. Если участник уже имеет все роли группы, они снимаются. Иначе добавляются только недостающие роли. Другие роли не меняются. Предпросмотр не изменяет реальные роли.

Настройка кнопок

Выберите кнопки, добавьте вариант и задайте подпись и роли. При желании выберите эмодзи и один из четырёх стилей. Добавьте другие группы и измените порядок средствами перемещения. Каждый вариант — одна кнопка, даже если в нём несколько ролей.

Настройка меню

Для множественного выбора задаётся максимум 2–25 вариантов. Если вариантов меньше, отправленное сообщение автоматически ограничивает выбор их числом.

Выберите меню выбора. Каждому варианту назначаются роли, подпись и при необходимости описание и эмодзи. Подпись меню отображается до выбора. Для нескольких вариантов включите множественный выбор. Максимум выбора ограничивает одновременно выбранные варианты, а не роли в пакете. Без множественного выбора участник выбирает один вариант.

Меню сопоставляет весь отправленный выбор с ролями участника: выбранные недостающие роли добавляются, уже имеющиеся сохраняются. Невыбранные роли этого меню снимаются. Пустой выбор снимает все роли этого меню. Роли вне этого меню не меняются. Общие роли пересекающихся групп сохраняются, пока они нужны хотя бы одному выбранному варианту.

Галочки показывают выбор в клиенте Discord, а не обязательно текущие роли. После перезапуска или в другом клиенте они могут отсутствовать. Выбор одного варианта сохраняет или выдаёт его роли и снимает остальные роли этого меню. Повторный выбор уже имеющейся роли сохраняет её. Бот не сбрасывает меню после использования.

Компоненты V1 / V2

V2 также группирует до пяти кнопок в строке. Меню требует своей строки. Вместо пяти строк V1 действует общий бюджет компонентов.

Новые композиции начинаются с V2.

Выберите V1 или V2 до первого сохранения. После сохранения версия неизменна, даже для черновика или после удаления публикации. Для другого формата создайте новую композицию. Копирование сохраняет версию. Сохранённые сообщения V1 не преобразуются и не удаляются автоматически.

V1 допускает несколько независимых выборов ролей под всем сообщением. Они делят максимум пять строк действий. Каждое меню занимает строку, до пяти кнопок делят строку. Пять меню возможны только без дополнительных строк кнопок. Каждый выбор содержит до 25 вариантов. V2 назначает каждому контейнеру свой выбор с кнопками или меню в общем бюджете компонентов. Перемещение сообщения V1 не перемещает независимый выбор ролей. Доступны синие, серые, зелёные и красные кнопки ролей. Отдельного редактора дополнительных строк кнопок ссылок и разовой отправки нет. Однако в разделе V2 можно выбрать кнопку ссылки вместо миниатюры как аксессуар. Она открывает сайт, не меняя роли.

V1

V1 использует классические встроенные сообщения Discord с цветом и фиксированными областями. Допускается десять сообщений. В таблице указано максимальное число символов. Автор, заголовок, описание, подпись и все названия и значения полей вместе ограничены 6000 символами для всех встроенных сообщений. Обычный текст имеет отдельный лимит. В каждом сообщении V1 допускается до 25 полей.

Все области оформления необязательны. После добавления поля обязательны его название и значение. Удаляйте неиспользуемые поля. Размещение рядом включает поля в строку, окончательная раскладка зависит от Discord и ширины экрана. Ссылка или значок автора требуют имени автора, ссылка заголовка — заголовка, значок подписи — текста подписи. Необязательные ссылки должны быть полными адресами HTTP(S). Временная метка показывает момент отправки.

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

Ограничения и изображения

На сервер допускается до 50 композиций, в каждой — до десяти эмбедов. Каждый выбор ролей допускает до 25 опций. V2 разрешает всего 40 компонентов, включая контейнеры, текст, изображения, строки действий и элементы управления. Опции меню отдельно не считаются. Изображения могут занимать до 8 МБ. Проверяйте лимит перед сохранением.

Предпросмотр Discord

Предпросмотр показывает текст, порядок, изображения и элементы выбора в текущем формате. Откройте меню или нажмите кнопку для имитации выбора. Реальным участникам роли не назначаются. Сначала загрузите ресурсы сервера для доступа к ролям и эмодзи. После публикации проверьте реальную выдачу в Discord.

Управление встраиваниями

Разверните встраивание для редактирования. Меняйте порядок, дублируйте и удаляйте блоки. Копия контейнера V2 включает его элементы выбора ролей. Удаление контейнера удаляет и их. Копирование, превышающее лимит встраиваний или компонентов, блокируется.

Внутреннее имя композиции ограничено 100 символами и видно только в панели. Копия независима от оригинала. Перед публикацией проверьте канал и варианты. Сохранение применяет изменения. Отмена отбрасывает несохранённые изменения.

Сохраните или отмените изменения перед редактированием другой композиции, созданием новой, дублированием или удалением.

Управление черновиками и публикациями

Сохранение без канала оставляет черновик. С каналом сообщение публикуется, а последующие изменения обновляют его. При смене канала сначала создаётся новая публикация, затем удаляется старая. Повторное сохранение восстанавливает отсутствующее сообщение Discord. Изменения действуют после сохранения.

Удалить публикацию удаляет только сообщение Discord, сохраняя черновик. Удалить композицию также удаляет связанную публикацию. Дублирование создаёт отдельную копию, публикация которой настраивается независимо.

Устранение неполадок

Если роли отсутствуют, проверьте Управление ролями, иерархию и административные права целевых ролей. При ошибке публикации проверьте канал и разрешения. Удалите элементы при превышении лимита компонентов. Проверьте выдачу ролей с обычным участником в Discord. Предпросмотр панели не меняет роли участников.

Требования и ограничения

Необязательно заполнять все области оформления. Один цвет или пустые блоки не заменяют видимое содержимое для публикации. Предпросмотр не отправляет сообщение и не заменяет проверку в целевом канале. Ни один редактор не предлагает опросы, стикеры, формы или программируемые действия. Данные и возможности редактирования зависят также от предоставленных прав панели.

Предпросмотр, спойлеры и файлы изображений

В предпросмотре V2 одиночное изображение галереи сохраняет пропорции. Несколько изображений образуют сетку с одинаковыми областями обрезки 16:9. Два или четыре изображения занимают два столбца, три и от пяти до десяти — три столбца. Миниатюра находится справа от текста раздела. Описание изображения используется как альтернативный текст, а не как дополнительная видимая подпись.

Переключатели спойлеров изображений и контейнеров относятся к редактору V2. Изображения галереи и миниатюры можно скрывать независимо. Спойлер контейнера скрывает содержимое, оставляя внешнюю рамку видимой. Щелчок раскрывает предпросмотр, не меняя сохранённую настройку. Участники также могут раскрывать спойлеры щелчком в Discord.

Для изображений сообщений поддерживаются PNG, JPG/JPEG, WebP и GIF. Тип файла должен соответствовать содержимому. Изменение расширения HTML- или SVG-файла не превращает его в поддерживаемое изображение. Ограничения из таблиц по-прежнему действуют для каждого файла. Если локальное изображение отклонено или больше не читается, снова выберите исходный файл и сохраните изменения.

Текстовые области Markdown поддерживают веб-ссылки и ссылки электронной почты. Предпросмотр открывает HTTP(S) и mailto, но не локальные файлы и адреса Blob. Ссылки автора, заголовка и кнопки ссылок требуют полных HTTP(S)-адресов. Предпросмотр не публикует сообщение. Проверьте сохранённый результат в Discord, где вид может зависеть от клиента и ширины экрана.