Links
Comment on page
🆒

Создание кастомных кнопок

Руководство по созданию кнопок с функционалом некоторых команд
Основная команда для создания кнопок /components

Аргументы команды /components buttons add:

Аргумент
Описание
Обязательный
ссылка-на-сообщение / message_url
Ссылка на сообщение, для которого будет добавлена кнопка
Да
стиль / style
Стиль кнопки: Ссылка(Link) - кнопка ссылка
Да
id-или-ссылка / id-or-url
ID кнопки или сссылка на ресурс (Если стиль - Ссылка(Link)
Да
строка / row
Строка компонента, куда будет добавлена кнопка
Да
колонка / column
Колонка компонента, куда будет добавлена кнопка
Да
название / label
Название кнопки
Нет
эмодзи / emoji
Эмодзи кнопки
Нет
выключена / disabled
Будет ли выключена кнопка
Нет
Аргументы "название" или "эмодзи" обязательны к заполнению

Аргументы команды /components buttons remove:

Аргумент
Описание
Обязательный
ссылка-на-сообщение / message_url
Ссылка на сообщение, в котором будет удалена кнопка
Да
строка / row
Строка компонента, где будет удалена кнопка
Да
колонка / column
Колонка компонента, где будет удалена кнопка
Да

Доступные команды для кнопок:

Получить подарок
Купить
Продать
Взять квест
Квест: получить награду
ID: cmd{get-gift}gift{giftId}
Аргументы:
Название
Описание
Обязательный
gift
ID подарка
Да
ID: cmd{buy}item{itemId}amount{10}price_type{currency}price{10} prms-off dscnt-off limits-off
Аргументы:
Название
Описание
Обязательный
item
ID предмета
Да
amount
Количество для покупки
Нет
price_type
Цена: ID предмета; currency - валюта сервера
Нет
price
Цена: количество
Нет
prms-off
Отключает права на покупку, если таковые имеются
Нет
dscnt-off
Отключает скидку в зависимости от репутации
Нет
limits-off
Отключает лимиты на покупку
Нет
ignr-shop
Игнорирует наличие и количество предмета в магазине
Нет
ID: cmd{sell}item{itemId}amount{10}
Аргументы:
Название
Описание
Обязательный
item
ID предмета
Да
amount
Количество для продажи
Нет
ID: cmd{quest-give-to-user}quest{questId}
Аргументы:
Название
Описание
Обязательный
quest
Возможные значения: 1. ID квеста 2. active - получить все активные квесты 3. daily - получить случайный ежедневный квест 4. получить случайный еженедельный квест
Да
ID: cmd{getQuestReward}quest{questId}
Аргументы:
Название
Описание
Обязательный
quest
ID квеста
Нет
При отсутствии аргумента quest, пользователь получит награды со всех квестов.
Отменить квест
Выдать предмет
Забрать предмет
Команды бота
ID: cmd{quest-take-from-user}quest{questId}
Аргументы:
Название
Описание
Обязательный
quest
ID квеста
Да
ID: cmd{give-item}item{itemId}amount{10}usr{userId}
Аргументы:
Название
Описание
Обязательный
item
ID предмета
Да
amount
Количество для продажи
Нет
usr
Пользователь для которого будет выдан предмет, если отсутствует - будет выдано пользователю использовавшему кнопку
Нет
ID: cmd{take-item}item{itemId}amount{10}usr{userId}
Аргументы:
Название
Описание
Обязательный
item
ID предмета
Да
amount
Количество для продажи
Нет
usr
Пользователь у которого будет убран предмет, если отсутствует - будет убран у пользователя использовавшего кнопку
Нет
ID: cmd{help}commands eph reply
Аргументы:
Название
Описание
Обязательный
eph
Если есть, то сообщение будет видно только нажавшему кнопку
Нет
reply
Если есть, то сообщение будет отправлено ответным сообщением
Нет
Профиль
Инвентарь
Достижения
Ранг
Ранг-установить
ID: cmd{profile}mbr{userId}usr{userId} eph reply
Аргументы:
Название
Описание
Обязательный
eph
Если есть, то сообщение будет видно только нажавшему кнопку
Нет
reply
Если есть, то сообщение будет отправлено ответным сообщением
Нет
usr
ID пользователя, который сможет использовать кнопку, если отсутствует - использовать могут все
Нет
mbr
ID пользователя, чей профиль будет выводится, если отсутствует - выводится профиль использовавшего кнопку
Нет
ID: cmd{inventory}mbr{userId}usr{userId} eph reply
Аргументы:
Название
Описание
Обязательный
eph
Если есть, то сообщение будет видно только нажавшему кнопку
Нет
reply
Если есть, то сообщение будет отправлено ответным сообщением
Нет
usr
ID пользователя, который сможет использовать кнопку, если отсутствует - использовать могут все
Нет
mbr
ID пользователя, чей инвентарь будет выводится, если отсутствует - выводится инвентарь использовавшего кнопку
Нет
ID: cmd{achievements}mbr{userId}usr{userId} eph reply
Аргументы:
Название
Описание
Обязательный
eph
Если есть, то сообщение будет видно только нажавшему кнопку
Нет
reply
Если есть, то сообщение будет отправлено ответным сообщением
Нет
usr
ID пользователя, который сможет использовать кнопку, если отсутствует - использовать могут все
Нет
mbr
ID пользователя, чьи достижения будет показываться, если отсутствует - показываются достижения использовавшего кнопку
Нет
ID: cmd{rank}mbr{userId} eph reply
Аргументы:
Название
Описание
Обязательный
eph
Если есть, то сообщение будет видно только нажавшему кнопку
Нет
reply
Если есть, то сообщение будет отправлено ответным сообщением
Нет
mbr
ID пользователя, чья карточка будет показываться, если отсутствует - показывается карточка использовавшего кнопку
Нет
ID: cmd{rank-set} eph reply
Аргументы:
Название
Описание
Обязательный
eph
Если есть, то сообщение будет видно только нажавшему кнопку
Нет
reply
Если есть, то сообщение будет отправлено ответным сообщением
Нет
Сказать
Статистика
ID: cmd{say}channelId{ID}messageId{ID}permission{ID} eph reply
Аргументы:
Название
Описание
Обязательный
eph
Если есть, то сообщение будет видно только нажавшему кнопку
Нет
reply
Если есть, то сообщение будет отправлено ответным сообщением
Нет
update
Если есть, то сообщение будет отредактировано
Нет
channelId
ID канала для поиска сообщения
Нет
messageId
ID сообщения
Нет
permission
ID права
Нет
Аргументы channelId и messageId используются вместе, нельзя использовать что-то одно
Аргументы channelId и messageId используются для вывода сообщения из определенного канала. Таким образом можно создать кнопку, которое будет выводить любое сообщение из любого канала.
Видео 17-06-2023 11_26_02.mp4
635KB
Binary
Вывод сообщения через аргументы channelId и messageId производится вместе с кнопками и файлами прикрепленными к данному сообщению.
Если в форму команды say вставить ссылку на сообщение, то бот выведет полностью скопированное сообщение.
Видео 17-06-2023 11_36_45.mp4
2MB
Binary
ID: cmd{stats}mbr{userId}usr{userId} eph reply
Аргументы:
Название
Описание
Обязательный
eph
Если есть, то сообщение будет видно только нажавшему кнопку
Нет
reply
Если есть, то сообщение будет отправлено ответным сообщением
Нет
usr
ID пользователя, который сможет использовать кнопку, если отсутствует - использовать могут все
Нет
mbr
ID пользователя, чья статистика будет выводится, если отсутствует - выводится статистика использовавшего кнопку
Нет
Last modified 1mo ago