Документация модулей

Тикеты

Поддержка через приватные каналы. Юзер жмёт кнопку — открывается канал, виден только ему и роли модераторов.

• Несколько типов тикетов (разные кнопки → разные роли уведомления)
• Транскрипт автоматически сохраняется при закрытии (до 20 МБ на тикет)
• Auto-close по таймауту переживает рестарт бота
• Нужные права: Manage Channels (создание/удаление каналов тикетов)

Выдача ролей

Кнопочные или реакционные меню для самостоятельного выбора ролей.

• До 5 ролей на кнопочную панель (лимит Discord); 25 на select-меню
• Один из двух режимов: multi-select или single-select
• Нужные права: Manage Roles, плюс роль бота выше выдаваемых

Реакции и Кнопки-Роли

Два типа панелей для самостоятельной выдачи ролей: реакционные (тыкнул эмодзи → дали роль) и кнопочные. Режим toggle позволяет держать несколько ролей; unique-pick заставляет выбрать одну.

• Реакционные панели: любые эмодзи сервера или unicode → маппинг на роль
• Кнопочные панели: до 5 кнопок в ряд, цвета и подписи кастомные
• Настройка заголовка embed'а, цвета и описания
• Нужные права: Manage Roles, плюс роль бота выше выдаваемых

События

Запись участников с напоминаниями. Опционально — кросс-серверные.

• Кнопки записи (до 10 на событие), индивидуальные лимиты, цвета
• Уведомления: за N минут в ЛС и/или в канале (тегаем записавшихся или роль)
• Циклические события: повтор раз в N мин/час/день/нед/мес
• Время публикации: можно настроить заранее, прошедшее — публикуется сразу
• Избранное (⭐) пинит событие в начало истории и сохраняет навсегда

Турниры

Полноценный турнирный модуль с авто-bracket'ом и cross-server участием.

• Форматы: single/double elimination, round-robin (с matchesPerPair), групповая стадия + плей-офф
• Cross-server режимы: NONE (только хост), INVITE_ONLY (по приглашениям), PUBLIC (открытый каталог в /tournaments)
• Best-of: BO1/BO3/BO5/BO7 со score-tracking'ом
• Авто-публикация bracket'а в Discord, real-time обновление standings

Приветствие и Прощание

Приветствия и прощания с поддержкой ротации баннеров.

• Режимы: только канал, только ЛС, оба
• Markdown-форматирование в тексте (B/I/U/S/code/quote/spoiler)
• Несколько баннеров — бот случайно ротирует при каждом приветствии

Верификация

Проверка перед выдачей ролей. Полезно против ботов.

• Режимы: Instant (просто кнопка), Math (арифметика), Question (свой вопрос)
• Auto-kick: если юзер не верифицировался за N минут — выкидываем
• Нужные права: Manage Roles, Kick Members

Конструктор сообщений

Embed-сообщения с превью, кнопками-ссылками и шаблонами.

• Сохранение в избранное, история последних 50
• Отложенная публикация (scheduled)
• Редактирование уже опубликованных сообщений

Экономика

Монеты за активность, лидерборды, магазин ролей.

• +1 монета за сообщение (cooldown 10 сек), +6/мин в голосовом, +1 за первую реакцию
• Периоды: weekly/monthly/quarterly — раз в период обнуляется periodEarned
• Магазин: можно купить роль или кастомную награду за монеты

Розыгрыши

Розыгрыши с условиями и кросс-сервером.

• Условия: без условий / по роли / списание монет
• Кросс-сервер: общий пул участников с разных серверов
• История с возможностью рестарта (paid-participants входят бесплатно при рестарте)

Дни рождения

Участники сами указывают свой день рождения через slash-команду — в нужный день бот публикует поздравление в выбранном канале. Опционально — режим годовщин: считаем сколько лет человек на сервере и поздравляем отдельно.

• Slash-команда для участников: указать день/месяц (год опционально)
• Ежедневная проверка публикует поздравления в настроенном канале
• Режим годовщин: считаем годы с момента вступления на сервер
• Кастомный шаблон сообщения с placeholders {user} и {years}

Voice Plus

Временные голосовые каналы по запросу. Юзер заходит в триггер-канал «Создать голосовой» — бот спавнит свежий VC лично под него, даёт Manage Channels в нём и автоматически удаляет канал, когда все вышли.

• Триггер-канал — заход в него спавнит персональный voice-room
• Owner получает Manage Channels в своей комнате: переименовать, лимит, лок
• Авто-удаление при пустоте, чтобы категория оставалась чистой
• Опциональный шаблон имени с placeholder {user}

Модерация

Авто-модерация и предупреждения.

• Anti-spam (5 сообщений / 5s), anti-flood (одинаковые сообщения), anti-profanity
• Эскалация мутов: 1-й → 2 мин, 2-й → 5 мин, 3+ → 10 мин
• Warning-система с настраиваемыми actions на каждый счёт
• Нужные права: Moderate Members, Kick Members, Ban Members, Manage Messages

Антирейд

Защита от массовых джойнов и raid'ов — авто-обнаружение по сигнатуре.

• Лимиты по новизне аккаунта, отсутствию аватара, скорости джойнов
• Автоматический режим высокой тревоги при пороге
• Логирование всех действий в audit-канал

Аудит прав

PRO+ сканер обходит @everyone и не-админские роли в поисках опасных разрешений — MANAGE_CHANNELS, MANAGE_ROLES, MENTION_EVERYONE у широкой аудитории. Каждый finding идёт с предложенным фиксом, который можно применить или скрыть.

• Сканирует @everyone и все не-админские роли на рискованные права
• Категоризация findings: critical / warning / info
• Предложенный фикс на каждый finding с применением в один клик
• Ежемесячный авто-скан с DM-уведомлением при critical issues

