С чего начинается 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.

Настройка сервера в веб-панели

Админ-панель на сайте (/admin) — самый простой способ настроить Akane под свой сервер: не нужно запоминать команды, всё видно и заполняется в интерфейсе. Ниже — краткое описание того, что делает каждая вкладка.

Панель открывается после входа через Discord. Она доступна владельцу сервера, а также тому, кто добавил бота на сервер.

Вкладка «Обзор»

Открывается первой при входе в панель конкретного сервера. Показывает статус настройки: сколько панелей уже заполнено, включена ли автомодерация, заданы ли правила доступа к командам — и общий прогресс в процентах. Рядом — краткая сводка по серверу (количество участников, роль бота и её место в иерархии ролей) и чек-лист ключевых прав бота с подсказкой, что включить в настройках сервера Discord, если какого-то права не хватает.

Если всё горит зелёным — сервер настроен и готов к работе. Если что-то не хватает — вкладка сразу подсказывает, куда перейти.

Вкладка «Панели»

Здесь настраивается содержимое персистентных панелей бота: выбор пола (/gendr), роли по играм (/addrolesgame), заявки в стафф (/addstaffapp), навигационное меню (/navigation), уведомление о выходе участников и панель приёма жалоб. Выберите панель в списке слева, заполните текст, роли и каналы справа и нажмите «Сохранить панель».

Роль бота Akane должна быть выше ролей, которые она выдаёт участникам — иначе выдача роли не сработает (ограничение самого Discord).
Роли и участники выбираются из выпадающего списка с поиском — вводить ID вручную не обязательно.
Кнопка «Сбросить панель» возвращает панель к пустым настройкам.

Вкладка «Автомод»

Автоматическая модерация чата: удаление сообщений с запрещёнными ссылками, Discord-инвайтами, доменами или фразами. Можно включить предупреждение участнику после удаления сообщения, указать канал для логов срабатываний, ограничить работу автомода определёнными каналами и задать роли или участников-исключения, которых фильтр не проверяет.

Вкладка «Команды»

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

Вкладка «Пользователи»

Поиск участника сервера и ручное управление его прогрессом: баланс AC, уровень, музыкальные команды, накопленное время в голосовых каналах и количество акций. Здесь же — сброс прогресса участника и удаление его кастомной роли.

Оба «опасных» действия необратимы: сброс прогресса удаляет уровень, баланс, войс-время и роли, выданные за акции/уровни. Перед подтверждением в панели всегда показывается явное описание того, что именно будет удалено.

Вкладка «Авто-викторина»

Настройка автоматической викторины на сервере: выбор канала, где будут появляться вопросы, и время следующего запуска (в формате ЧЧ:ММ, ДД.ММ ЧЧ:ММ или ДД.ММ.ГГГГ ЧЧ:ММ по московскому времени).

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

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

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

Общие теги

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

Приветствия

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

Бусты

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

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

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

Поддержка embed

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

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