Как устроены РП-команды чата
Команда -рп и всё вокруг неё - список действий, свои команды под группу, возрастная категория и игнор-лист.
РП-команды - это короткие ролевые действия. Участник пишет обнять ответом на сообщение, и бот отвечает строкой о том, как один обнял другого. Встроенный набор работает во всех чатах бота сразу, а вы решаете, до какой возрастной категории он здесь открыт, добавляете свои действия под свою группу и закрываете доступ тем, кто перегибает.
Всё управление собрано в одной команде с указанием действия.
-рпРП-команды чата: список, свои действия, возрастная категория и игнор-лист
-rp/рп/rp<параметр> — обязательный[параметр] — необязательныйБез действия бот пришлёт памятку с кнопками. И в памятке, и на кнопках останется только то, на что у вас есть права: список команд видит любой участник, остальное открывается по правам.

| Действие | Что делает |
|---|---|
| Все РП-команды чата и встроенные, доступно всем участникам. Подробнее | |
| Создаёт РП-команду чата. Подробнее | |
| <команда> | Убирает РП-команду чата. Подробнее |
| [категория] | Возрастная категория встроенных действий. Подробнее |
| <участник> | Закрывает участнику РП-команды. Подробнее |
| <участник> | Возвращает доступ. Подробнее |
| Кто сейчас в игноре. Подробнее |
Слово действия можно писать так, как привычнее: у каждого есть русские и английские замены, они собраны в подсказке рядом с названием.
-рп списокПоказывает РП-команды чата и встроенные с фильтрами по источнику
-рп лист-рп команды-рп list
Список открыт всем участникам, права для него не нужны, поэтому подробное описание с кнопками и фильтрами живёт в разделе для участников.
Встроенные показываются с оглядкой на возрастную категорию: то, что старше выбранной, в список не попадает. На команды чата категория не влияет, они видны всегда. Полный каталог встроенных действий с примерами текста собран на странице для участников.
Персональных команд участников здесь нет: их видит только автор через -мрп список.
Откуда в чате берутся действия
Источников три, и управляются они по-разному:
- Встроенные: общий набор бота, одинаковый во всех чатах. Переписать или удалить их нельзя, зато можно ограничить возрастной категорией.
- Команды чата: то, что вы создаёте сами под свою группу, они работают у всех её участников.
- Персональные: участник придумывает их себе, и вызвать может только он. Вы в них не вмешиваетесь, но можете отключить их вместе с командами чата.
Названия не пересекаются, так что занять слово, которое уже используется встроенной командой или командой чата, не получится.
Кому что доступно
Список команд открыт всем участникам группы, отдельного права на него нет. Список игнора открывают модераторы и выше. Создание и удаление команд чата, игнор и разигнор - старшие модераторы и выше. Возрастная категория - администраторы и выше. У игнора проверяется иерархия, закрыть РП-команды тому, кто равен вам по роли или выше, не выйдет.
Права раздаются точечно, так что можно разрешить модератору только игнор, не открывая ему остальное, об этом в доступе и правах.