Документация Fjord
Модули
01
Приветствие
Приветствуйте новых участников, прощайтесь и автоматически назначайте роли.
Включённые функции
- Индивидуальные приветственные и прощальные сообщения
- Приветственные карточки с собственным оформлением
- Автоматические роли для новых участников
- Отдельные каналы для входа и выхода
Что можно приветствовать?
С помощью Добро пожаловать вы можете автоматически приветствовать новых участников, попрощаться с уходящими участниками и назначить роли при присоединении. Все три области можно использовать независимо друг от друга.
Необходимые права в Discord
Для приветственной открытки требуется «Прикрепить файлы». Управление ролями требуется только для автоматических ролей.
Настройка
- Выберите сервер, которым хотите управлять.
- Откройте Добро пожаловать.
- Включите приветственные сообщения, прощальные сообщения или автоматические роли.
- Выберите доступный текстовый канал или хотя бы одну роль.
- Проверьте предпросмотр и сохраните изменения.
Для автоматических ролей роль Fjord должна находиться выше всех назначаемых ролей.
Приветственное сообщение
Переключатель и канал редактируются отдельно. Отключение сохраняет выбранный канал. Нет канала сначала только очищает выбор, редактор остаётся доступным. Сохранение без канала отключает соответствующую службу и закрывает её редактор. Это относится к приветствию и прощанию.
Приветственное сообщение отправляется, как только участник присоединяется к серверу. Канал, текст сообщения и приветственная открытка сохраняются вместе. Перед сохранением в предварительном просмотре показано, как взаимодействуют текст и открытка.
Включает или выключает автоматическое приветствие.
Определяет, в каком доступном текстовом канале публикуется приветствие.
Содержит обычный текст сообщения. При выборе можно использовать заполнители, роли, каналы и смайлы сервера.
Добавляет к приветствию индивидуально разработанную открытку с изображением.
Заполнитель для сообщений
| Заполнитель | Заменяется на | Пример |
|---|---|---|
{member.user.name} | Имя пользователя участника в Discord | corvus48 |
{member.mention} | Упоминание нового участника | @Mira |
{member.user.id} | Идентификатор пользователя Discord | 123456789012345678 |
{member.user.global_name} | Глобальное отображаемое имя участника | Мира |
{guild.name} | Имя сервера | Сообщество Fjord |
{guild.member_count} | Текущее количество участников | 1248 |
Используйте заполнитель в редакторе. Таким образом, имя используется точно и избегаются опечатки в фигурных скобках.
Редакторы сообщений и вложения с карточками
{guild.icon} | Значок сервера |
{member.avatar} | Аватар участника |
Без сохранённых настроек карточка приветствия включена, встроенные сообщения выключены. Прощание начинается с обычного текста без карточки и встроенного сообщения. Приветствие, прощание и роли при вступлении включаются независимо. Оба редактора предлагают V1 и V2, необязательные текст и встроенные сообщения. Переключатель генерируемой карточки находится в приветствии. Пустой текст использует показанный стандартный текст.
Текст сообщения до 1 800 символов, отдельно от встроенного текста.
У приветствия и прощания отдельные переключатели V1/V2. Смена требует подтверждения и сбрасывает текст, встроенные сообщения, изображения и кнопки ссылок этого редактора. Канал, включение и отдельный дизайн карточки сохраняются. Сохранение применяет смену, отмена восстанавливает предыдущие сохранённые данные.
V1
V1 использует классические встроенные сообщения Discord с цветом и фиксированными областями. Допускается десять сообщений. В таблице указано максимальное число символов. Автор, заголовок, описание, подпись и все названия и значения полей вместе ограничены 6000 символами для всех встроенных сообщений. Обычный текст имеет отдельный лимит. В каждом сообщении V1 допускается до 25 полей.
| Поле | Лимит символов | Статус |
|---|---|---|
| Автор | 256 | Необязательно |
| URL автора | 512 | Необязательно |
| Заголовок | 256 | Необязательно |
| Ссылка заголовка (необязательно) | 512 | Необязательно |
| Описание | 4096 | Необязательно |
| Текст футера | 2048 | Необязательно |
| Название поля | 256 | Обязательно после добавления |
| Значение поля | 1024 | Обязательно после добавления |
Все области оформления необязательны. После добавления поля обязательны его название и значение. Удаляйте неиспользуемые поля. Размещение рядом включает поля в строку, окончательная раскладка зависит от Discord и ширины экрана. Ссылка или значок автора требуют имени автора, ссылка заголовка — заголовка, значок подписи — текста подписи. Необязательные ссылки должны быть полными адресами HTTP(S). Временная метка показывает момент отправки.
Выбор ролей и каналов доступен в обычном тексте, описании V1 и значениях полей. В авторе, заголовке, подписи и названиях полей таких инструментов нет. Эмодзи сервера можно использовать в этих текстах. URL автора и ссылка заголовка принимают только URL, без ролей, каналов и эмодзи. Упоминания в классических встроенных сообщениях не уведомляют участников.
Discord показывает значок автора только если указано имя автора. Введите имя выше, чтобы значок появился в предпросмотре. Discord показывает значок подвала только если указан текст подвала. Введите текст выше, чтобы значок появился в предпросмотре.
V2
Блок изображения может содержать галерею из десяти изображений. «+ Ещё изображение» добавляет изображения, которые можно удалять отдельно. Для каждого изображения и миниатюры доступны необязательное описание до 80 символов и настройка спойлера. Раздел поддерживает три текста до 4000 символов каждый. «+ Ещё текст» добавляет до двух дополнительных текстов. В поле «Дополнение» выберите миниатюру или кнопку-ссылку. Кнопке необходимы надпись до 80 символов и полный HTTP(S)-адрес до 512 символов. Эмодзи и отключение необязательны. Дополнительные тексты и кнопка учитываются в лимите компонентов. Отдельные изображения галереи не считаются дополнительными компонентами.
В V2 контейнеры и изображения, включая миниатюры, можно пометить как спойлеры. Их содержимое скрыто и раскрывается по нажатию.
V2 предлагает десять контейнеров с отдельными цветами. Используйте текстовые блоки или разделы с необязательной миниатюрой справа, каждый до 4000 символов с Markdown. Разделители показывают линию или только маленький либо большой отступ. Добавляйте, копируйте, удаляйте и перемещайте блоки стрелками. Пустые текстовые блоки и изображения не создают видимого содержимого. В текстах V2 доступны выбор ролей, каналов и эмодзи сервера.
В V2 нет классических полей автора, ввода ссылки заголовка, полей в строку, значков подписи и переключателя времени. Заголовки и ссылки оформляются Markdown. Пример ниже создаёт мелкую подпись, токен времени — временную метку. В V1 нет свободно размещаемых блоков V2. Форматы нельзя смешивать в одном сообщении.
-# ... · {time.full}
Быстрые цвета · 10
Markdown · 4000
Markdown · 4000 · Thumbnail ≤ 5 MB
PNG · JPG/JPEG · WebP · GIF ≤ 10 MB
Показать линию разделителя · Маленький / Большой
V2 ограничен 40 компонентами на всё сообщение. Учитываются контейнеры, тексты, разделы, миниатюры, галереи, разделители, строки действий, кнопки и меню. Варианты меню не считаются отдельно. Автоматически добавленные разделители и элементы управления тоже учитываются. Например, контейнер с текстом, изображением, разделителем и кнопкой со строкой действий использует шесть компонентов. Поэтому нельзя неограниченно заполнить все десять контейнеров.
Шесть подстановок сообщений работают и в текстовых областях обоих форматов. Без глобального имени используется имя пользователя. Подстановка упоминания участника не предлагается в областях V1 без поддержки упоминаний. Для значка автора, миниатюры, большого изображения и значка подписи V1, а также миниатюр и изображений V2 можно выбрать своё изображение, значок сервера или аватар участника. Без значка сервера изображение пусто. Предпросмотр использует ваш аккаунт, отправка — реального участника. Динамические источники изображений доступны только приветствию и прощанию.
Без встроенных сообщений включённая карточка приветствия отправляется отдельным изображением с обычным текстом. При включённых сообщениях она занимает большое изображение первого сообщения V1 или добавляется в первый контейнер V2. Этот слот нельзя заменить своим большим изображением. Другие сообщения и дополнительные блоки изображений V2 допускают свои картинки. После перестановки карточка относится к новому первому сообщению. Её дизайн независим от V1/V2.
Лимиты изображений применяются к каждому файлу. В V1 значок автора, миниатюра и значок подписи допускают по 5 MB. Лимит большого изображения совпадает с указанным ниже лимитом блоков V2. Поддерживаются PNG, JPG/JPEG, WebP и GIF. Выбор файла заменяет изображение, удаление очищает слот. Значки автора и подписи невидимы без соответствующего текста.
Вставка контента в сообщения
В редакторе сообщений есть собственный выбор заполнителей, ролей, каналов и смайликов сервера. Выбранная запись вставляется в текущую позицию записи.
| Выбор | Использование |
|---|---|
| Подстановочный знак | Вставляет динамическую информацию об элементе или сервере из таблицы выше. |
| Роли | Просмотрите роли сервера и вставьте нужное упоминание роли. @everyone недоступен для выбора. |
| Каналы | Просмотрите доступные каналы и установите ссылку на канал. |
| Серверные смайлы | Просмотрите собственные смайлы сервера и вставьте статические или анимированные серверные смайлы. |
Вы можете открыть выборки с помощью кнопок в редакторе. Во время написания @ открывает выбор роли, # открывает выбор канала, а : открывает выбор эмодзи сервера. Дальнейшие введенные символы фильтруют соответствующий список.
Приветственные и прощальные сообщения могут содержать не более 1800 символов каждое. Вставленные записи считаются частью содержимого сообщения.
Разработать приветственную открытку
Редактор карточки предлагает содержимое, раскладку, поверхность, кольцо и текст.
Содержимое включает фон, необязательный цветной фон, заголовок, подзаголовок и поиск шрифтов с предпросмотром и страницами.
Раскладка — слева или по центру.
Поверхность — обычная непрозрачность 0–100 % или слой Liquid с цветом, непрозрачностью 0–100 % и размытием 0–64 px. Liquid отключает обычный регулятор непрозрачности.
Кольцо — основной цвет, интенсивность 0–100 % и необязательный шейдер с цветом, силой 0–100 % и углом 0–360°.
Текст — основной цвет, интенсивность и необязательный шейдер с цветом, силой и положением 0–100 %.
Нет свободных регуляторов размера аватара, отдельных размеров шрифта или произвольных позиций текста.
Сброс восстанавливает стандартный дизайн. Сохранение и отмена выполняются общей панелью.
Используйте стандартный фон, сплошной цвет или своё изображение. Изображение можно перемещать и увеличивать в редакторе обрезки. Область также предлагает жидкий слой с цветом, непрозрачностью и размытием.
| Свойство | Поддерживается | Примечание |
|---|---|---|
| Размер файла | Максимум 10 МБ | Файлы большего размера нельзя сохранить в качестве фона. |
| Форматы изображений | PNG, JPG/JPEG, WebP и GIF | Фактический формат файла проверяется на основе содержимого изображения. |
| Формат открытки | 1200 × 600 пикселей | Выбранное изображение будет обрезано до этого участка открытки в редакторе. |
| Анимация | Статический результат | Готовая открытка сохраняется в формате PNG. Поэтому анимация из файлов GIF или WebP не сохраняется. |
Заголовок ≤ 120 · Подзаголовок ≤ 160
Подстановки карточки
{member.user.name} · {guild.name} · {guild.member_count}
Карточка имеет размер 1200 × 600 пикселей и выводится как статический PNG. Предпросмотр использует вашу учётную запись и примерные данные выбранного сервера. При вступлении используются данные участника. Для предпросмотра в браузере нужно действующее соединение с панелью.
Прощальное сообщение
Переключатель и канал редактируются отдельно. Отключение сохраняет выбранный канал. Нет канала сначала только очищает выбор, редактор остаётся доступным. Сохранение без канала отключает соответствующую службу и закрывает её редактор. Это относится к приветствию и прощанию.
Прощальное сообщение отправляется, когда участник покидает сервер. Он может использовать другой целевой канал и собственный текст. Упоминания не всегда могут быть разрешены после ухода. Поэтому используйте {member.user.global_name}.
Включает или выключает автоматическое прощание.
Определяет, в каком доступном текстовом канале будет опубликовано прощальное сообщение.
Содержит прощальный текст длиной до 1800 символов и доступные средства вставки.
Автоматические роли
Fjord может назначить несколько ролей новым участникам сразу после присоединения. Роли, управляемые Discord, и роли выше роли Fjord не могут быть назначены.
Включает или отключает назначение ролей при присоединении.
Просмотрите список ролей и выберите минимум одну и максимум 25 ролей.
- Проверьте в разделе Настройки сервера → Роли, что роль Fjord находится выше целевых ролей.
- Активируйте автоматическое назначение ролей и выберите нужные роли.
- Сохранить выбор.
Роли с расширенными административными правами не должны назначаться автоматически. Fjord отображает только те роли, которые обычно можно назначать.
Исправить ошибки
| Проблема | Проверьте |
|---|---|
| Сообщение не отправляется. | Активирована ли услуга, канал все еще доступен и разрешено ли Fjord видеть его и писать на него? |
| Открытка отсутствует. | Активирована ли открытка и есть ли у Fjord функция «Прикрепить файлы» прямо в целевом канале? |
| Роль не назначена. | Находится ли роль Fjord выше целевой роли и есть ли у Fjord функция «Управление ролями», верно? |
| Заполнитель остается неизменным. | Был ли он вставлен с помощью выбора заполнителя и правильно ли написание и скобки? |
| Изменения не отображаются. | Сохраните изменения общей панелью сохранения: она применяет изменения сообщений и карточки вместе. |
Кнопки-ссылки
V2 объединяет до пяти кнопок ссылок в строке действий. Вместо ограничения V1 в пять строк действует общий бюджет компонентов.
Кнопки ссылок открывают сайты и не назначают роли. Каждая добавленная кнопка требует подписи до 80 символов и полного URL HTTP(S) до 512 символов. Эмодзи необязателен. Кнопки можно перемещать и удалять. V1 показывает их под встроенными сообщениями, до пяти кнопок в строке и пяти строк всего, то есть до 25 кнопок. V2 размещает их в соответствующем контейнере, считая кнопки и строки в бюджете 40.
Кнопки ссылок отправляются только при включённых встроенных сообщениях.
Требования и ограничения
Необязательно заполнять все области оформления. Один цвет или пустые блоки не заменяют видимое содержимое для публикации. Предпросмотр не отправляет сообщение и не заменяет проверку в целевом канале. Ни один редактор не предлагает опросы, стикеры, формы или программируемые действия. Данные и возможности редактирования зависят также от предоставленных прав панели.
Предпросмотр, спойлеры и файлы изображений
В предпросмотре V2 одиночное изображение галереи сохраняет пропорции. Несколько изображений образуют сетку с одинаковыми областями обрезки 16:9. Два или четыре изображения занимают два столбца, три и от пяти до десяти — три столбца. Миниатюра находится справа от текста раздела. Описание изображения используется как альтернативный текст, а не как дополнительная видимая подпись.
Переключатели спойлеров изображений и контейнеров относятся к редактору V2. Изображения галереи и миниатюры можно скрывать независимо. Спойлер контейнера скрывает содержимое, оставляя внешнюю рамку видимой. Щелчок раскрывает предпросмотр, не меняя сохранённую настройку. Участники также могут раскрывать спойлеры щелчком в Discord.
Для изображений сообщений поддерживаются PNG, JPG/JPEG, WebP и GIF. Тип файла должен соответствовать содержимому. Изменение расширения HTML- или SVG-файла не превращает его в поддерживаемое изображение. Ограничения из таблиц по-прежнему действуют для каждого файла. Если локальное изображение отклонено или больше не читается, снова выберите исходный файл и сохраните изменения.
Текстовые области Markdown поддерживают веб-ссылки и ссылки электронной почты. Предпросмотр открывает HTTP(S) и mailto, но не локальные файлы и адреса Blob. Ссылки автора, заголовка и кнопки ссылок требуют полных HTTP(S)-адресов. Предпросмотр не публикует сообщение. Проверьте сохранённый результат в Discord, где вид может зависеть от клиента и ширины экрана.
02
Автомодератор
Автомодератор обнаруживает нежелательный контент и применяет правила сервера.
- Десять фильтров содержимого, спама, ссылок и упоминаний
- Отдельные области действия для ролей и каналов
- До десяти уровней предупреждений с удалением, тайм-аутом, исключением или блокировкой
03
Журнал активности
Записывайте важные события в выбранных каналах Discord.
- 89 поддерживаемых типов событий
- Один общий канал журнала
- Отдельно включаемые записи
04
Встроенные сообщения
Создавайте структурированные сообщения в визуальном редакторе без JSON.
- Заголовки, описания, поля и медиафайлы
- Предпросмотр во время редактирования
- Сохранение и повторное редактирование
Роли по реакции
Участники выбирают роли кнопками и меню. Настройте наборы ролей, сообщения V1/V2 и управляемые публикации.
Включённые функции
- Оба формата поддерживают предпросмотр, цвета, изображения, несколько встроенных сообщений, раскрытие, копирование, удаление и перестановку. V1 использует фиксированные поля Discord, V2 — свободные блоки. Следующие разделы объясняют доступные настройки и различия.
- Кнопки ролей с подписями, эмодзи, четырьмя стилями и одной или несколькими ролями на вариант
- Меню с подсказкой, описаниями, эмодзи и одиночным или множественным выбором
- V1 допускает несколько независимых выборов ролей под всем сообщением. Они делят максимум пять строк действий. Каждое меню занимает строку, до пяти кнопок делят строку. Пять меню возможны только без дополнительных строк кнопок. Каждый выбор содержит до 25 вариантов. V2 назначает каждому контейнеру свой выбор с кнопками или меню в общем бюджете компонентов. Перемещение сообщения V1 не перемещает независимый выбор ролей. Доступны синие, серые, зелёные и красные кнопки ролей, но нет редактора кнопок ссылок на сайты и разовой отправки.
- Предпросмотр с имитацией выбора ролей без изменения реальных ролей участников
- Названия и копии композиций, сохранение черновиков, публикация и обновление сообщений, удаление публикаций
- Подсказки о разрешениях и иерархии ролей, размерах изображений и лимитах текста и компонентов
05
Настройки
В настройках можно выбрать язык, часовой пояс и стандартный цвет эмбедов, делегировать доступ к панели и управлять сохранёнными данными модулей.
- Стандартный цвет эмбедов бота
- Язык и часовой пояс
- Делегированный доступ к панели
- Управление сохранёнными данными модулей
06
Команды
Все slash-команды Fjord, необходимые права и помощь при ошибках.