С чего начинается Akane

Большие тёплые вступления — это тоже Akane, значит она нужна и как тут: всей структуре.

Привет! Если ты это читаешь, значит Akane уже на твоём сервере, либо ты присматриваешься. В обоих случаях — добро пожаловать. Ниже всё, что будет нужно.

Akane — это Discord-бот, который начинался как «пара милых команд», а постепенно стал полноценным помощником для сервера: уровни, экономика, модерация, приватные комнаты, заявки, кастомные роли, магазин и красивое оформление сообщений.

Можно настроить для любого сервера. Почти каждая система гибкая: роли, каналы, награды и тексты можно менять под свою атмосферу.

Раньше было «минималистично»

Akane выросла из простых команд в полноценный набор инструментов, который держит сервер живым и удобным:

Приятная активность. Уровни, XP и награды мотивируют людей общаться чаще.
Красивое оформление. Embed-генератор и теги помогают делать аккуратные объявления.
Контроль и порядок. Модерация, предупреждения, муты и настройки доступа помогают администрации.
Уютное общение. Экономика, RP-команды и мини-игры добавляют серверу живости.

Что Akane умеет

Полный список возможностей зависит от настроек сервера, поэтому вот самые важные модули:

Модуль	Что делает	Одной фразой
Уровни	XP за сообщения, голосовую активность и награды	«активность превращается в прогресс»
Экономика	Баланс, работа, магазин и переводы	«внутренняя валюта сервера»
Модерация	Предупреждения, муты, баны и ограничения	«порядок без лишней рутины»
Приватные комнаты	Временные голосовые каналы с управлением	«своя комната под себя»
Конструктор сообщений	Красивые embed-сообщения и шаблоны	«объявления без скучной стены текста»

Как тут вообще всё настраивается

Есть два пути, и оба дружат между собой:

Веб-панель — удобный способ настроить команды, панели, доступы и серверные разделы.
Команды прямо в Discord — быстрые действия, когда нужно сделать что-то сразу в чате.

Система уровней

Система уровней — это сердце активности сервера. Люди просто пишут, общаются в голосовых каналах и постепенно получают XP.

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

XP не должна превращаться в гонку. Лучше настраивать награды так, чтобы они поддерживали общение, а не заставляли людей спамить.

XP за сообщения

Каждое осмысленное сообщение может приносить опыт. Чтобы систему нельзя было накрутить, используется задержка между начислениями.

За обычное сообщение начисляется случайное количество XP.
Повторный опыт за сообщения выдаётся не сразу, а после небольшой паузы.
Бот игнорирует слишком частый спам и бессмысленную активность.

XP за голосовые каналы

За активность в голосовых каналах тоже можно получать опыт. Это помогает поощрять живое общение, а не только текстовые сообщения.

XP начисляется за время, проведённое в голосовом канале.
Если участник один или неактивен, начисление может быть ограничено.
Голосовой опыт особенно полезен для серверов с активными войсами.

Как XP превращается в уровни

Чем выше уровень, тем больше опыта нужно для следующего. Рост становится плавнее, а высокие уровни выглядят ценнее.

Уровень	Нужно XP	Что это значит
0 → 1	100	Первые шаги на сервере
1 → 2	175	Участник начинает проявляться
2 → 3	260	Активность становится заметной
5 → 6	650	Стабильное участие
10+	1000+	Уже постоянный участник сообщества

Награда за новый уровень

Когда участник получает новый уровень, Akane может отправить красивое сообщение и выдать роль-награду.

Сообщение о повышении можно настроить под стиль сервера.
Роли за уровни помогают выделять активных участников.
Награды лучше делать приятными, но не слишком обязательными.

Роли за уровни

Самая понятная мотивация — роль за достижение. Например, за 5, 10 или 20 уровень.

Роль выдаётся автоматически, когда участник достигает нужного уровня.
Если правила сервера меняются, роли можно перенастроить в панели.
Важно, чтобы роль Akane была выше наградных ролей в списке ролей Discord.

Теги конструктора сообщений

Список доступных переменных для настройки приветствий, уведомлений, уровней и красивых сообщений.

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

Общие теги

Тег	Описание
`{user}`	Упоминание пользователя
`{userTag}`	Ник пользователя
`{server}`	Название сервера
`{memberCount}`	Количество участников сервера
`{channel}`	Название канала

Приветствия

Тег	Описание
`{welcomeCount}`	Номер участника на сервере
`{joinedAt}`	Дата входа участника

Бусты

Тег	Описание
`{boostCount}`	Общее количество бустов сервера
`{boostLevel}`	Текущий уровень буста

Система уровней

Тег	Описание
`{level}`	Уровень пользователя
`{xp}`	Текущий опыт
`{rank}`	Место в топе сервера
`{nextLevelXp}`	Сколько опыта нужно до следующего уровня

Поддержка embed

Тег	Описание
`{embed}`	Режим красивого embed-сообщения
`{embedColor}`	Цвет embed-сообщения

Теги можно использовать как в обычном тексте сообщений, так и внутри embed-конструктора. Это помогает делать уведомления живыми и персональными.