Документація модулів

Тікети

Підтримка через приватні канали. Юзер тисне кнопку — відкривається канал, видимий лише йому й ролі модераторів.

• Кілька типів тікетів (різні кнопки → різні ролі сповіщення)
• Транскрипт автоматично зберігається при закритті (до 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-тестів кампаній
• Перемикач активна/вимкнена — можна паузити без видалення