От первой команды
до своей игры.

SilentBot — многофункциональный бот для Discord. В нём есть готовые модули (модерация, уровни, экономика, кланы, музыка, тикеты и другие) и конструктор своих команд с собственным языком шаблонов. Всё настраивается на этом сайте, а в Discord вы просто пользуетесь результатом.

Как устроена документация

Документация разделена на пять частей. Читать всё подряд не обязательно, выбирайте свою дорогу:

• Администратору сервера хватит частей «Знакомство» и «Модули сервера»: там описаны все слэш-команды и каждая настройка панели.
• Тем, кто хочет делать свои команды, подойдёт «Учебник». Он начинается с самых простых вещей и шаг за шагом доходит до игр с сохранением прогресса. Знать программирование заранее не нужно.
• Тем, кто уже умеет, пригодятся «Проекты» и «Справочник» со всеми функциями движка.

За пять минут: добавить бота, войти на сайт и разобраться, где какие настройки.

1. Добавьте бота на сервер. На главной странице нажмите «Добавить на сервер» и выберите сервер. Нужны права «Управлять сервером». Оставьте боту все права, которые он запрашивает: без них не будут работать модерация, роли и тикеты.
2. Войдите на сайт через Discord. Кнопка «Войти» вверху страницы. В разделе «Мои серверы» появятся серверы, где вы администратор.
3. Поднимите роль бота. В настройках сервера Discord → «Роли» перетащите роль SilentBot выше ролей, которые бот должен выдавать. Discord не даёт ботам управлять ролями выше их собственной.
4. Откройте панель сервера и пройдитесь по вкладкам ниже.

Вкладки панели управления

Два способа вызвать команду

Модерация состоит из трёх слоёв. Первый — команды для модераторов. Второй — журнал аудита, который записывает, что происходит на сервере. Третий — автомод и лестница наказаний, которые работают сами, без участия людей.

Команды модераторов

Каждое наказание сохраняется как дело с номером. Его можно найти в /дела история и отменить через /дела отменить: снять предупреждение, досрочно закончить мут или разбанить. Длительность пишется так: 30m, 2h, 1d2h, также понимаются 30м и 2ч. У /бан можно указать срок, и тогда бан снимется сам.

В угловых скобках указаны обязательные параметры, в квадратных — необязательные. Наведите на параметр, чтобы увидеть подсказку.

Лестница наказаний

Команда /предупреждение копит предупреждения, а бот сам наказывает, когда их становится слишком много. Например: 3 предупреждения дают мут на час, 5 — кик, 7 — бан. Значение 0 выключает ступень. Предупреждения могут сгорать через заданное число дней, чтобы старые нарушения не тянулись вечно.

Журнал аудита

Вкладка «Модерация и журнал». Укажите канал и отметьте нужные события:

Автомод

Автомод настраивается на вкладке «Автомод» и включает пять фильтров. Каждый включается отдельно:

Для доверенных ролей и каналов есть исключения: например, модераторы могут кидать инвайты, а в канале #мемы можно писать капсом.

Два модуля во вкладке «Модули» защищают сервер от ботов и массовых набегов.

Проверка новичков

Бот публикует панель с кнопкой «Я не бот». Новичок нажимает её и решает простой пример вроде «Сколько будет 4 + 7?», после чего получает роль доступа. Можно заодно снимать роль «Новичок». Если пример не нужен, выключите его, и хватит одного нажатия.

1. Создайте роль, например «Проверен», и откройте ей каналы сервера. У роли @everyone оставьте доступ только к каналу проверки.
2. Заполните модуль «Проверка новичков» и нажмите «Опубликовать панель проверки».

Защита от рейдов

Если за короткое время заходит слишком много аккаунтов, например 10 за 15 секунд, бот поднимает тревогу. Он может только оповестить модераторов, кикнуть всех, кто зашёл во время рейда, или поднять уровень проверки сервера до «Высокого». Отдельная настройка кикает слишком молодые аккаунты, созданные меньше N дней назад.

Модуль встречает новичков сообщением и картинкой-карточкой с аватаркой, может написать им в личку, прощается с ушедшими и сразу выдаёт стартовые роли.

В текстах можно использовать подстановки: {user} (упоминание), {user.name}, {server}, {members} (номер участника) и \n для переноса строки.

Добро пожаловать на **{server}**, {user}! Ты наш {members}-й участник 🎉
Загляни в #правила и выбери роли в #роли.

Участники получают опыт за сообщения и растут в уровнях. За уровни можно выдавать роли, а некоторым ролям давать ускоренный опыт.

Опыт — вкладка «Уровни»

Здесь задаются опыт за одно сообщение, кулдаун (сообщения чаще, чем раз в N секунд, опыта не дают, так спамом не прокачаться) и общий множитель. Там же включаются объявления о новом уровне и выбирается их канал.

Награды — модуль «Награды за уровни»

• Роль за уровень: например, «Активный» на 5 уровне и «Ветеран» на 20.
• Оставлять прошлые роли или держать только роль за самый высокий уровень.
• Множители ролей: бустерам 150% опыта. Если подходит несколько ролей, берётся самый большой множитель.
• Каналы без опыта: флуд-каналы, боты, #spam.
• Поздравление с подстановкой {level} и карточка ранга для /ранг.

Команды

Встроенная экономика: кошелёк и банк, ежедневные и еженедельные награды, работа, магазин, переводы, азартные игры и достижения. Новичок начинает с 500 монет.

Кошелёк и банк

Монеты в кошельке можно потратить, проиграть или потерять при ограблении. Монеты в банке в безопасности. Переводите их командами /депозит и /снять.

Слоты

Три одинаковых символа умножают ставку: 🍒 ×2, 🍋 ×3, 🍇 ×4, ⭐ ×5, 💎 ×8, 👑 ×12. Чем ценнее символ, тем реже он выпадает. Ещё есть /монетка (50 на 50), /дуэль против другого игрока и рискованное /ограбить.

Все команды экономики

Кланы — это MMO внутри Discord. Игроки объединяются, копят казну, выполняют задания, строят цитадель, воюют с другими кланами и вместе ходят в рейды на боссов. Всё управляется одной командой /клан: она открывает интерактивную панель с разделами.

• Создание клана стоит 100 000 монет экономики. В клане может быть до 30 участников, улучшения добавляют места.
• Роли внутри клана: лидер (всё), офицеры (помощники лидера), участники.
• Если включена публичная страница сервера, лучшие кланы видны и на сайте.

Пять модулей для жизни сообщества. Все, кроме розыгрышей, настраиваются во вкладке «Модули» и переживают перезапуск бота: кнопки продолжают работать.

Тикеты поддержки

В выбранном канале появляется панель с кнопкой «Создать обращение». Нажатие создаёт приватный канал, который видят только автор и роли поддержки. Когда вопрос решён, тикет закрывают, и расшифровка всей переписки уходит в канал логов. Можно ограничить число открытых тикетов на одного участника.

Розыгрыши

Команда /розыгрыш создать публикует карточку с кнопкой участия. Длительность — от 1 минуты до 60 дней (30m, 2h, 3d), победителей — до 20. Участие можно ограничить ролью или минимальным уровнем. Итоги подводятся автоматически. Если победитель не отозвался, есть /розыгрыш перевыбрать. Нужно право «Управлять сервером».

Роли по кнопкам

Меню из кнопок, по одной на каждую роль: «🎮 Геймер», «🎨 Художник»… Режим «можно несколько» переключает роли, режим «только одна» снимает остальные роли этого меню. На сервере может быть до 25 меню, в каждом до 25 ролей. Роли с правами модерации или администратора бот выдавать откажется, это защита от ошибок.

Приватные голосовые комнаты

Участник заходит в канал «➕ Создать комнату» и попадает в свою комнату. В её текстовом чате появляются кнопки 🔒 закрыть или открыть, 👥 лимит и ✏️ название. Пустая комната удаляется сама.

Оповещения YouTube

Вставьте ссылку на канал или @handle и выберите канал Discord. Бот проверяет новые видео каждые 5 минут, API-ключ не нужен. Текст оповещения можно изменить, по умолчанию он такой:

📺 Новое видео на канале **{author}**: {title}
{url}

Музыка в голосовых каналах, мини-игры и полезные инструменты.

Музыка

Зайдите в голосовой канал и напишите /играть с названием трека или ссылкой, плейлисты тоже подходят. /поиск покажет несколько вариантов в меню. Очередью управляют кнопки плеера и команды ниже.

Развлечения

/пейнт — общий холст, на котором рисует весь сервер. /бродилка — процедурный мир 12×12, по которому можно гулять.

Полезное

Информация

/хелп показывает команды по категориям на языке, выбранном в панели. Ваши собственные команды туда тоже попадают.

Возможности сайта помимо панели настроек.