Массовая Настройка

Инструменты массового редактирования, экономят десятки кликов при первичной настройке или реструктуризации сервера. Создавай много ролей или каналов разом, выдавай роль всем подходящим под условие, копируй overrides между каналами.

• Массовое создание ролей из списка (имена, цвета, права)
• Массовое создание каналов в категории с общими overrides
• Условная выдача роли: по существующей роли, дате джойна, активности
• Копирование permission overrides между каналами в один клик

Доступ к панели

Owner может выдавать доступ к конкретным модулям админам и модераторам без права Administrator на уровне Discord. Гранулярно: «этот модератор управляет только Тикетами» — остальных модулей в панели он не увидит.

• Выдача доступа по Discord-роли или по конкретному user ID
• Per-module scope: Tickets, Events, Giveaways, Logging и т.д.
• Режим read-only или полный edit для каждого модуля
• Audit-лог всех действий в панели остаётся с атрибуцией на actor'а

Логирование

Аудит действий: входы, выходы, удаления сообщений, изменения ролей и т.д.

• Режимы вывода: Discord-канал, web-аудит, оба
• Storage limit: настраивается в МБ, старые записи чистятся

Счётчики

Голосовые каналы со статами в названии: участников, онлайн, в голосовом и т.д.

• Обновляются раз в 10 минут (Discord rate-limits 2 переименования/10 мин на канал)
• 10 метрик: TOTAL/ONLINE/ROLE/BANNED/IN_VOICE/NEW_24H/TIME/CUSTOM_TEXT и др.

Метрики сервера

Дашборд активности, показывающий пульс сервера: тренд участников, топ-каналы, топ-реакции, голосовые минуты и health-score. PRO+ открывает heatmap и cohort retention; PREMIUM добавляет разбивку по модулям.

• Тренд участников по дням с дельтами джойнов/выходов
• Топ-каналы, топ-реакции, голосовые минуты
• Health-score, объединяющий сигналы активности и retention
• PRO+: heatmap активности (час × день недели) и cohort retention
• PREMIUM: разбивка аналитики по модулям

Журнал участников

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

• Агрегаты totalJoins / totalLeaves / kicks / bans / mutes / warnings
• Фильтры: все / на сервере / вышли / забанены
• Поиск по нику, сортировка по любой метрике
• Метки first-seen, last-join, last-leave на каждого участника

Стримеры

Уведомления о стримах Twitch и YouTube.

• Опрос каждые 5 минут (parallel concurrency=8)
• Кастомный текст анонса с placeholders {name} и {url}
• Нужны API ключи: TWITCH_CLIENT_ID/SECRET, YOUTUBE_API_KEY в .env

Авто-реакции

Бот случайным образом реагирует на сообщения; кодовые слова дают роли.

• Шанс срабатывания 1–5% (намеренно низкий, чтобы не было навязчиво)
• Кодовые слова: 5 попыток / минуту на юзера (защита от брутфорса)

Cross-server события и розыгрыши

Один event/giveaway на нескольких серверах одновременно — единый список участников.

• PRO-фича: invite-ссылки от одного хоста к другим серверам с PULSORT
• Единый лидерборд по всем участвующим серверам
• Server-tags, чтобы видеть откуда пришёл участник

Журналист дискорда

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

• Метрики: сообщения, реакции, голосовое время
• Временная роль на неделю + персональный hoisting в списке участников
• Авто-объявление в указанном канале с топ-3

ИИ Журналист

Авто-публикация game-news + халявных игр (Epic Games, Steam free).

• Источники: Epic Games Store, Steam, Itch.io free promotions
• Фильтр по жанрам и платформам
• Расписание публикаций — раз в N часов в указанные каналы

ИИ Нарушитель тишины

Авто-публикация вопросов и обсуждений, когда канал тихий (PRO).

• Детект тишины: N минут без сообщений в канале
• AI генерирует контекстно-релевантный вопрос исходя из недавней истории
• Темплейты + override от owner'а

Магнит возврата

Возврат неактивных юзеров через персонализированные DM (PREMIUM).

• Trigger: юзер не заходил X дней
• AI пишет DM с упоминанием недавних событий сервера
• Frequency limit — не более 1 DM в месяц на юзера

Эмодзи и стикеры

Управление эмодзи и стикерами сервера прямо из дашборда — переименовать, удалить, залить пачкой. Делает бэкап всей библиотеки в архив, чтобы можно было восстановить если Discord её зачистит или ты переедешь на новый сервер.

• Batch-загрузка из ZIP — имена файлов становятся именами эмодзи
• Переименование и удаление из дашборда без context-click на каждом
• Бэкап библиотеки в архив; восстановление в один клик
• Нужные права: Manage Expressions

Брэндинг

PREMIUM-only — заменяет ник бота, аватар и embed-footer на твоей гильдии своим брэндингом. «Powered by PULSORT» можно оставить или заменить; всё остальное выглядит как кастомный in-house бот.

• Per-guild override ника бота и аватара
• Кастомный embed-footer (Powered-by строка опциональна)
• Опциональный accent-color применяется ко всем embed'ам модулей
• PREMIUM-only фича

Кастомные ссылки

Создаёт брендированные короткие ссылки вида pulsort.gg/yourservername, которые редиректят на Discord-инвайт. Клики считаются — видишь какой маркетинговый канал реально приводит людей.

• Кастомный slug: pulsort.gg/<твой-slug> → Discord-инвайт
• Счётчик кликов на каждую ссылку с разбивкой по дням
• Несколько ссылок на сервер для A/B-тестов кампаний
• Переключатель активна/выключена — можно паузить без удаления