# Astral Moderation

> Шаблоны сообщений и пользовательские команды Telegram-бота Astral Moderation.

Научите бота отвечать так, как нужно вашему чату — от приветствия до команд с кнопками, формами и данными Brawl Stars. Программировать уметь не нужно.

## Table of Contents

### Введение

- [Шаблоны сообщений](/templates.md): Что такое шаблоны сообщений Astral Moderation, где они используются и с чего начать их изучение.
- [Редактор шаблона](/templates/editor.md): Как устроен редактор шаблонов в панели Astral Moderation — режимы, синтаксис, панель инструментов, превью, справочник и горячие клавиши.
- [Где используются шаблоны](/templates/places.md): Все места панели, где используются шаблоны сообщений, и какие переменные доступны в каждом из них.

### Новичкам

- [Первые шаги](/templates/beginners.md): Шаблоны сообщений для тех, кто никогда не программировал. Первое приветствие за пять минут.
- [Простые переменные](/templates/beginners/variables.md): Самые нужные переменные шаблонов — участник, уровень, чат, бот, топик, сообщение и дата — с примерами результата.
- [Оформление текста](/templates/beginners/formatting.md): Как оформить сообщение бота — жирный, курсив, заголовки, списки, таблицы, цитаты, спойлеры, ссылки и картинки.
- [Условия «если… то…»](/templates/beginners/conditions.md): Как показывать разный текст разным участникам с помощью условий if, elseif и else — объяснение для новичков.
- [Кнопки под сообщением](/templates/beginners/buttons.md): Как добавить под сообщение бота кнопку-ссылку, кнопку «Скопировать» и расположить кнопки в несколько рядов.
- [Частые ошибки](/templates/beginners/mistakes.md): Самые частые ошибки в шаблонах и как их исправить — незакрытые теги, кавычки, скобки, приоритет операторов.

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

- [Пользовательские команды](/commands.md): Пользовательские команды Astral Moderation — свои команды для Telegram-чата с ответами, кнопками, формами, ролями и хранением данных.
- [Первая команда за 5 минут](/commands/first-command.md): Пошаговая инструкция — создаем пользовательскую команду «!кубик», проверяем ее и добавляем аргументы и кнопку.
- [Настройки команды](/commands/settings.md): Все настройки пользовательской команды — имя, алиасы, slash, описание, группа, права доступа, кулдаун, режим ответа и наследование от модуля.
- [Действия](/commands/actions.md): Действия пользовательских команд — типы, общие настройки, UUID, параметры и запуск одного действия из другого.
- [Аргументы команды](/commands/arguments.md): Как читать аргументы пользовательской команды — слова после команды, упомянутого участника, срок и причину.
- [Кнопки и меню выбора](/commands/components.md): Кнопки и меню выбора в пользовательских командах — стили, действия, component.id, листание страниц, select_menu, кнопки внутри текста.
- [Цепочки действий](/commands/run.md): Тег run — запуск одного действия пользовательской команды из другого, передача параметров, 'self' и ограничения цепочек.
- [Тест и диагностика](/commands/testing.md): Как проверить пользовательскую команду — превью, тестовый запуск в ЛС, вкладка «Диагностика», статусы и ошибки.

#### Действия

- [Отправка сообщения](/commands/actions/message.md): Действие «Отправка сообщения» — шаблон, медиа, кнопки, опрос, куда отправлять, замена сообщения кнопкой, авто-удаление.
- [Форма](/commands/actions/form.md): Действие «Форма» — пошаговые вопросы участнику в Telegram и передача ответов в следующее действие через form.values.
- [Изменение ролей](/commands/actions/change-roles.md): Действие «Изменение ролей» — выдача и снятие ролей бота вызвавшему или упомянутому участнику, в том числе по кнопке.
- [Встроенная команда](/commands/actions/internal.md): Действие «Встроенная команда» — вызов встроенной команды бота (mute, warn, ban, rank…) из пользовательской команды с готовыми аргументами.
- [Выполнение кода](/commands/actions/code.md): Действие «Выполнение кода» — выполнить шаблон без обычного ответа, сохранить данные или выбрать следующее действие через run.

### Продвинутым

