С чего начинается Маяри
Большое тёплое вступление — что такое Маяри, зачем она нужна и как тут всё устроено
Привет 👋 Если ты это читаешь, значит, либо Маяри уже живёт на твоём сервере, либо ты присматриваешься. В обоих случаях — добро пожаловать. Налей чаю, тут будет уютно.
Маяри — это Discord-бот, который начинался как «ну, пара милых команд» и незаметно для всех вырос в полноценный швейцарский нож для сервера. Уровни, экономика, модерация, тикеты, временные каналы, кастомные роли, ИИ-чат, логи — и всё это с веб-панелью, которую не стыдно показать друзьям.
Маленькая честность для начала. Проект живой и постоянно пилится. Где-то может вылезти баг, где-то — опечатка, а где-то функция, которой вчера ещё не было 🌱 Нашёл что-то странное — это только начало.
Раньше было «минималистично».
Сегодня Маяри — это не «бот на пару команд», а целая экосистема, у которой даже своя панель управления есть. Если коротко описать философию:
- 🍦 Принцип ванили. Всё, что делает Маяри, должно ощущаться как естественное продолжение Discord, а не как инородный комбайн. Никаких «нажмите 7 кнопок, чтобы поздороваться».
- 🎨 Красиво по умолчанию. Профили на канвасе, аккуратные эмбеды, панель в эстетике Discord. Глазам не больно.
- ⚙️ Глубоко, если надо. Не хочешь копаться — всё работает из коробки. Хочешь покрутить каждую гайку — велкам, гаек много.
Что Маяри умеет (краткий тизер)
Полный список расползётся на десяток страниц, поэтому вот самое вкусное:
| Модуль | Что делает | Одной фразой |
|---|---|---|
| 🆙 Уровни | XP за сообщения и голосовые, роли-награды, кастомные профили | «активничай — получай плюшки» |
| 🪙 Экономика | Валюта, работа, магазин ролей, переводы | «капитализм, но милый» |
| 🛡️ Модерация | Варны, автомод, наказания, журнал действий | «порядок без ручного труда» |
| 🎟️ Тикеты | Обращения в поддержку с транскриптами | «жалобы в одном месте» |
| 🔊 Временные каналы | Свой голосовой канал по клику | «комната под себя за секунду» |
| 👋 Приветствия и бусты | Кастомные сообщения на вход и буст | «встречаем по красоте» |
| 🤖 ИИ-чат | Ответы нейросети в выбранных каналах | «свой карманный собеседник» |
| 📊 Логи и журнал | Прозрачность всех событий | «кто, что и когда — записано» |
Не пугайся объёма. Тебе не нужно настраивать всё сразу. Включай модули по одному, по мере того как они становятся нужны. Маяри прекрасно работает, даже если ты используешь одну только систему уровней.
Как тут вообще всё настраивается
Есть два пути, и они дружат между собой:
- Веб-панель (основной способ). Заходишь через Discord-авторизацию, выбираешь сервер — и крутишь настройки мышкой, без единой команды. Большинство модулей живёт именно тут.
- Команды прямо в Discord. Слэш-команды (
/) для всего, что удобнее делать на месте: профиль, работа, магазин, модерация.
Вся конфигурация сервера хранится в одном месте, так что панель и бот всегда видят одинаковые настройки. Поменял что-то на сайте — бот узнает об этом сам.
С чего начать новичку
Маршрут «за 5 минут до первого вау»:
- Пригласи Маяри и выдай ей права (особенно «Управлять ролями» — без них роли-награды не выдадутся).
- Зайди в панель, выбери сервер.
- Включи Систему уровней — это самый быстрый способ оживить чат.
- Накидай пару ролей-наград, чтобы людям было к чему стремиться.
- Понаблюдай, как сервер начинает болтать активнее 📈
Куда дальше
Эта документация будет расти вместе с ботом. Начни отсюда:
- Система уровней — за что, как и по каким формулам капает XP. Самая частая первая настройка.
- Тэги конструктора сообщений — переменные вроде
{userMention}и{newLevel}для красивых кастомных сообщений.
А пока — спасибо, что ты с Маяри... Сервер без активности — это плохой meow meow!11!1 Давай это исправим вместе 💜