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

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

Основная команда для создания кнопок /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. weekly - получить случайный еженедельный квест	Да

Руководство по созданию квестов

Квест: получить награду

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} eph reply

Аргументы:

Название	Описание	Обязательный
eph	Если есть, то сообщение будет видно только нажавшему кнопку	Нет
reply	Если есть, то сообщение будет отправлено ответным сообщением	Нет
usr	ID пользователя, который сможет использовать кнопку, если отсутствует - использовать могут все	Нет
mbr	ID пользователя, чей профиль будет выводится, если отсутствует - выводится профиль использовавшего кнопку	Нет

Инвентарь

ID: cmd{inventory} eph reply

Аргументы:

Название	Описание	Обязательный
eph	Если есть, то сообщение будет видно только нажавшему кнопку	Нет
reply	Если есть, то сообщение будет отправлено ответным сообщением	Нет
usr	ID пользователя, который сможет использовать кнопку, если отсутствует - использовать могут все	Нет
mbr	ID пользователя, чей инвентарь будет выводится, если отсутствует - выводится инвентарь использовавшего кнопку	Нет

Достижения

ID: cmd{achievements} eph reply

Аргументы:

Название	Описание	Обязательный
eph	Если есть, то сообщение будет видно только нажавшему кнопку	Нет
reply	Если есть, то сообщение будет отправлено ответным сообщением	Нет
usr	ID пользователя, который сможет использовать кнопку, если отсутствует - использовать могут все	Нет
mbr	ID пользователя, чьи достижения будет показываться, если отсутствует - показываются достижения использовавшего кнопку	Нет

Ранг

ID: cmd{rank} 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 используются для вывода сообщения из определенного канала. Таким образом можно создать кнопку, которое будет выводить любое сообщение из любого канала.

635KB

Видео 17-06-2023 11_26_02.mp4

Вывод сообщения через аргументы channelId и messageId производится вместе с кнопками и файлами прикрепленными к данному сообщению.

Если в форму команды say вставить ссылку на сообщение, то бот выведет полностью скопированное сообщение.

2MB

Видео 17-06-2023 11_36_45.mp4

Статистика

ID: cmd{stats} eph reply

Аргументы:

Название	Описание	Обязательный
eph	Если есть, то сообщение будет видно только нажавшему кнопку	Нет
reply	Если есть, то сообщение будет отправлено ответным сообщением	Нет
usr	ID пользователя, который сможет использовать кнопку, если отсутствует - использовать могут все	Нет
mbr	ID пользователя, чья статистика будет выводится, если отсутствует - выводится статистика использовавшего кнопку	Нет

Инвентарь ролей

ID: cmd{inventory-roles} eph reply

Аргументы:

Название	Описание	Обязательный
eph	Если есть, то сообщение будет видно только нажавшему кнопку	Нет
reply	Если есть, то сообщение будет отправлено ответным сообщением	Нет
usr	ID пользователя, который сможет использовать кнопку, если отсутствует - использовать могут все	Нет
mbr	ID пользователя, чей инвентарь ролей будет выводится, если отсутствует - выводится инвентарь ролей использовавшего кнопку	Нет

Создание кастомной роли

ID: cmd{custom-role}