Своя команда — это шаблон: текст, в котором некоторые места бот заполняет сам. Начнём с самого простого приветствия и к концу учебника дойдём до игр с сохранением прогресса.

1. Откройте панель сервера → «Команды и триггеры» → «Создать команду».
2. Придумайте имя, например привет. По нему команду будут вызывать: /привет или !привет.
3. Напишите шаблон, посмотрите результат в эмуляторе справа и нажмите «Сохранить». Через пару секунд команда появится в меню / на сервере.

Главное правило: фигурные скобки

Всё, что вне фигурных скобок, бот отправит как есть. То, что внутри {…}, он вычислит и подставит результат. {user.mention} превратится в упоминание того, кто вызвал команду, а {guild.name} — в название сервера.

Приветствие в одну строку

Привет, {user.mention}! 👋
Добро пожаловать на **{guild.name}**.

Результат в Discord

T

TesterСегодня

/привет

SilentBotБОТСегодня

Привет, @Tester! 👋
Добро пожаловать на Silent Server.

Открыть в редакторе

Сообщение и панель

В редакторе два поля, и у каждого своя роль:

То же приветствие, но карточкой

title: 👋 Привет, {user.display_name}!
description: Рады видеть тебя на **{guild.name}**.\nНас уже **{guild.member_count}**.
color: #5865F2
thumbnail: {user.avatar}

Результат в Discord

T

TesterСегодня

/привет

SilentBotБОТСегодня

👋 Привет, Tester!

Рады видеть тебя на Silent Server.
Нас уже 142.

Открыть в редакторе

Попробуйте сами Команда /правила

Сделайте команду правила: карточку с заголовком «📜 Правила {guild.name}», тремя пунктами в описании через \n и цветом #e74c3c.

title: 📜 Правила {guild.name}
description: 1. Уважайте друг друга\n2. Без спама и рекламы\n3. Споры решаем в личке
color: #e74c3c

Результат в Discord

T

TesterСегодня

/правила

SilentBotБОТСегодня

📜 Правила Silent Server

1. Уважайте друг друга
2. Без спама и рекламы
3. Споры решаем в личке

Открыть в редакторе

Переменная — это имя в фигурных скобках, вместо которого бот подставит значение: кто вызвал команду, на каком сервере и в каком канале. Путь пишется через точку: {объект.свойство}.

Карточка профиля из одних переменных

title: 🪪 {user.display_name}
thumbnail: {user.avatar}
color: #82e0ff
field: Упоминание | {user.mention} | true
field: ID | {user.id} | true
field: Главная роль | {user.top_role} | true
field: Сервер | {guild.name} ({guild.member_count} участников) | false
field: Канал | {channel.mention} | false
footer: Команда вызвана в #{channel.name}

Результат в Discord

T

TesterСегодня

/профиль

SilentBotБОТСегодня

🪪 Tester

Упоминание

@Tester

ID

7

Главная роль

@Member

Сервер

Silent Server (142 участников)

Канал

#канал

Команда вызвана в #основной

Открыть в редакторе

Попробуйте сами Карточка сервера

Соберите карточку «О сервере»: иконка сервера в thumbnail:, название в заголовке, в полях — число участников и бустов.

title: 🏠 {guild.name}
thumbnail: {guild.icon}
field: 👥 Участники | {guild.member_count} | true
field: 🚀 Бусты | {guild.boost_count} (уровень {guild.boost_level}) | true
color: #82e0ff

Результат в Discord

T

TesterСегодня

/сервер

SilentBotБОТСегодня

🏠 Silent Server

👥 Участники

142

🚀 Бусты

(уровень )

Открыть в редакторе

Аргументы — это то, что игрок написал после названия команды. В !обнять @Маша аргумент — @Маша. Благодаря аргументам одна команда умеет разные вещи.

Слова по номерам

Разбираем фразу на части

Всё целиком: **{args}**
Первое слово: **{args.1}**
Второе слово: **{args.2}**
Со второго до конца: **{args.2+}**
Сколько слов: **{args.count}**

Результат в Discord

T

TesterСегодня

/заказ меч огненный 3 штуки

SilentBotБОТСегодня

Всё целиком: меч огненный 3 штуки
Первое слово: меч
Второе слово: огненный
Со второго до конца: огненный 3 штуки
Сколько слов: 4

Открыть в редакторе

Если аргумента нет

Если слова нет, переменная будет пустой. Функция {default(значение, 'запасное')} подставит запасной вариант. Упоминание @друг приходит как настоящее упоминание, так что его можно просто вывести.

Обнимашки с запасным вариантом

{user.mention} крепко обнимает {default({args.1}, 'всех вокруг')} 🤗

Результат в Discord

T

TesterСегодня

/обнять @friend

SilentBotБОТСегодня

@Tester крепко обнимает @Friend 🤗

Открыть в редакторе

Слэш-опции: поля ввода в меню «/»

Вместо того чтобы помнить порядок слов, можно объявить опции. Discord покажет их как поля ввода с подсказками: выбор участника из списка, только числа и так далее. Опции задаются в редакторе, в разделе «Слэш-команда»:

• Типы опций: text, integer (целое), number, bool, user, channel, role. Для текста и чисел можно задать варианты на выбор.
• В шаблоне опция читается как {args.имя}. У участника, канала и роли есть ещё {args.имя.id} и {args.имя.name}.
• В текстовом вызове (!подарить @друг 50) опции заполняются по порядку слов, так что одна команда работает обоими способами.

Подарок с двумя опциями

Слэш-опции: кому (user), сумма (integer)

🎁 {user.mention} дарит {args.кому} **{args.сумма}** монет!

Результат в Discord

T

TesterСегодня

/подарить @friend 50

SilentBotБОТСегодня

🎁 @Tester дарит @Friend 50 монет!

Открыть в редакторе

Попробуйте сами Команда «кто лучший»

Команда !лучший отвечает «🏆 Лучший на сервере — …». Выводит того, кого указали, а если никого не указали — автора команды.

🏆 Лучший на сервере — {default({args.1}, {user.mention})}!

Результат в Discord

T

TesterСегодня

/лучший

SilentBotБОТСегодня

🏆 Лучший на сервере — @Tester!

Открыть в редакторе

Функция — это маленькая готовая программа. Вы отдаёте ей значения, а она возвращает результат: делает текст заглавным, считает длину, заменяет слова. Записывается так: {имя(аргумент1, аргумент2)}.

Три правила аргументов

1. Текст берётся в кавычки: 'мир'. Числа пишутся без кавычек: 5, 3.14.
2. Переменные и другие функции оборачиваются в свои фигурные скобки: {upper({user.name})}. Так функции вкладываются друг в друга сколько угодно раз.
3. Плюс внутри аргументов склеивает текст: {upper('привет, ' + {user.name})} даст «ПРИВЕТ, TESTER».

Функции для текста

Громко: {upper({args})}
С большой буквы: {capitalize({args})}
Задом наперёд: {reverse({args})}
Длина: {len({args})} символов
Звёзды: {repeat('⭐', 5)}
Замена: {replace({args}, 'мир', 'Discord')}

Результат в Discord

T

TesterСегодня

/текст привет мир

SilentBotБОТСегодня

Громко: ПРИВЕТ МИР
С большой буквы: Привет мир
Задом наперёд: рим тевирп
Длина: 10 символов
Звёзды: ⭐⭐⭐⭐⭐
Замена: привет Discord

Открыть в редакторе

Функция внутри функции

Твой ник капсом: **{upper({user.display_name})}**
Первые 3 буквы: **{slice({user.display_name}, 0, 3)}**

Результат в Discord

T

TesterСегодня

/ник

SilentBotБОТСегодня

Твой ник капсом: TESTER
Первые 3 буквы: Tes

Открыть в редакторе

Самые нужные функции для текста

Все функции с описанием собраны в справочнике.

Если внутри фигурных скобок стоит арифметика, бот её посчитает. {2 + 2} превратится в 4. Считать можно и значения переменных и функций, например {{store_get('coins', 0)} * 2}.

Калькулятор и форматирование