- [Расширенное руководство](/templates/advanced.md): Расширенное руководство по шаблонному движку Astral Moderation — синтаксис, выражения, типы, теги, функции, разметка, квоты и ошибки.
- [Островки кода](/templates/advanced/syntax.md): Синтаксис шаблонного движка — островки вывода, тегов и комментариев, контроль пробелов, идентификаторы, литералы и ключевые слова.
- [Выражения и операторы](/templates/advanced/expressions.md): Операторы и выражения шаблонного движка — арифметика, сравнения, логика, конкатенация, pipe, Элвис, тернарный оператор, тесты is и таблица приоритетов.
- [Типы и конвертация](/templates/advanced/types.md): Типы данных шаблонного движка, автоматическая конвертация, истинность значений, Undefined, строгий режим и то, как значения выводятся в сообщение.
- [Теги](/templates/advanced/tags.md): Все теги шаблонного движка — set, global, do, if, for, break, continue, transform, macro, include, filter, verbatim, require, return, use, run.
- [Функции](/templates/advanced/functions.md): Все функции шаблонного движка Astral Moderation — логические, математика, строки, списки, дата и время, кнопки, разметка и медиа — с примерами.
- [Rich-сообщения и разметка](/templates/advanced/rich.md): Rich-сообщения Telegram в шаблонах — режимы Rich и Text, синтаксис Markdown и HTML, полный каталог строчной и блочной разметки, медиа, экранирование и лимиты.
- [Квоты и ограничения](/templates/advanced/limits.md): Квоты выполнения шаблонов — шаги, время, циклы, хранилища, astral, отправки, роли, кнопки и размер сообщений.
- [Ошибки](/templates/advanced/errors.md): Все коды ошибок и предупреждений шаблонного движка Astral Moderation — что означают и как исправить.

### Хранение данных

- [Атрибуты](/templates/storage/attributes.md): Атрибуты участников и чата — как хранить балансы, счетчики и анкеты между вызовами команд.
- [Индексы чата](/templates/storage/indexes.md): Индексы чата — отсортированные таблицы «ключ → число» для топов, рейтингов и экономики, с постраничным выводом.
- [Параметры](/templates/storage/parameters.md): Параметры действий — как передавать данные от команды к кнопкам ее сообщения и между действиями цепочки run.
- [Общие шаблоны](/templates/shared.md): Общие шаблоны — переиспользуемые куски шаблонов и библиотеки макросов, которые подключаются через include.

### Данные Astral

- [Пространство astral](/templates/astral.md): Пространство astral в шаблонах — клубы семьи Astral, профили игроков Brawl Stars, рейтинги, статистика и проверка по черному списку.

### Прочее

- [Полезные примеры](/templates/examples.md): Готовые шаблоны и пользовательские команды — приветствие, кубик, магический шар, экономика, топ с листанием, выбор роли, профиль, проверка по ЧС.
- [Словарик](/glossary.md): Словарик терминов документации Astral Moderation — простыми словами для тех, кто не программирует.

### Справочник типов

- [Chat](/reference/chat.md): Тип Chat — текущий Telegram-чат в шаблонах Astral Moderation. Свойства и методы.
- [Member](/reference/member.md): Тип Member — участник Telegram-чата в шаблонах Astral Moderation. Свойства, роли, права, атрибуты и данные Astral.
- [Rank](/reference/rank.md): Тип Rank — уровень, опыт и место участника в рейтинге чата.
- [BotRole](/reference/bot-role.md): Тип BotRole — роль бота в шаблонах Astral Moderation.
- [Topic](/reference/topic.md): Тип Topic — топик форума Telegram в шаблонах Astral Moderation.
- [Message](/reference/message.md): Тип Message — сообщение Telegram в шаблонах Astral Moderation. Текст, автор, упоминания, вложения, ответ.
- [Attachment](/reference/attachment.md): Тип Attachment — вложение сообщения Telegram (фото, видео, файл, стикер) в шаблонах Astral Moderation.
- [Arguments](/reference/arguments.md): Тип Arguments — аргументы вызова пользовательской команды. Свойства и методы get, after, before, range, targetMember, duration, reason.
- [Parameters](/reference/parameters.md): Тип Parameters — параметры действий пользовательских команд, которые передаются кнопкам и следующим действиям.
- [Component](/reference/component.md): Тип Component — нажатая кнопка или выбранный пункт меню в действиях пользовательских команд.
- [Form](/reference/form.md): Тип Form — ответы на вопросы формы пользовательской команды.
- [Event](/reference/event.md): Тип Event — данные события (вступление, капча, наказание, лог) в шаблонах модулей Astral Moderation.
- [DateTime](/reference/datetime.md): Тип DateTime — дата и время в шаблонах Astral Moderation. Свойства и методы для вычислений с датами.
- [List, Map, Range](/reference/collections.md): Списки, диапазоны и карты в шаблонах Astral Moderation — методы добавления, удаления и поиска.
- [MemberAttribute](/reference/member-attribute.md): Тип MemberAttribute — значение, которое бот хранит для участника или чата. Свойства и методы update, increment, decrement, clear.
- [ChatIndex и Page](/reference/chat-index.md): Типы ChatIndex, ChatIndexEntry и Page — индексы чата для топов и рейтингов с постраничным выводом.
- [MessageBuilder](/reference/message-builder.md): MessageBuilder — сборка rich-сообщения из блоков через createMessage().
- [MenuBuilder](/reference/menu-builder.md): MenuBuilder — меню выбора в пользовательских командах Telegram, собранное из кнопок-вариантов.