Эмбеды и переменные
Как работает конструктор эмбедов, какие есть переменные и как добавить в сообщение эмодзи и форматирование Discord.
Где бы бот ни публиковал ваше сообщение — приветствия, меню ролей, панели тикетов, посты лент, запланированные сообщения, — вы собираете его в одном и том же конструкторе эмбедов с предпросмотром, который выглядит как Discord.
Что может содержать эмбед
- Строка автора со значком и ссылкой, заголовок со ссылкой, текст, цвет.
- До 25 полей, у каждого имя и значение, рядом друг с другом, если отметить В ряд.
- Большая картинка, маленькая миниатюра, подвал со значком и отметка времени.
- Discord разрешает 6000 символов на весь текст одного эмбеда; счётчики показывают, сколько осталось.
- Адреса картинок и ссылок должны начинаться с
https://— или быть одной переменной, например{user.avatar}, там, где модуль её предлагает. - Картинки с собственных серверов Discord сразу видны в предпросмотре. Картинка с любого другого сайта ждёт нажатия Загрузить картинки под предпросмотром, потому что её загрузка сообщила бы этому сайту ваш IP-адрес. Участников в Discord это не касается: Discord загружает картинки эмбедов через собственный прокси.
Перенос сообщения туда и обратно: { } JSON
Рядом с предпросмотром есть кнопка { } JSON. Она показывает всё сообщение — текст над эмбедом и сам эмбед — в собственном формате Discord, том же, что используют другие боты, вебхуки и веб-конструкторы эмбедов. Скопируйте его, чтобы сохранить сообщение или перенести на другой сервер, или вставьте своё и нажмите Перенести: все поля конструктора заполнятся сразу, а предпросмотр покажет результат. Кнопки, файлы, опросы и имя отправителя отбрасываются, и об этом сообщается, — отсюда Pangobot их не отправляет. Для JSON, который не удаётся прочитать, указывается причина, и ничего не переносится, пока он не станет читаемым. При сохранении страницы всё проверяется ещё раз.
Переменные
Переменная заменяется при публикации сообщения. Какие переменные доступны, зависит от модуля; под каждым текстовым полем указаны свои. Самые распространённые:
| Переменная | Заменяется на |
|---|---|
{user} | Упоминание участника |
{user.name} | Имя участника, без пинга |
{server} | Название сервера |
{membercount} | Сколько участников на сервере |
{server.boosts} | Сколько бустов у сервера |
{server.boostlevel} | Уровень буста сервера, от 0 до 3 |
{level} | Только что достигнутый уровень (Уровни) |
{title} {author} {url} | Для видео, поста или записи ленты (Оповещения из соцсетей) |
{name} {days} {hours} {date} | Для обратного отсчёта (Обратные отсчёты) |
{ticket} | Номер тикета (Тикеты) |
Эмодзи и форматирование
- Кнопка со смайликом в текстовом поле открывает выбор эмодзи: стандартные эмодзи и эмодзи вашего сервера, с поиском и недавно использованными.
- Форматирование Discord работает как в чате:
**bold**,*italic*,__underline__,~~strike~~,||spoiler||,# Heading,> quote, списки и блоки кода. Предпросмотр его показывает. - Чтобы упомянуть канал или роль, выберите их в Discord и скопируйте упоминание, например
<#123...>— предпросмотр покажет название.