Переменные шаблонов
Вставляйте их в свои команды, приветствия и прощания, автоответчики, сообщения о новом уровне и везде, где панель показывает выбор переменных. Kovu подставит значения при отправке.
На этой странице
ОсновноеСсылка на этот раздел
Работают в каждом сообщении, которое Kovu отправляет за вас.
| Переменная | Что делает |
|---|---|
{user} | Упоминает пользователя |
{server} | Название сервера |
{channel} | Название канала |
{prefix} | Префикс команд сервера |
УпоминанияСсылка на этот раздел
| Переменная | Что делает |
|---|---|
{everyone} | Упоминает @everyone |
{here} | Упоминает @here |
{@name} | Упоминает пользователя по имени пользователяПример: {@kovu} |
{&role} | Упоминает роль по названиюПример: {&Gamers} |
{#channel} | Ссылка на канал по названиюПример: {#rules} |
ПользовательСсылка на этот раздел
| Переменная | Что делает |
|---|---|
{user.id} | ID пользователя |
{user.name} | Имя пользователя |
{user.username} | Имя пользователя |
{user.displayname} | Никнейм на сервере, глобальное отображаемое имя или имя пользователя |
{user.globalname} | Глобальное отображаемое имя пользователя |
{user.nick} | Никнейм пользователя на сервере (или отображаемое имя) |
{user.tag} | имя пользователя (или name#1234 для старых аккаунтов) |
{user.idname} | имя пользователя (ID) |
{user.discrim} | Старый дискриминатор пользователя |
{user.mention} | Упоминает пользователя |
{user.avatar} | URL аватара пользователя |
{user.createdat} | Когда создан аккаунт |
{user.joinedat} | Когда пользователь зашёл на сервер |
{user.bot} | "true", если пользователь — бот |
СерверСсылка на этот раздел
| Переменная | Что делает |
|---|---|
{server.id} | ID сервера |
{server.name} | Название сервера |
{server.icon} | URL значка сервера |
{server.membercount} | Число участников |
{server.ownerid} | ID владельца |
{server.owner} | Упоминает владельца |
{server.createdat} | Когда создан сервер |
{server.boosts} | Число бустов |
{server.boostlevel} | Уровень бустов (0-3) |
| Переменная | Что делает |
|---|---|
{channel.id} | ID канала |
{channel.name} | Название канала |
{channel.mention} | Ссылка на канал |
{channel.topic} | Тема канала |
| Переменная | Что делает |
|---|---|
{role} | Название роли (если роль в контексте) |
{role.id} | ID роли |
{role.name} | Название роли |
{role.mention} | Упоминает роль |
{role.color} | Цвет роли в HEX |
{role.membercount} | Участники с ролью |
| Переменная | Что делает |
|---|---|
{time} | Текущее время (24 часа) |
{time12} | Текущее время (12 часов) |
{date} | Текущая дата |
{datetime} | Текущая дата и время в 24-часовом формате |
{datetime12} | Текущая дата и время в 12-часовом формате |
{timestamp} | Текущая метка времени Unix (секунды) |
АргументыСсылка на этот раздел
То, что участники пишут после своей команды, например `?hug @kovu`.
| Переменная | Что делает |
|---|---|
$N | Аргумент N (с 1)Свои командыПример: You chose $1 |
$N+ | Аргумент N и всё после негоСвои командыПример: Reason: $2+ |
ДействияСсылка на этот раздел
Меняют то, что происходит при запуске своей команды.
| Переменная | Что делает |
|---|---|
{delete} | Удалить сообщение, вызвавшее командуСвои команды |
{silent} | Скрыть обычный ответ ботаСвои команды |
{noeveryone} | Никогда не упоминать @everyone/@here |
{!command} | Выполнить другую команду ботаСвои командыПример: {!role $1 Regulars} |
ОграниченияСсылка на этот раздел
Определяют, кто и где может использовать свою команду.
| Переменная | Что делает |
|---|---|
{require:role} | Использовать могут только участники с этой ролью (или serverMod)Свои командыПример: {require:Staff} |
{require:#channel} | Можно использовать только в этом каналеСвои команды |
{not:role} | Участники с этой ролью не могут её использоватьСвои команды |
{not:#channel} | Нельзя использовать в этом каналеСвои команды |
ВыводСсылка на этот раздел
Отправляют ответ в другое место.
| Переменная | Что делает |
|---|---|
{respond:#channel} | Отправить ответ в другой каналСвои команды |
{dm} | Отправить ответ в ЛС пользователю |
{dm:user} | Отправить ответ в ЛС конкретному пользователюСвои команды |
СлучайноСсылка на этот раздел
Каждый раз выбирают что-то случайное.
| Переменная | Что делает |
|---|---|
{choose:a;b;c} | Выбрать случайный вариантПример: {choose:pie;cake;ice cream} |
{choice} | Куда подставляется результат {choose} |
{chooseN:a;b} | Нумерованный choose для нескольких независимых выборовПример: {choose2:red;blue} ... {choice2} |
{choiceN} | Куда подставляется {chooseN} |
Блоки сообщенийСсылка на этот раздел
Сообщения, которые вы пишете для Kovu, собираются из блоков в конструкторе сообщений — так же, как Discord строит сообщения приложений. Переменные работают в любом тексте, ссылке и изображении каждого блока.
| Блокировать | Что делает |
|---|---|
| Текст | Текст Markdown: заголовки, списки, цитаты, ссылки с текстом и переменные. |
| Карточка | Рамка с цветной полосой слева, в которую входят другие блоки. Используйте цвет эмбедов сервера, выберите свой или уберите полосу. |
| Секция | От одного до трёх текстов с миниатюрой или кнопкой-ссылкой рядом. |
| Галерея | От одного до десяти изображений сеткой, у каждого есть альтернативный текст, а при желании его можно скрыть как спойлер. |
| Разделитель | Отступ между блоками, маленький или большой, с линией или без. |
| Кнопки | Ряд до пяти кнопок-ссылок. В Конструкторе эмбедов ряд может содержать и кнопки и меню, настроенные как действия. |
| Часть модуля | Место, куда модуль ставит свои элементы: кнопки панели тикетов, роли меню ролей за реакции или приветственную карточку. Если его нет, Kovu ставит их на обычное место. |
- Новое сообщение начинается с одного текста, который можно поместить в карточку с цветом. При добавлении блока сначала предлагаются готовые макеты, например карточка с изображением.
- Одно сообщение вмещает до 40 компонентов (считаются блоки, кнопки и ряды, а также собственные кнопки модуля) и около 4 000 символов текста. Конструктор считает и то и другое по ходу правки.
- Сообщение только из текста, с кнопками-ссылками или без, по-прежнему отправляется обычным сообщением, чтобы у ссылок оставался предпросмотр.
Сообщения, сохранённые раньше
Они сохраняют классический макет из текста и эмбедов и отправляются как всегда. Чтобы перевести сообщение на блоки, откройте его и переключите макет: Kovu покажет его до и после и перечислит, что будет выглядеть иначе, например маленькие значки рядом с автором и подвалом эмбеда или поля в ряд, которые встанут друг под другом. Отмена ничего не меняет.