LumeX Bot

LumeX Bot делали для собственного сервера студии, поэтому в нём есть всё, что нужно живому Minecraft-проекту каждый день: порядок в чате, поддержка игроков, активность и связь с сайтом. Бот заменяет связку из Sapphire, MEE6, Ticket Tool, музыкального бота и пары самописных, а все его сообщения выглядят в одном стиле - с баннерами, аккуратными карточками и собственными иконками. Иконки загружаются как эмодзи приложения и не занимают слоты эмодзи вашего сервера.

Быстрый старт

Сервер можно поднять почти с нуля за несколько команд. /настройка создать-каналы создаёт основные каналы и сразу ставит в них оформленные блоки. /настройка создать-логи делает категорию «Логирование» со всеми каналами логов, а если каналы уже есть, /настройка логи-авто сам найдёт их по названиям. Роли участника, поддержки, бустера и пинга релизов задаются через /настройка роль, а /настройка показать выводит все текущие настройки одной карточкой. Для серверов-сообществ есть /настройка адаптация: она заменяет вопросы онбординга Discord на выбор ролей уведомлений.

Готовые блоки и панели

Команда /панель публикует оформленный блок в текущем канале, а повторный вызов заменяет старый блок новым, без дублей.

Правила - баннер и выпадающий список разделов: игрок выбирает раздел и видит его текст, канал не превращается в простыню.

Памятка - главное о сервере и проекте с кнопками на сайт и магазин, список ролей сервера.

Тикеты - панель поддержки с выбором темы.

Уведомления - кнопки ролей: нажал - получил роль и пинги, нажал ещё раз - снял. Роли создаются командой /настройка роли-уведомлений.

Отзывы - число отзывов и последний одобренный отзыв, кнопки «Читать все» и «Оставить отзыв».

Статистика - живые цифры проекта, обновляются сами каждые несколько минут.

Вакансии - набор в команду с кнопкой.

Готовые наборы каналов

/создать разворачивает целые разделы сервера одной командой:

Комнаты команды - голосовые для администрации, модерации, поддержки и технических вопросов.

Собеседования - зал ожидания, три комнаты обзвона на двоих и комната итогов.

Форумы - мемы (галерея), помощь и вопросы, с закреплённой инструкцией и тегами.

Каналы команды - закрытые разделы администрации и персонала: объявления, отчёты, выговоры, общение, бусты, системные сообщения.

Счётчики - каналы «Участников», «В сети», «Товаров» и «Отзывов» прямо в названиях, обновляются каждые 10 минут.

Каждый понедельник в 10:00 по МСК бот публикует отчёт команды за неделю: тикеты, оценки поддержки и действия модерации. Отчёт за любой период можно получить сразу командой /отчет.

Логи в стиле Sapphire

Бот записывает всё, что происходит на сервере, и раскладывает события по отдельным каналам:

• входы и выходы с информацией об аккаунте и о том, по чьему приглашению человек пришёл;
• создание и удаление приглашений, баны и разбаны;
• изменения сервера, каналов, эмодзи и ролей;
• выдача и снятие ролей, смена ников и аватаров;
• удалённые, изменённые и массово удалённые сообщения с исходным текстом;
• входы, выходы и переходы в голосовых каналах;
• тикеты, модерация, рост уровней и роли за активность.

Модерация

Каждое действие модератора - это дело с номером в базе и карточка в логе модерации. Есть мут через встроенный тайм-аут Discord, бан (в том числе временный с автоматическим разбаном), разбан по ID и кик. Варны копятся, и третий автоматически даёт мут на час. Снять варн можно по номеру дела, а /наказания показывает всю историю участника. /очистить удаляет до 1000 сообщений с фильтрами по автору и типу, /медленный-режим ставит задержку в канале.

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

Защита от спама и рейдов

Автомодерация включается командой /защита и не трогает команду проекта.

• Чужие приглашения в Discord удаляются.
• Флуд (6 сообщений за 6 секунд или 4 одинаковых за 30 секунд) - мут на 10 минут.
• Капс (от 12 букв и больше 70% заглавных) удаляется.
• Массовые упоминания (5 и больше участников в сообщении) - удаление и мут на 10 минут.
• Рейд (8 и больше входов за минуту) - тревога в лог модерации с пингом поддержки, а следующие 15 минут новые аккаунты младше недели сразу получают тайм-аут.

Верификация

Пока новичок не прошёл проверку, он видит только канал верификации: нажимает кнопку, отвечает на простой пример и получает роль «Участник», приветствие в личные сообщения и запись в лог. Боты и твинки так на сервер не попадут.

Верификация включается одной командой /верификация-создать. Бот сам выдаст роль «Участник» всем, кто уже на сервере, перенесёт в неё права @everyone и откроет для неё нужные каналы - у старых участников ничего не пропадёт. В блоке виден счётчик прошедших проверку. /верификация-выключить возвращает всё как было.

