Wiki / Core Features / Пользовательские команды

Пользовательские команды

Обновлено Maxime_48 · 3 часа назад · Просмотры: 111

Языки: English Français Deutsch Español Português (Brasil) Italiano Nederlands Polski Türkçe Русский 日本語 한국어 中文

Пользовательские команды позволяют создавать собственные слэш-команды для вашего сервера. Участники вводят /yourcommand, а бот отвечает сообщением или эмбедом, который вы задали, без программирования. Всё управляется из веб-панели.

Страница пользовательских команд с двумя командами, текстовым ответом и ответом-эмбедом, с их перезарядкой и ограничениями по ролям


⚡ Как это работает

  1. Включите функцию Пользовательские команды для вашего сервера.
  2. Откройте отдельную страницу Пользовательские команды.
  3. Нажмите + Новая команда, выберите название и напишите ответ.
  4. Сохраните: команда автоматически регистрируется на вашем сервере.

Участники смогут использовать её через несколько мгновений. Каждый раз, когда вы добавляете, изменяете или удаляете команду, YAWBDB заново регистрирует команды вашего сервера за вас.

Хотите !rules вместо /rules? Задайте текстовый префикс в Функции → Текстовые команды, и каждая команда на этой странице будет отзываться и на него, как в простом режиме, так и в режиме графа. Подробности и список того, до чего префикс не дотягивается: Текстовые команды и префикс.


✍️ Создание команды

У каждой команды есть:

  • Название - то, что участники вводят после слэша (/rules, /socials…). Только строчные буквы, цифры, - и _, до 32 символов.
  • Описание - короткий текст, который Discord показывает при просмотре ваших команд.
  • Тип команды - простой ответ (текст или эмбед, покрывает большинство потребностей) или продвинутый граф (визуальный редактор узлов, см. ниже).
  • Тип ответа - для простых команд: обычное текстовое сообщение или насыщенный эмбед.

Текстовый ответ

Просто напишите сообщение, которое должен отправить бот. Подходит для быстрых ответов, ссылок или сведений о сервере.

Ответ-эмбед

Создайте оформленную карточку с:

  • Заголовком и описанием
  • Цветом (hex, например #5865F2)
  • Изображением и миниатюрой (URL)
  • Текстом нижнего колонтитула

Для эмбеда нужен хотя бы заголовок или описание.


🧩 Продвинутый режим: графы команд

Переключите команду на Продвинутый (граф), чтобы выстроить её поведение в том же визуальном редакторе узлов, что используется для графа наград Leveling. Вместо фиксированного ответа вы соединяете узлы цепочкой:

  • Триггер - каждый граф начинается с триггера Команда использована. Он срабатывает каждый раз, когда участник запускает команду.
  • Условия - имеет роль / не имеет роли, бустер сервера, временное окно, день недели, возраст сервера и аккаунта, диапазон уровней, диапазон XP, серия, престиж.
  • Логика - вентили И / ИЛИ / НЕ (AND / OR / NOT), случайная ветка, задержка, перезарядка, последовательность.
  • Действия - Ответить (сообщение, отправляемое в ответ, обязательно), назначение/снятие/замена ролей, выдача XP, отправка личного сообщения, публикация в канале, блокировка/разблокировка канала, назначение титула, временный множитель XP.

Действие «Ответить»

Граф команды должен содержать хотя бы одно действие Ответить: это сообщение, которое видит участник. Ответы поддерживают динамические переменные: {username}, {level}, {xp}, {streak}, {prestige}, {server}. Если условия отфильтровывают все действия «Ответить» в конкретном запуске, бот просто подтверждает команду значком ✓.

{prestige} естественно сочетается с условием Имеет престиж: привяжите ответ к рангу престижа, а затем назовите этот ранг в сообщении.

Вы можете добавить несколько действий «Ответить» на разных ветках, например разный ответ для бустеров или случайный выбор из нескольких ответов.

✨ Пусть ассистент построит

Graph Assistant может составить черновик графа команды по описанию и предложить его вам на проверку.

ℹ️ Что может карточка здесь

У каждой карточки есть кнопка (i), которая показывает, что она читает, какое поле сделает её бесполезной и какие переменные на ней допустимы. Особенно стоит открыть её в графе команды, потому что команда несёт меньше информации, чем событие уровней.

Панель зачёркивает всё недоступное, так что вы видите это с первого взгляда, а не обнаруживаете на графе, который никогда не срабатывает. Команда знает уровень участника, XP, серию, престиж, роли, возраст аккаунта и время на сервере, но не знает, какими эти значения были раньше, и не имеет контекста XP-событий или Wordle. Поэтому карточкам, построенным вокруг изменения, например Порог XP, здесь не с чем сравнивать.

Полное описание панели: Reward graph.

Идеи

  • /daily - узел «Перезарядка» (24 ч), ведущий к Выдать XP + Ответить («Here's your daily bonus!»). Пока идёт перезарядка, ветка с наградой пропускается, и бот просто подтверждает значком ✓.
  • /color - проверьте условие роли, затем случайно назначьте одну из нескольких цветовых ролей и подтвердите ответом.
  • /vip - ветка только для бустеров, которая открывает канал и отвечает приватно.

Редактору графов нужен экран компьютера; на мобильном вы увидите сводку только для чтения.


⚙️ Параметры

Параметр Что делает
Ограничить ролями Использовать команду могут только участники с одной из выбранных ролей. Оставьте пустым, чтобы разрешить всем.
Перезарядка Минимальная задержка (в секундах) между использованиями, на участника. 0 означает отсутствие перезарядки.
Ответ виден только участнику Ответ показывается приватно (ephemeral) тому, кто запустил команду.
Включена Включайте и отключайте команду, не удаляя её.

🚫 Зарезервированные названия

Пользовательская команда не может использовать название, уже занятое одной из встроенных команд бота (например, rank, leaderboard, report, ticket, wordle, voice…). Панель сообщит, если название занято.

Название каждой команды также должно быть уникальным на вашем сервере.


📦 Лимиты

В зависимости от вашей конфигурации число пользовательских команд на сервере может быть ограничено. Если лимит действует, страница показывает ваше текущее количество относительно него. Сам Discord ограничивает общее число команд на сервер, и этот лимит делится со встроенными командами бота.


👍 Рекомендуемая настройка

  1. Включите функцию и откройте страницу «Пользовательские команды».
  2. Для начала создайте простую текстовую команду /rules или /info.
  3. Добавьте команду с эмбедом для чего-то более насыщенного, например /socials.
  4. Используйте «Ограничить ролями» для команд только для персонала.
  5. Добавьте небольшую перезарядку командам, которые люди могут спамить.

💡 Рекомендации

  • Делайте названия короткими и предсказуемыми, чтобы участники могли их угадать.
  • Используйте ephemeral-ответы для ответов, которые нужно видеть только запросившему.
  • Добавляйте перезарядку весёлым или шумным командам.
  • Отключайте команду вместо удаления, если она нужна лишь изредка.