2 + 2 × 2 = **{2 + 2 * 2}**
Деление: {10 / 4} · целочисленное: {10 // 4} · остаток: {10 % 4}
Округление: {round(3.14159, 2)}
Большое число: {format_number(1234567, 'ru')}
Процент: {percent(37, 120)}%
Прогресс: {progress_bar(7, 10, 10)}

Результат в Discord

T

TesterСегодня

/математика

SilentBotБОТСегодня

2 + 2 × 2 = 6
Деление: 2.5 · целочисленное: 2 · остаток: 2
Округление: 3.14
Большое число: 1 234 567
Процент: 30.8%
Прогресс: ▰▰▰▰▰▰▰▱▱▱

Открыть в редакторе

Самое важное правило этого урока

Числа по-русски

plural_ru подбирает нужную форму слова к числу: 1 монета, 2 монеты, 5 монет, 21 монета.

Склонение

У тебя {args.1} {plural_ru({args.1}, 'монета', 'монеты', 'монет')}.

Результат в Discord

T

TesterСегодня

/монеты 21

SilentBotБОТСегодня

У тебя 21 монета.

Открыть в редакторе

Попробуйте сами Калькулятор скидки

!скидка 2500 15 выводит цену со скидкой 15% и сумму экономии.

{set('price', {to_int({args.1}, 0)})}
{set('off', {calc({get('price')} * {to_int({args.2}, 0)} / 100)})}
Цена со скидкой: **{format_number({calc({get('price')} - {get('off')})}, 'ru')}** ₽
Экономия: {format_number({get('off')}, 'ru')} ₽

Результат в Discord

T

TesterСегодня

/скидка 2500 15

SilentBotБОТСегодня

Цена со скидкой: 2 125 ₽
Экономия: 375 ₽

Открыть в редакторе

Случайность оживляет команды: кубики, лут из сундуков, шанс критического удара, ответы магического шара.

Кубик, монетка и сундук с шансами

🎲 Выпало: **{random(1, 6)}**
🪙 Монетка: **{choice('Орёл', 'Решка')}**
🎁 Из сундука: **{random(['🪵 Палка', '⚔️ Меч', '💎 Алмаз'], [70, 25, 5])}**

Результат в Discord

T

TesterСегодня

/кубик

SilentBotБОТСегодня

🎲 Выпало: 5
🪙 Монетка: Решка
🎁 Из сундука: 🪵 Палка

Открыть в редакторе

Магический шар

title: 🎱 Магический шар
description: **Вопрос:** {default({args}, 'а вопрос-то где?')}\n**Ответ:** {choice('Бесспорно', 'Скорее да', 'Спроси позже', 'Даже не думай', 'Звёзды молчат')}
color: #7d92e8

Результат в Discord

T

TesterСегодня

/шар я сегодня выиграю?

SilentBotБОТСегодня

🎱 Магический шар

Вопрос: я сегодня выиграю?
Ответ: Скорее да

Открыть в редакторе

Условие позволяет команде вести себя по-разному: пускать только взрослых, отвечать модераторам иначе, чем обычным участникам, проверять, хватает ли монет.

Блок {#if}

{#if условие}
  то, что выполнится, если условие верно
{#elif другое условие}
  если первое неверно, а это верно (веток elif может быть сколько угодно)
{#else}
  если ничего не подошло
{/if}

Ветки {#elif} и {#else} необязательны. Внутри веток может быть всё что угодно: текст, директивы карточки, другие условия.

Проверка возраста с тремя ветками

{#if {to_int({args.1}, 0)} >= 18}
🔞 Доступ открыт, тебе {args.1}.
{#elif {to_int({args.1}, 0)} > 0}
🧒 Подрасти немного — тебе всего {args.1}.
{#else}
❓ Напиши возраст числом: `!возраст 20`
{/if}

Результат в Discord

T

TesterСегодня

/возраст 20

SilentBotБОТСегодня

🔞 Доступ открыт, тебе 20.

Открыть в редакторе

Сравнения и связки

Текстовые проверки

{#if {args} contains 'кот'}🐱 Котики — лучшие!{#else}🤔 А где котики?{/if}
{#if {args.count} > 3 and not {args} contains 'собак'}Длинное сообщение без собак.{/if}

Результат в Discord

T

TesterСегодня

/чат я люблю котиков

SilentBotБОТСегодня

🐱 Котики — лучшие!

Открыть в редакторе

Как бот читает условие

Условие вычисляется в два шага. Сначала бот подставляет всё, что стоит в фигурных скобках внутри условия, и только потом сравнивает то, что получилось:

1. {#if {store_get('coins', 0)} >= 100 and {args.1} == 'меч'} — так написано.
2. {#if 250 >= 100 and меч == 'меч'} — так выглядит после подстановки (у игрока 250 монет, он написал «меч»).
3. верно и верно → верно, выполняется первая ветка.

Поэтому любое значение в условии — функция, переменная, аргумент — пишется в своих фигурных скобках, а сравниваемый текст — в кавычках.

Что считается «да», а что «нет»

Числа, текст и регистр

• Числа сравниваются как числа, даже если записаны в кавычках: '10' > '9' — верно.
• Текст сравнивается буква в букву, с учётом регистра: 'Привет' == 'привет' — неверно. То же с contains, startswith и endswith.
• Со списком (["меч","щит"]) эти три оператора смотрят на элементы, а не на буквы: contains 'щит' — такой элемент есть, startswith 'меч' — первый элемент «меч», endswith 'щит' — последний «щит».
• Чтобы регистр не мешал, приведите значение к нижнему регистру: {lower({args.1})} == 'секрет'.

Сравнение с учётом регистра и без

Как написали: {#if {args.1} == 'секрет'}✅ совпало{#else}❌ не совпало{/if}
Без учёта регистра: {#if {lower({args.1})} == 'секрет'}✅ совпало{#else}❌ не совпало{/if}

Результат в Discord

T

TesterСегодня

/пароль СЕКРЕТ

SilentBotБОТСегодня

Как написали: ❌ не совпало
Без учёта регистра: ✅ совпало

Открыть в редакторе

Несколько условий сразу

Связки объединяют проверки в одну:

• A and B — верно, только если верны оба.
• A or B — верно, если верно хотя бы одно.
• not A — переворачивает результат.

Порядок важен: and связывает сильнее, чем or, как умножение сильнее сложения. Запись A or B and C читается как A or (B and C). Если нужно иначе, ставьте круглые скобки:

Пример ниже проверяет сразу несколько вещей: передан ли товар, есть ли он в магазине и хватает ли уровня или монет для меча. Попробуйте в редакторе поменять значения coins и lvl.

Магазин: and, or и скобки

{set('coins', {store_get('coins', 40)})}{set('lvl', {store_get('lvl', 3)})}
{#if {args.1} == ''}
🛒 Укажите товар: `!купить меч` или `!купить щит`.
{#elif {args.1} != 'меч' and {args.1} != 'щит'}
❓ Товара «{args.1}» нет. Есть только меч и щит.
{#elif {args.1} == 'меч' and ({get('lvl')} < 5 or {get('coins')} < 100)}
🔒 Меч продаётся с **5 уровня** за **100** монет.
У вас: уровень {get('lvl')}, монет {get('coins')}.
{#else}
✅ Покупка «{args.1}» оформлена!
{/if}

Результат в Discord

T

TesterСегодня

/купить меч

SilentBotБОТСегодня

🔒 Меч продаётся с 5 уровня за 100 монет.
У вас: уровень 3, монет 40.

Открыть в редакторе

Порядок веток

Бот проверяет ветки сверху вниз и выполняет только первую подходящую, остальные пропускает. Поэтому самые строгие проверки ставьте выше общих. Если первой поставить {#if {coins} >= 10}, а под ней {#elif {coins} >= 1000}, вторая ветка не выполнится никогда: 1000 монет — это тоже «больше 10».

Условие внутри условия

Внутри любой ветки можно открыть ещё один {#if}. Это удобно, когда вторая проверка нужна только в одном случае. У каждого внутреннего блока должен быть свой {/if}.

Рыбалка: вложенные условия

{set('hour', 14)}{set('rod', 'bamboo')}
{#if {args.1} == 'река'}
🏞️ Вы на реке.
{#if {get('hour')} >= 5 and {get('hour')} < 10}🐟 Утренний клёв: поймали щуку!{#elif {get('rod')} == 'bamboo'}🎣 Бамбуковая удочка: поймали карася.{#else}🌊 Ничего не клюёт.{/if}
{#elif {args.1} == 'море'}
🌊 В море нужна лодка.
{#else}
🗺️ Куда пойдём? `!рыбалка река` или `!рыбалка море`
{/if}

Результат в Discord

T

TesterСегодня

/рыбалка река

SilentBotБОТСегодня

🏞️ Вы на реке.
🎣 Бамбуковая удочка: поймали карася.

Открыть в редакторе

Роли и права

{has_role('VIP')} и {has_perm('manage_messages')} возвращают true или false. Роль можно указать названием, ID или упоминанием.

Разные ответы для модераторов, VIP и остальных

{#if {has_perm('manage_messages')} == true}
🛡️ Ты модератор — тебе можно всё.
{#elif {has_role('VIP')} == true}
👑 Привет, VIP!
{#else}
🙂 Обычный участник. Хочешь VIP? Спроси у админов.
{/if}

Результат в Discord

T

TesterСегодня

/доступ

SilentBotБОТСегодня

🙂 Обычный участник. Хочешь VIP? Спроси у админов.

Открыть в редакторе

Условие в одну строку

Когда нужно выбрать одно из двух слов прямо в тексте, удобнее функция if(условие, 'да', 'нет'). Для нескольких вариантов подойдёт switch, а для запасного значения — default.

if и switch

Число {args.1} — {if({even({args.1})} == true, 'чётное', 'нечётное')}.
Оценка: {switch({args.1}, '5', 'отлично 🏆', '4', 'хорошо 👍', 'надо подтянуть 📚')}

Результат в Discord

T

TesterСегодня

/статус 5

SilentBotБОТСегодня

Число 5 — нечётное.
Оценка: отлично 🏆

Открыть в редакторе

Попробуйте сами Приветствие по времени суток

Команда здоровается «Доброе утро», «Добрый день» или «Добрый вечер» в зависимости от часа по Москве. Подсказка: {date('%H', '+3h')} вернёт текущий час.

{set('h', {to_int({date('%H', '+3h')}, 0)})}
{#if {get('h')} < 6}🌙 Доброй ночи{#elif {get('h')} < 12}☀️ Доброе утро{#elif {get('h')} < 18}🌤️ Добрый день{#else}🌆 Добрый вечер{/if}, {user.mention}!

Результат в Discord

T

TesterСегодня

/привет

SilentBotБОТСегодня

🌤️ Добрый день, @Tester!

Открыть в редакторе

Иногда значение нужно вычислить один раз, а использовать несколько: случайный бросок, итоговую цену, выбранный предмет. Для этого есть переменные команды.

Удар с шансом крита

{set('base', {to_int({args.1}, 10)})}
{set('roll', {random(1, 100)})}
{set('damage', {if({get('roll')} <= 25, {calc({get('base')} * 2)}, {get('base')})})}
⚔️ Удар на **{get('damage')}** урона{if({get('roll')} <= 25, ' — КРИТ! 💥', '')} (бросок {get('roll')})

Результат в Discord

T

TesterСегодня

/урон 15

SilentBotБОТСегодня

⚔️ Удар на 30 урона — КРИТ! 💥 (бросок 11)

Открыть в редакторе

Переменные в условиях

Переменную удобно вычислить один раз и потом проверять в нескольких местах. В условии её пишут в фигурных скобках, как любое значение: {#if {урон} > 50} или {#if {get('урон')} > 50}. Подробно про условия — в уроке «Условия и логика».

set, store или servervar: что выбрать

Три вида «переменных» отличаются тем, как долго живёт значение и чьё оно:

Пример: команду, которая прибавляет 1, по разу вызвали Вася и Петя. С store_inc('clicks') у Васи будет 1 и у Пети 1: у каждого свой счётчик. С servervar получится 2: счётчик общий. С set — 1 каждый раз, потому что значение не сохраняется между вызовами.

void: выполнить молча

Функции, которые что-то записывают (store_inc, store_set, list_push, lb_add…), возвращают результат, например новое значение счётчика, и он попадает в текст. Если он не нужен, оберните вызов в {void(…)}.

С void и без

Без void: {store_inc('visits', 1)} ← функция напечатала новое значение
{void(store_inc('visits', 1))}С void: ничего не напечатано, но счётчик вырос.
Сейчас посещений: **{store_get('visits', 0)}**

Результат в Discord

T

TesterСегодня

/посещения

SilentBotБОТСегодня

Без void: 1 ← функция напечатала новое значение
С void: ничего не напечатано, но счётчик вырос.
Сейчас посещений: 2

Открыть в редакторе

Карточка (в Discord её называют embed) — это рамка с цветной полосой, заголовком, текстом, полями и картинками. Она описывается в шаблоне панели: каждая строка начинается с директивы.

Карточка со всеми директивами

author: {guild.name} | https://discord.com | {guild.icon}
title: 📰 Новости сервера
url: https://discord.com
description: **Большое обновление!**\nДобавили кланы, магазин и еженедельные турниры.
color: #f1c40f
thumbnail: {user.avatar}
field: 🏰 Кланы | Создай свой — `/клан` | true
field: 🛒 Магазин | `/магазин` | true
field: 🏆 Турнир | Каждую субботу в 18:00 | false
image: https://cdn.discordapp.com/embed/avatars/2.png
footer: Опубликовал {user.display_name} | {user.avatar}
timestamp: now

Результат в Discord

T

TesterСегодня

/карточка

SilentBotБОТСегодня

Silent Server

📰 Новости сервера

Большое обновление!
Добавили кланы, магазин и еженедельные турниры.

🏰 Кланы

Создай свой — /клан

🛒 Магазин

/магазин

🏆 Турнир

Каждую субботу в 18:00

Опубликовал Tester • Сегодня

Открыть в редакторе

Мелочи, которые важно знать

• Строка без директивы приклеивается к описанию. Поэтому текст, который выводит функция на отдельной строке, попадёт в карточку. Здесь снова помогает void.
• После | в author: и footer: должна стоять настоящая ссылка https://… или ничего. {user.avatar} и {guild.icon} — это ссылки, а {user.name} — нет.
• В значении поля нельзя использовать символ |: он разделяет части директивы.
• Ограничения Discord: до 25 полей, значение поля до 1024 символов.

Попробуйте сами Карточка «Анонс»

Сделайте анонс турнира: жёлтая полоса, заголовок со ссылкой, три поля в ряд (дата, приз, взнос) и подпись с аватаркой автора.

title: 🏆 Турнир по шахматам
url: https://discord.com
description: Регистрация открыта! Жмите на заголовок.
color: #f1c40f
field: 📅 Дата | Суббота, 18:00 | true
field: 🎁 Приз | 5 000 💰 | true
field: 💳 Взнос | бесплатно | true
footer: Организатор: {user.display_name} | {user.avatar}

Результат в Discord

T

TesterСегодня

/анонс

SilentBotБОТСегодня

🏆 Турнир по шахматам

Регистрация открыта! Жмите на заголовок.

📅 Дата

Суббота, 18:00

🎁 Приз

5 000 💰

💳 Взнос

бесплатно

Организатор: Tester

Открыть в редакторе

Кнопки превращают карточку в маленькое приложение. У каждой кнопки есть ключ, и при нажатии выполняется блок {#action ключ} … {/action} с тем же ключом.

button: Надпись | ключ | стиль | режим | only_author | disabled

Первая интерактивная команда

Счётчик нажатий: кнопка прибавляет единицу. Нажмите «➕ Нажать» в превью, это настоящий результат движка.

Счётчик

title: 🔢 Счётчик
description: {user.mention}, нажатий: **{store_get('clicks', 0)}**
color: #5865F2
button: ➕ Нажать | inc | primary | edit | only_author
button: ♻️ Сброс | reset | danger | edit | only_author

{#action inc}
{void(store_inc('clicks', 1))}
{/action}

{#action reset}
{void(store_set('clicks', 0))}
{/action}

Результат в Discordкнопки нажимаются

T

TesterСегодня

/счётчик

SilentBotБОТСегодня

🔢 Счётчик

@Tester, нажатий: 0

➕ Нажать ♻️ Сброс

Открыть в редакторе

Что показывает карточка после нажатия

Это главная тонкость кнопок. Результат зависит от того, что выводит блок действия:

Режимы edit, reply и ephemeral и кнопка-ссылка

title: 🧪 Режимы кнопок
description: Нажмите каждую кнопку и сравните, куда приходит ответ.
color: #7d92e8
button: ✏️ edit | e | primary | edit
button: 💬 reply | r | success | reply
button: 🙈 ephemeral | h | secondary | ephemeral
newline:
button: 📖 Документация | https://discord.com | link

{#action e}
description: Карточка **изменилась**, а заголовок, цвет и кнопки остались — они берутся из основной панели.
{/action}

{#action r}
📨 Это новое сообщение в чате, его видят все.
{/action}

{#action h}
🤫 Это видишь только ты.
{/action}

Результат в Discordкнопки нажимаются

T

TesterСегодня

/кнопки

SilentBotБОТСегодня

🧪 Режимы кнопок

Нажмите каждую кнопку и сравните, куда приходит ответ.

✏️ edit 💬 reply 🙈 ephemeral 📖 Документация

Открыть в редакторе

Экраны и кнопка «Назад»

Если в блоке действия объявить свои кнопки, набор кнопок сменится. Так делаются меню с разделами. Пустой блок home возвращает основную панель.

Меню с разделами

title: 🏠 Главное меню
description: Выберите раздел.
color: #2ecc71
button: 🛒 Магазин | shop | primary | edit | only_author
button: ℹ️ О сервере | about | secondary | edit | only_author

{#action shop}
title: 🛒 Магазин
description: 🗡️ Меч — 100 💰\n🛡️ Щит — 80 💰
button: ⬅️ Назад | home | secondary | edit | only_author
{/action}

{#action about}
title: ℹ️ {guild.name}
description: Участников: **{guild.member_count}**
button: ⬅️ Назад | home | secondary | edit | only_author
{/action}

{#action home}
{/action}

Результат в Discordкнопки нажимаются

T

TesterСегодня

/меню

SilentBotБОТСегодня

🏠 Главное меню

Выберите раздел.

🛒 Магазин ℹ️ О сервере

Открыть в редакторе

Попробуйте сами Камень, ножницы, бумага

Три кнопки. Бот выбирает случайный вариант и пишет, кто победил.

title: ✊ Камень, ножницы, бумага
description: Ваш ход!
color: #9b59b6
button: 🪨 Камень | rock | secondary | edit | only_author
button: ✂️ Ножницы | scissors | secondary | edit | only_author
button: 📄 Бумага | paper | secondary | edit | only_author

{#action rock}
{set('bot', {choice('rock', 'scissors', 'paper')})}
description: Вы: 🪨 · Бот: {switch({get('bot')}, 'rock', '🪨', 'scissors', '✂️', '📄')}\n**{switch({get('bot')}, 'scissors', '🎉 Победа!', 'rock', '🤝 Ничья', '😢 Поражение')}**
{/action}

{#action scissors}
{set('bot', {choice('rock', 'scissors', 'paper')})}
description: Вы: ✂️ · Бот: {switch({get('bot')}, 'rock', '🪨', 'scissors', '✂️', '📄')}\n**{switch({get('bot')}, 'paper', '🎉 Победа!', 'scissors', '🤝 Ничья', '😢 Поражение')}**
{/action}

{#action paper}
{set('bot', {choice('rock', 'scissors', 'paper')})}
description: Вы: 📄 · Бот: {switch({get('bot')}, 'rock', '🪨', 'scissors', '✂️', '📄')}\n**{switch({get('bot')}, 'rock', '🎉 Победа!', 'paper', '🤝 Ничья', '😢 Поражение')}**
{/action}

Результат в Discordкнопки нажимаются

T

TesterСегодня

/кнб

SilentBotБОТСегодня

✊ Камень, ножницы, бумага

Ваш ход!

🪨 Камень ✂️ Ножницы 📄 Бумага

Открыть в редакторе

Если нужно, чтобы игрок что-то написал, нужна форма (модальное окно). Если нужно, чтобы он что-то выбрал из списка, — выпадающее меню.

Формы

button: Надпись | ключ | стиль | modal
modal: ключ | Заголовок формы | Поле*, Ещё поле, >Длинное поле | reply

• Кнопка в режиме modal и строка modal: должны иметь один и тот же ключ.
• До 5 полей. * в конце делает поле обязательным, > в начале — многострочным.
• Последняя часть говорит, куда придёт ответ: edit, reply или ephemeral.
• Ответы доступны в блоке действия как {modal_1}, {modal_2}… по порядку полей.

Предложка идей

title: 📝 Идеи для сервера
description: Последняя идея: {servervar_get('last_idea', 'пока нет')}
color: #9b59b6
button: 💡 Предложить | idea | primary | modal
modal: idea | Новая идея | Коротко*, >Подробнее | reply

{#action idea}
{set('text', {escape_md({clean_mentions({modal_1})})})}
{void(servervar_set('last_idea', {get('text')}))}
title: 💡 Идея от {user.display_name}
description: **{get('text')}**\n{escape_md({clean_mentions({modal_2})})}
color: #2ecc71
{/action}

Результат в Discordкнопки нажимаются

T

TesterСегодня

/идея

SilentBotБОТСегодня

📝 Идеи для сервера

Последняя идея: пока нет

💡 Предложить

Открыть в редакторе

Выпадающие меню

select: Подсказка | Вариант 1, Вариант 2, Вариант 3
select_action: Вариант 1 | что ответить на выбор

Меню выбора цвета

title: 🎨 Любимый цвет
description: Выберите вариант в меню ниже.
color: #e67e22
select: Выберите цвет | Красный, Синий, Зелёный
select_action: Красный | ❤️ Страсть и энергия!
select_action: Синий | 💙 Спокойствие и глубина.
select_action: Зелёный | 💚 Природа и гармония.

Результат в Discord

T

TesterСегодня

/цвет

SilentBotБОТСегодня

🎨 Любимый цвет

Выберите вариант в меню ниже.

Выберите цвет

КрасныйСинийЗелёный

Открыть в редакторе

Всё, что мы делали до этого, забывалось сразу после ответа. Память хранит данные между вызовами и нажатиями: монеты, уровни, инвентарь, время последнего бонуса. Именно она превращает команды в игры.

Что значит звёздочка и где лежит запись

Звёздочка — сокращение для семейства функций с одним началом: store_* — это store_get, store_set, store_inc и остальные. Все они работают с одним и тем же хранилищем.

Каждая запись в памяти — это значение с «адресом» из нескольких частей. Вы пишете в команде только ключ — имя записи, например 'coins'. Остальные части бот подставляет сам:

• Одинаковый ключ у разных игроков — разные записи. У Васи coins = 150, у Пети coins = 20, и они друг другу не мешают.
• На другом сервере — своя память. Та же команда на другом сервере начнёт с нуля.
• store_get читает только данные того, кто вызвал команду. Чужие записи видны через store_scan(…, 'all') и store_sort, а общие для всех данные удобнее хранить в servervar_* или таблице лидеров lb_*.
• Ключ не зависит от регистра (Coins и coins — одно и то же), до 64 символов. У одного игрока на сервере — до 300 ключей, значение — до 1200 символов.

Чтение и запись

Ежедневный бонус: память + время

Запоминаем, когда игрок брал бонус, и пускаем снова только через сутки. unix() — текущее время в секундах, 86400 — секунд в сутках.

Ежедневный бонус с кулдауном

{set('last', {store_get('daily_at', 0)})}
{#if {calc({unix()} - {get('last')})} < 86400}
title: ⏳ Рано!
description: Следующий бонус {discord_time({calc({get('last')} + 86400)}, 'R')}.\nБаланс: **{store_get('coins', 0)}** 💰
color: #e67e22
{#else}
{void(store_set('daily_at', {unix()}))}
{void(store_inc('coins', 100))}
title: 🎁 Ежедневный бонус
description: +100 💰 зачислено! Баланс: **{store_get('coins', 0)}** 💰
color: #2ecc71
{/if}

Результат в Discord

T

TesterСегодня

/бонус

SilentBotБОТСегодня

🎁 Ежедневный бонус

+100 💰 зачислено! Баланс: 100 💰

Открыть в редакторе

Стартовые значения

Второй аргумент store_get('hp', 100) только показывается, в память он не записывается. Если игроку нужно начать со 100 здоровья, запишите это один раз, при первом запуске. Проверить, что ключа ещё нет, помогает store_type.

Персонаж с начальными значениями

{#if {store_type('hp')} == ''}{void(store_set('hp', 60))}{void(store_set('coins', 50))}{/if}
title: 🧙 Персонаж {user.display_name}
description: ❤️ Здоровье: **{store_get('hp', 0)}**/100\n💰 Монеты: **{store_get('coins', 0)}**
color: #e74c3c
button: 🍖 Поесть (−10 💰, +20 ❤️) | eat | success | edit | only_author

{#action eat}
{#if {store_get('coins', 0)} < 10}
description: ❌ Не хватает монет.
{#elif {store_get('hp', 0)} >= 100}
description: 😋 Вы и так сыты.
{#else}
{void(store_dec('coins', 10))}
{void(store_set('hp', {min(100, {calc({store_get('hp', 0)} + 20)})}))}
{/if}
{/action}

Результат в Discordкнопки нажимаются

T

TesterСегодня

/старт

SilentBotБОТСегодня

🧙 Персонаж Tester

❤️ Здоровье: 60/100
💰 Монеты: 50

🍖 Поесть (−10 💰, +20 ❤️)

Открыть в редакторе

Запись с несколькими значениями

Одна запись хранит одно значение. Когда у объекта несколько свойств (у героя — уровень, здоровье и золото) или нужно хранить много однотипных вещей, есть два способа.

Первый способ в деле: три характеристики героя. Кнопка «Все записи героя» показывает их разом через store_scan('hero_') — он находит все ключи игрока, которые начинаются с hero_.

Герой с несколькими характеристиками

{#if {store_type('hero_lvl')} == ''}{void(store_set('hero_lvl', 1))}{void(store_set('hero_hp', 100))}{void(store_set('hero_gold', 25))}{/if}
title: 🧙 Герой {user.display_name}
color: #9b59b6
field: Уровень | {store_get('hero_lvl', 1)} | true
field: Здоровье | {store_get('hero_hp', 100)} ❤️ | true
field: Золото | {store_get('hero_gold', 0)} 🪙 | true
button: ⚔️ Тренировка (−20 ❤️, +1 ур.) | train | primary | edit | only_author
button: 📋 Все записи героя | all | secondary | ephemeral

{#action train}
{#if {store_get('hero_hp', 0)} < 20}
description: 😵 Слишком мало здоровья для тренировки.
{#else}
{void(store_dec('hero_hp', 20))}
{void(store_inc('hero_lvl'))}
{/if}
{/action}

{#action all}
{store_scan('hero_')}
{/action}

Результат в Discordкнопки нажимаются

T

TesterСегодня

/герой

SilentBotБОТСегодня

🧙 Герой Tester

Уровень

1

Здоровье

100 ❤️

Золото

25 🪙

⚔️ Тренировка (−20 ❤️, +1 ур.) 📋 Все записи героя

Открыть в редакторе

Общие данные сервера

Общий счётчик печенек

{void(servervar_set('cookies', {servervar_get('cookies', 0)} + 1))}
🍪 {user.mention} съел печеньку. Сервер съел уже **{servervar_get('cookies', 0)}**!

Результат в Discord

T

TesterСегодня

/печенька

SilentBotБОТСегодня

🍪 @Tester съел печеньку. Сервер съел уже 1!

Открыть в редакторе

Переменную сервера можно прочитать и короче: {servervar.cookies}. Во вкладке «Переменные» панели их видно и можно менять вручную.

На одном сервере — до 500 переменных, имя — до 64 символов, значение — до 1200 символов. Менять существующие переменные можно без ограничений. Если лимит заполнен, новая переменная не сохранится, servervar_set ничего не выведет, а эмулятор покажет предупреждение. Все лимиты собраны в справочнике.

Данные игроков в панели

Вкладка «Данные игроков» в панели сервера показывает всё, что команды запомнили: поиск по ключу и ID игрока, правка значения (тип сохраняется: число останется числом), удаление у одного игрока или сразу у всех. Там же таблицы лидеров с кнопкой «Закрыть сезон» (как lb_reset) и экспорт всего в JSON-файл.

Иногда одного значения мало: инвентарь, полка с книгами, коллекция значков. Для этого есть списки и наборы, а чтобы вывести их по пунктам — циклы. В этом уроке — как список создать, прочитать, изменить, проверить и сохранить.

Где живёт список

Внутри список хранится как JSON-строка: ["📕 Дюна", "📗 Хоббит"]. Номера элементов начинаются с нуля: первый элемент — № 0, второй — № 1, а −1 означает последний.

Создать и добавить

Прочитать

Чтобы вывести все элементы по пунктам, используйте цикл {#for книга in {store_get('shelf', '[]')}}…{/for}: внутри {книга} — элемент, {index} — его номер с единицы. Если нужна одна строка, есть функция for(список, 'шаблон', 'разделитель').

Все способы прочитать список

{#if {store_type('shelf')} == ''}{void(store_set('shelf', list_create('📕 Дюна', '📗 Хоббит', '📘 Солярис', '📙 Пикник')))}{/if}
Весь список (так он хранится): `{store_get('shelf', '[]')}`
Сколько книг: **{list_len('shelf')}**
Первая: **{list_get('shelf', 0)}** · последняя: **{list_get('shelf', -1)}**
Первые две: {list_slice('shelf', 0, 2, ', ')}
Случайная: {list_random('shelf')}
По порядку:
{#for book in {store_get('shelf', '[]')}}{index}. {book}
{/for}

Результат в Discord

T

TesterСегодня

/полка

SilentBotБОТСегодня

Весь список (так он хранится): ["📕 Дюна", "📗 Хоббит", "📘 Солярис", "📙 Пикник"]
Сколько книг: 4
Первая: 📕 Дюна · последняя: 📙 Пикник
Первые две: 📕 Дюна, 📗 Хоббит
Случайная: 📕 Дюна
По порядку:
1. 📕 Дюна
2. 📗 Хоббит
3. 📘 Солярис
4. 📙 Пикник

Открыть в редакторе

Изменить

list_sort и похожие функции возвращают новый список и ничего не сохраняют. Чтобы изменение осталось, запишите результат обратно через store_set.

Пример ниже собирает всё вместе. «Выпить зелье» убирает одно зелье из двух, «Улучшить меч» находит номер меча и заменяет его, «Сортировать» сохраняет отсортированный список. Флаг pack_ready нужен, чтобы стартовый набор выдавался один раз: без него после «Выбросить всё» пустой рюкзак снова выглядел бы как первый запуск.

Рюкзак: убрать, заменить, отсортировать

{#if {store_type('pack_ready')} == ''}{void(store_set('pack', list_create('🧪 Зелье', '🗡️ Меч', '🧪 Зелье', '🍞 Хлеб')))}{void(store_set('pack_ready', 1))}{/if}
title: 🎒 Рюкзак ({list_len('pack')}/8)
description: {#if {list_len('pack')} == 0}Пусто{#else}{for({store_get('pack', '[]')}, '{index}. {item}', '\n')}{/if}
color: #16a085
button: 🧪 Выпить зелье | use | success | edit | only_author
button: ✨ Улучшить меч | upgrade | primary | edit | only_author
button: 🔤 Сортировать | sort | secondary | edit | only_author
button: 🗑️ Выбросить всё | clear | danger | edit | only_author

{#action use}
{#if {list_contains('pack', '🧪 Зелье')} == true}
{void(list_remove('pack', '🧪 Зелье'))}
🧪 Вы выпили одно зелье
{#else}
❌ Зелий не осталось
{/if}
{/action}

{#action upgrade}
{set('pos', {list_index('pack', '🗡️ Меч')})}
{#if {get('pos')} >= 0}
{void(list_set('pack', {get('pos')}, '⚔️ Меч +1'))}
✨ Меч улучшен
{#else}
❌ Обычного меча нет
{/if}
{/action}

{#action sort}
{void(store_set('pack', list_sort('pack')))}
{/action}

{#action clear}
{void(store_del('pack'))}
{/action}

Результат в Discordкнопки нажимаются

T

TesterСегодня

/рюкзак

SilentBotБОТСегодня

🎒 Рюкзак (4/8)

1. 🧪 Зелье
2. 🗡️ Меч
3. 🧪 Зелье
4. 🍞 Хлеб

🧪 Выпить зелье ✨ Улучшить меч 🔤 Сортировать 🗑️ Выбросить всё

Открыть в редакторе

Проверить

Дверь, которую открывает ключ из списка

{#if {store_type('keys')} == ''}{void(store_set('keys', list_create('🗝️ Медный', '🗝️ Медный', '🔑 Серебряный')))}{/if}
В кармане: {list_slice('keys', 0, 10, ', ')}
{#if {list_contains('keys', '🔑 Серебряный')} == true}🚪 Серебряная дверь открыта! Ключ лежит на месте №{calc({list_index('keys', '🔑 Серебряный')} + 1)}.{#else}🔒 Нужен серебряный ключ.{/if}
Медных ключей: **{list_count('keys', '🗝️ Медный')}**{#if {list_count('keys', '🗝️ Медный')} >= 2} — хватит на сундук{/if}

Результат в Discord

T

TesterСегодня

/дверь

SilentBotБОТСегодня

В кармане: 🗝️ Медный, 🗝️ Медный, 🔑 Серебряный
🚪 Серебряная дверь открыта! Ключ лежит на месте №3.
Медных ключей: 2 — хватит на сундук

Открыть в редакторе

Цикл {#for} по числам

Цикл умеет проходить не только по списку, но и по числам. range(1, 6) — это числа от 1 до 5 (последнее не включается).

Таблица умножения

Таблица умножения на {args.1}:
{#for i in {range(1, 6)}}{args.1} × {i} = **{{args.1} * {i}}**
{/for}

Результат в Discord

T

TesterСегодня

/таблица 7

SilentBotБОТСегодня

Таблица умножения на 7:
7 × 1 = 7
7 × 2 = 14
7 × 3 = 21
7 × 4 = 28
7 × 5 = 35

Открыть в редакторе

Список в одну строку

{for({list_create('🍎 Яблоко', '🍌 Банан', '🍇 Виноград')}, '{index}. {item}', '\n')}

Результат в Discord

T

TesterСегодня

/список

SilentBotБОТСегодня

1. 🍎 Яблоко
2. 🍌 Банан
3. 🍇 Виноград

Открыть в редакторе

Ещё один пример: сумка с лутом

Сумка с лутом

title: 🎒 Сумка ({list_len('bag')}/10)
description: {#if {list_len('bag')} == 0}Пусто{#else}{for({store_get('bag', '[]')}, '{index}. {item}', '\n')}{/if}
color: #1abc9c
button: 🎁 Открыть сундук | loot | primary | edit | only_author
button: 🗑️ Выбросить последний | drop | danger | edit | only_author

{#action loot}
{#if {list_len('bag')} >= 10}
description: ❌ Сумка полна!
{#else}
{void(list_push('bag', {random(['🗡️ Меч', '🛡️ Щит', '🧪 Зелье'], [30, 30, 40])}))}
{/if}
{/action}

{#action drop}
{void(list_pop('bag'))}
{/action}

Результат в Discordкнопки нажимаются

T

TesterСегодня

/сумка

SilentBotБОТСегодня

🎒 Сумка (0/10)

Пусто

🎁 Открыть сундук 🗑️ Выбросить последний

Открыть в редакторе

Наборы: без повторов

Набор (set_*) похож на список, но один и тот же элемент в нём хранится только раз. Он подходит для значков, открытых локаций и полученных достижений: повторное добавление ничего не меняет.

Коллекция значков

{void(set_add('badges', '🌟 Новичок'))}{void(set_add('badges', '🎣 Рыбак'))}{void(set_add('badges', '🌟 Новичок'))}
Значков: **{set_size('badges')}**: {set_values('badges', ' · ')}
Есть «Рыбак»? {if({set_has('badges', '🎣 Рыбак')} == true, 'да ✅', 'нет')}

Результат в Discord

T

TesterСегодня

/значки

SilentBotБОТСегодня

Значков: 2: 🌟 Новичок · 🎣 Рыбак
Есть «Рыбак»? да ✅

Открыть в редакторе

Цикл повторяет кусок шаблона несколько раз: для каждого предмета в сумке, для чисел от 1 до 10 или пока выполняется условие. Есть два цикла: {#for} идёт по списку, а {#while} повторяет, пока условие верно.

Цикл for: по каждому элементу

После for пишется имя для текущего элемента, затем in и список: {#for вещь in {get('bag')}}. Внутри цикла {вещь} — очередной элемент, {index} — его номер. Если имя не указать ({#for {список}}), элемент доступен как {item}.

Содержимое сумки

{set('bag', {list_create('🗡️ Меч', '🛡️ Щит', '🏹 Лук')})}
title: 🎒 Твоя сумка
description: {#for вещь in {get('bag')}}{index}. {вещь}\n{/for}
color: #8b5cf6

Результат в Discord

T

TesterСегодня

/сумка

SilentBotБОТСегодня

🎒 Твоя сумка

1. 🗡️ Меч
2. 🛡️ Щит
3. 🏹 Лук

Открыть в редакторе

Список можно взять откуда угодно: list_create(…), store_get('bag', '[]'), split({args}, ','), file_list('#канал') или прямо написать [1, 2, 3].

Повторить N раз: range

Чтобы повторить действие несколько раз, пройдите по числам: range(1, 6) даёт 1, 2, 3, 4, 5 (последнее число не входит). range(5) — от 0 до 4, range(10, 0, -2) — 10, 8, 6, 4, 2.

Таблица умножения

Таблица умножения на {args.1}:
{#for i in {range(1, 6)}}{args.1} × {i} = **{{args.1} * {i}}**
{/for}

Результат в Discord

T

TesterСегодня

/таблица 7

SilentBotБОТСегодня

Таблица умножения на 7:
7 × 1 = 7
7 × 2 = 14
7 × 3 = 21
7 × 4 = 28
7 × 5 = 35

Открыть в редакторе

Счётчики и суммы внутри цикла

Переменные, записанные через {set} внутри цикла, сохраняются и после него. Так удобно считать сумму, количество или собирать текст по кусочкам. А имя элемента (цена в примере ниже) и index после цикла возвращают прежние значения.

Чек с суммой

{set('prices', {list_create(120, 45, 300, 80)})}
{set('total', 0)}
{set('lines', '')}
{#for цена in {get('prices')}}{set('total', {math({get('total')} + {цена})})}{set('lines', {get('lines')} + 'Товар ' + {index} + ': ' + {цена} + ' 🪙\n')}{/for}
title: 🧾 Чек
description: {get('lines')}**Итого: {get('total')} 🪙**
color: #22c55e

Результат в Discord

T

TesterСегодня

/чек

SilentBotБОТСегодня

🧾 Чек

Товар 1: 120 🪙
Товар 2: 45 🪙
Товар 3: 300 🪙
Товар 4: 80 🪙
Итого: 545 🪙

Открыть в редакторе

Цикл while: пока условие верно

{#while условие} проверяет условие перед каждым шагом. Если оно верно — выполняет тело и проверяет снова, если нет — цикл заканчивается. Условие пишется так же, как в {#if}: можно сравнивать, использовать and, or, not.

Сколько раз делится пополам

{set('n', {default({args.1}, 100)})}
{set('steps', 0)}
{#while {get('n')} >= 2}
{set('n', {math({get('n')} // 2)})}
{set('steps', {math({get('steps')} + 1)})}
{/while}
Число {args.1} можно разделить пополам **{get('steps')}** раз, пока не останется меньше 2.

Результат в Discord

T

TesterСегодня

/пополам 100

SilentBotБОТСегодня

Число 100 можно разделить пополам 6 раз, пока не останется меньше 2.

Открыть в редакторе

break и continue

{break} сразу выходит из цикла: оставшиеся шаги не выполняются. {continue} пропускает остаток текущего шага и переходит к следующему (у while — к новой проверке условия). Обычно их ставят внутрь {#if}:

Поиск с пропуском чётных

{set('found', '')}
{#for n in {range(1, 20)}}{#if {math({n} % 2)} == 0}{continue}{/if}{#if {math({n} * {n})} > {math({args.1} * 10)}}{set('found', {n})}{break}{/if}Проверил {n}: {math({n} * {n})} — мало
{/for}
Первое нечётное число, квадрат которого больше {math({args.1} * 10)}: **{get('found')}**

Результат в Discord

T

TesterСегодня

/найти 3

SilentBotБОТСегодня

Проверил 1: 1 — мало
Проверил 3: 9 — мало
Проверил 5: 25 — мало

Первое нечётное число, квадрат которого больше 30: 7

Открыть в редакторе

Оба действуют на ближайший цикл, в котором стоят: break во внутреннем цикле не прерывает внешний. Вне цикла они ничего не делают, редактор подсветит это предупреждением.

Цикл в цикле

Циклы можно вкладывать друг в друга — например, чтобы пройти по строкам и столбцам таблицы. Внешний цикл делает шаг, и на каждом его шаге внутренний проходит целиком.

Таблица 3 × 3

{#for a in {range(1, 4)}}{#for b in {range(1, 4)}}{a}×{b}={math({a} * {b})}   {/for}
{/for}

Результат в Discord

T

TesterСегодня

/таблица

SilentBotБОТСегодня

1×1=1 1×2=2 1×3=3
2×1=2 2×2=4 2×3=6
3×1=3 3×2=6 3×3=9

Открыть в редакторе

Ограничения

Циклы выполняются на сервере бота, поэтому у них есть пределы: одна неудачная команда не должна тормозить бота на всех серверах.

Когда предел достигнут, цикл просто останавливается, а команда продолжает работу. Эмулятор в редакторе покажет, какой предел сработал, а редактор заранее подсветит слишком глубокую вложенность.

Таблица лидеров — общий рейтинг сервера по любым очкам: кликам, пойманной рыбе, победам. У каждой таблицы есть имя, и в команде их может быть сколько угодно.

Кликер-турнир

title: 🏆 Кликер-турнир
description: {default({lb_top('clicker', 5)}, 'Пока никто не играл — стань первым!')}
color: #f1c40f
button: 👆 +1 очко | tap | success | edit
button: 📊 Моё место | me | secondary | ephemeral

{#action tap}
{void(lb_add('clicker', 1))}
{/action}

{#action me}
Ваш счёт: **{lb_get('clicker', '', 0)}**, место: **#{lb_rank('clicker')}**
{/action}

Результат в Discordкнопки нажимаются

T

TesterСегодня

/турнир

SilentBotБОТСегодня

🏆 Кликер-турнир

Пока никто не играл — стань первым!

👆 +1 очко 📊 Моё место

Открыть в редакторе

Кнопка «Моё место» работает в режиме ephemeral: личный результат видит только нажавший, а общая карточка остаётся нетронутой.

Голосование, дуэль, общий босс, игра на двоих: панелью пользуется несколько человек сразу. Для этого есть две вещи: данные панели, свои у каждого отправленного сообщения, и кнопки для конкретного игрока.

Данные панели

store_* хранит данные игрока, servervar_* — данные всего сервера. msg_* хранит данные одной панели: если открыть два голосования одной командой, у каждого будет свой счёт.

Голосование: у каждой панели свой счёт, один голос на человека

title: 📊 {default({args}, 'Голосование')}
description: 👍 За: **{msg_get('yes', 0)}**  ·  👎 Против: **{msg_get('no', 0)}**\nГолосов: {calc({msg_get('yes', 0)} + {msg_get('no', 0)})}
color: #5865F2
button: 👍 За | yes | success
button: 👎 Против | no | danger

{#action yes}
{#if {contains({msg_get('voters')}, {user.id})} == true}
Вы уже голосовали.
{#else}
{void(msg_set('voters', {msg_get('voters')},{user.id}))}{void(msg_inc('yes'))}
{/if}
{/action}

{#action no}
{#if {contains({msg_get('voters')}, {user.id})} == true}
Вы уже голосовали.
{#else}
{void(msg_set('voters', {msg_get('voters')},{user.id}))}{void(msg_inc('no'))}
{/if}
{/action}

Результат в Discordкнопки нажимаются

T

TesterСегодня

/опрос Пицца или суши?

SilentBotБОТСегодня

📊 Пицца или суши?

👍 За: 0 · 👎 Против: 0
Голосов: 0

👍 За 👎 Против

Открыть в редакторе

При первом запуске панель ещё не отправлена, поэтому msg_set в основной панели запоминает значения и сохраняет их за сообщением сразу после отправки. У панели до 50 ключей, данные живут 30 дней.

Кнопка для одного игрока

button: Принять | accept | success | edit | only={args.1}

only= — упоминание или ID участника: остальным кнопка ответит «Эта кнопка только для …». Если игрок не указан (only= пустое), кнопку не нажмёт никто. А only_author по-прежнему оставляет кнопку тому, кто открыл панель.

В действиях кнопок {user} — тот, кто нажал, а {owner} и {owner_id} — тот, кто открыл панель.

Дуэль: принять вызов может только тот, кого вызвали

title: ⚔️ Дуэль
description: {owner} вызывает {args.1}!\n{#if {msg_get('win')} == ''}Ждём, примет ли вызов…{#else}🎲 {owner} — **{msg_get('a')}**, {args.1} — **{msg_get('b')}**. Победа: {msg_get('win')}{/if}
color: #e74c3c
button: ✅ Принять вызов | accept | success | edit | only={args.1} | disabled={#if {msg_get('win')} == ''}false{#else}true{/if}

{#action accept}
{void(msg_set('a', {random(1, 6)}))}{void(msg_set('b', {random(1, 6)}))}
{#if {msg_get('a')} > {msg_get('b')}}{void(msg_set('win', {owner}))}{#else}{#if {msg_get('a')} < {msg_get('b')}}{void(msg_set('win', {args.1}))}{#else}{void(msg_set('win', 'ничья'))}{/if}{/if}
{/action}

Результат в Discordкнопки нажимаются

T

TesterСегодня

/дуэль @friend

SilentBotБОТСегодня

⚔️ Дуэль

@Tester вызывает @Friend!
Ждём, примет ли вызов…

✅ Принять вызов

Открыть в редакторе

Команды могут работать с тем же, что и встроенные модули бота: монетами из /баланс, уровнями из /ранг и кланами из /клан. Магазин, где покупают за настоящие монеты, или квест, который даёт опыт, — пара строк.

Все функции принимают игрока последним аргументом: eco_balance('total', {args.1}), level('rank', @игрок). Без него — тот, кто вызвал команду.

Профиль игрока

Монеты, уровень и клан в одной карточке

title: 🪪 {user.display_name}
thumbnail: {user.avatar}
color: #D4A017
field: 💰 Кошелёк | {format_number({eco_balance()})} | true
field: 🏦 Всего | {format_number({eco_balance('total')})} | true
field: ⭐ Уровень | {level()} ({level('xp')}/{level('need')} XP), место #{level('rank')} | false
field: 🛡️ Клан | {default({clan_name()}, 'без клана')} | false

Результат в Discord

T

TesterСегодня

/профиль

SilentBotБОТСегодня

🪪 Tester

💰 Кошелёк

500

🏦 Всего

500

⭐ Уровень

1 (0/100 XP), место #1

🛡️ Клан

без клана

Открыть в редакторе

Магазин за монеты бота

eco_take сначала проверяет, хватает ли денег, и только тогда списывает — купить «в минус» нельзя, даже если два игрока жмут кнопку одновременно. Забрать монеты у другого игрока (eco_take(100, @кто)) можно, только если он участник этого сервера, и не больше 10 000 в день с одного игрока: кошелёк общий для всего бота, и команды чужого сервера не должны его опустошать.

Покупка опыта за монеты

title: 🛒 Лавка
description: Зелье опыта — **100** монет, даёт **+100 XP**.\nУ вас: **{eco_balance()}** монет.
color: #2ecc71
button: 🧪 Купить зелье | buy | success | ephemeral

{#action buy}
{#if {eco_take(100)} == true}
{set('lvl', {xp_add(100)})}
Куплено! Теперь у вас **{eco_balance()}** монет и **{get('lvl')}** уровень.
{#else}
Не хватает монет: нужно 100, у вас {eco_balance()}.
{/if}
{/action}

Результат в Discordкнопки нажимаются

T

TesterСегодня

/лавка

SilentBotБОТСегодня

🛒 Лавка

Зелье опыта — 100 монет, даёт +100 XP.
У вас: 500 монет.

🧪 Купить зелье

Открыть в редакторе

Перевод другому игроку

Подарок монетами

{#if {eco_pay({args.1}, {args.2})} == true}
🎁 {user.mention} подарил {args.1} **{args.2}** монет!
{#else}
Не получилось: проверьте сумму и хватает ли монет.
{/if}

Результат в Discord

T

TesterСегодня

/подарить @friend 25

SilentBotБОТСегодня

🎁 @Tester подарил @Friend 25 монет!

Открыть в редакторе

Бот считает время в UTC. Для таймеров и кулдаунов удобнее всего UNIX-время: число секунд с 1970 года. Его легко складывать, вычитать и хранить в памяти.

Сдвиги записываются как +30m, -2h, +1d, +1w.

Все способы показать время

Сейчас: {now()}
Через час: {discord_time({unix('+1h')}, 'R')}
Дата по Москве: {date('%d.%m.%Y %H:%M', '+3h')}
Сегодня: {day_of_week()}
Неделю назад это было: {time_ago({unix('-7d')})}

Результат в Discord

T

TesterСегодня

/время

SilentBotБОТСегодня

Сейчас: 28 сентября 2026 г. 13:32
Через час: 4 ч. назад
Дата по Москве: 28.09.2026 16:32
Сегодня: Понедельник
Неделю назад это было: 7 дн. назад

Открыть в редакторе

Кулдаун своими руками

Схема всегда одна и та же. Запоминаем unix() в момент действия, а в следующий раз сравниваем разницу с нужной паузой. Готовый пример с ежедневным бонусом — в уроке про память, энергия, которая восстанавливается со временем, — в проекте «Шахта».

Команда может не только отвечать, но и действовать: выдавать роли, писать в другие каналы и в личку, ставить реакции, менять ник. Действия выполняются после того, как ответ собран, и сами ничего не выводят.

Выбор ролей кнопками

title: 🎭 Выбери роли
description: Нажми кнопку, чтобы получить роль или снять её.
color: #5865F2
button: 🎮 Геймер | gamer | primary | ephemeral
button: 🎨 Художник | artist | secondary | ephemeral

{#action gamer}
{role_toggle('Геймер')}
{#if {has_role('Геймер')} == true}Роль «Геймер» снята.{#else}Роль «Геймер» выдана!{/if}
{/action}

{#action artist}
{role_toggle('Художник')}
{#if {has_role('Художник')} == true}Роль «Художник» снята.{#else}Роль «Художник» выдана!{/if}
{/action}

Результат в Discordкнопки нажимаются

T

TesterСегодня

/роли

SilentBotБОТСегодня

🎭 Выбери роли

Нажми кнопку, чтобы получить роль или снять её.

🎮 Геймер 🎨 Художник

Открыть в редакторе

Обратите внимание: has_role в примере проверяется до того, как действие выполнится, поэтому показывает прошлое состояние. Отсюда и «снята» в первой ветке.

Жалоба в канал модераторов

{#if {args.count} < 2}
Напиши так: `!жалоба @участник причина`
{#else}
{send_to('#модерация', '🚨 Жалоба от ' + {user.mention} + ' на ' + {args.1} + ': ' + {clean_mentions({args.2+})})}
{react('✅')}
Спасибо! Жалоба отправлена модераторам.
{/if}

Результат в Discord

T

TesterСегодня

/жалоба @friend спамит в чате

SilentBotБОТСегодня

Спасибо! Жалоба отправлена модераторам.

Открыть в редакторе

Команда может вести файлы прямо в каналах сервера: заметки, журналы, таблицы результатов. Бот выкладывает файл сообщением с вложением, а при каждой записи обновляет это сообщение. Файл можно скачать и открыть в блокноте или Excel.