Тикеты поддержки

Игрок выбирает тему в панели: заказ, оплата и баланс, жалоба на игрока, баг или ошибка, сайт, сотрудничество или другое. Затем он заполняет короткую форму, и бот открывает приватный канал. Чтобы не было спама, у одного человека открыто не больше двух тикетов.

Команда поддержки нажимает «Взять», может «Добавить участника» и «Закрыть» тикет. При закрытии вся переписка сохраняется в лог HTML-файлом, который открывается в браузере как настоящий чат, а игрок получает в личные сообщения просьбу оценить поддержку от 1 до 5 звёзд. /тикеты-статистика показывает закрытые тикеты и средние оценки по каждому сотруднику. Кнопки работают и после перезапуска бота.

Активность, уровни и профиль

Опыт начисляется за сообщения и время в голосе, но накрутить его нельзя. Сообщение засчитывается не чаще раза в минуту и только от 4 символов. Голос засчитывается, только если в канале есть живой собеседник, у вас включены микрофон и звук и это не AFK-канал. Опыт до уровня растёт квадратично, как у MEE6, так что высокие уровни говорят о реальной активности.

За уровни выдаются роли, а за время общения - отдельные титулы: «чатовые» за минуты общения в чате и «голосовые» за часы в войсе. /профиль рисует красивую карточку участника с аватаром, уровнем, прогрессом до следующего, числом сообщений, часами в голосе, местом в топе и ближайшей ролью. Есть /топ, /топ-голос и /топ-сообщения, а администратор может поправить опыт командой /опыт.

Приватные голосовые комнаты

/приватки создаёт систему комнат: игрок заходит в канал-создатель, и бот делает ему личную голосовую комнату. Управлять ею можно кнопками и меню в отдельном канале, без команд: переименовать, задать лимит мест, закрыть и открыть, скрыть и показать, выдать или забрать доступ конкретному человеку, замутить, выгнать и передать владение. Пустые комнаты удаляются сами.

Музыка и радио

/play - по названию с подсказками прямо при вводе или по ссылке: YouTube, Яндекс Музыка (трек, альбом, плейлист), SoundCloud, ВК Видео и всё, что поддерживает yt-dlp.

/radio - интернет-радио из каталога с поиском станций в подсказках или по своей ссылке на поток.

/wave - «своя волна»: бесконечная подборка похожих треков от исполнителя или трека.

/mix - случайная подборка по жанру.

/смотреть - совместный просмотр YouTube в голосовом канале через активность Discord.

• Очередь, повтор трека или всей очереди, перемешивание, громкость до 150%, удаление трека из очереди и панель «Сейчас играет» с кнопками. Бот сам уходит, когда очередь пуста или в канале никого не осталось.

Сообщество

Идеи и баги - /идея публикует предложение с голосованием «за» и «против» и веткой для обсуждения. Команда ставит статус: принята, в работе, готово или отклонена.

Розыгрыши - /розыгрыш с кнопкой «Участвовать», счётчиком участников и таймером. Победителей бот выбирает сам, а /розыгрыш-переиграть выбирает нового.

Приветствия - Новичок получает роль «Участник», карточку приветствия в канале с аватаром и своим номером на сервере, а в личные сообщения - большой гид по серверу и сайту с кнопками. При необходимости приветствие можно отправить вручную. /выдать-всем выдаёт роль всем, у кого её ещё нет.

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

Посты от имени бота

/пост публикует красивый пост от имени бота: заголовок, текст с форматированием, обложка или галерея до 10 картинок, кнопки-ссылки и пинг роли. Уже опубликованный пост можно отредактировать через /пост-изменить, а /реакции ставит реакции под любым сообщением, в том числе эмодзи сервера.

Связка с сайтом и Telegram

Если у проекта есть сайт Авто-Донат LumeX, бот становится его частью.

• Релизы, обновления товаров, акции и статьи с сайта сами публикуются в нужные каналы с пингом выбранной роли. Посты из админки сайта тоже уходят через бота.
• Каналы и роли сервера видны в админке сайта: там выбирается, что и куда публиковать.
• Игроки, привязавшие Discord в профиле сайта, автоматически получают роль «Покупатель». /аккаунт показывает их покупки на сайте.
• Общий чат: сообщения с сайта приходят в канал Discord с именем и аватаром автора, а ответы из Discord - обратно на сайт.
• /релиз публикует карточку товара с ценой и кнопкой, а /telegram переносит релиз, обновление, статью или новость в Telegram-канал с цветными кнопками.

Что нужно для запуска

Python 3.11 или новее, ffmpeg для музыки и Node.js для YouTube. Работает на Windows и на Linux VDS, база - один файл. Название проекта и сайт вписываются в настройки, а баннеры, цвета и тексты меняются под себя.