discord-bot/FEATURES.md

🤖 Loki Discord Bot - Функции

📋 Описание

Многофункциональный Discord бот с системой уровней, личными голосовыми каналами, модерацией и развлекательными командами. Все команды — префиксные (ниже для краткости префикс !; реальный префикс задаётся в конфиге бота).

Технологии:

• Java 21
• JDA 5.0.0
• SQLite + автомиграция
• Google Guice (DI)

---

⭐ Основные функции

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

• Формула: 200 XP × уровень
• Получение XP:
  • 10 XP за сообщение (cooldown 60 сек)
  • 1 XP за минуту в войсе
• Команды:
  • !rank [@user] — карточка ранга
  • !leaderboard — топ по уровням/сообщениям/войсу
• Уведомления: Красивые embed при повышении уровня
• Награды: Роли за достижение уровней (5, 10, 20, 30, 50)

🎤 Личные голосовые каналы

• Автосоздание: Зайди в канал-триггер → создастся личный канал
• Управление через кнопки:
  • 🔒 Закрыть/Открыть
  • 👥 Лимит пользователей
  • ✏️ Переименовать
  • 🎨 Битрейт
  • 🚫 Удалить
• Автоудаление: Пустые каналы удаляются автоматически
• Настройка: !voice-setup

📊 Счетчик участников

• Автообновление: Название канала с количеством участников
• Формат: 【👥】Участники: 123
• Статистика: Присоединения/выходы за день
• История: 30 дней
• Настройка: !counter-setup

📝 Логи модерации

• Что логируется:
  • 🗑️ Удаление сообщений
  • 🔨 Баны/разбаны
  • 👢 Кики
  • 🔇 Муты/размуты
  • 🎤 Отключение микрофона/звука
• Настройка: !log-setup moderation / !log-setup levelup

🎮 Развлекательные команды

Игры:

• !coin — подбросить монетку
• !dice — бросить кубик
• !8ball — магический шар
• !ship @user1 @user2 — совместимость
• !rate — оценить что-то
• !gay, !fat, !iq, !pp — процентомеры

GIF-интерактив (nekos.life):

• !hug, !kiss, !poke, !slap, !tickle, !cuddle, !feed

Развлечения (текст):

• !pat — погладить (без GIF, несколько pat-pat)
• !compliment, !roast — комплимент / жарка

🛡️ Модерация

• !ban, !kick — бан / кик пользователя
• !clear <amount> — очистить сообщения
• Автологирование всех действий

🎨 Кастомные роли

• !createrole — создать роль
• !deleterole — удалить роль
• !editrole — редактировать роль
• !myroles — мои роли

📈 Статистика

• !stats — статистика сервера
• !rep, !minusrep — репутация
• !reptop — топ по репутации

🔧 Утилиты

• !avatar [@user] — аватар пользователя
• !info [@user] — информация о пользователе
• !poll — создать голосование
• !ping — пинг бота
• !help — справка

---

⚙️ Команды настройки (только админы)

Личные войс-каналы

!voice-setup trigger <channel>      - канал-триггер
!voice-setup category <category>    - категория для каналов
!voice-setup text-channel <channel> - текстовый канал для панелей
!voice-setup info                   - показать настройки

Счетчик участников

!counter-setup channel <channel>  - установить канал
!counter-setup format <format>    - формат ({count})
!counter-setup info               - показать настройки

Логирование

!log-setup moderation <channel>  - канал логов модерации
!log-setup levelup <channel>     - канал уведомлений level up
!log-setup info                  - показать настройки

Сброс уровней (одноразовая команда)

!resetlevels

Описание: Сбрасывает уровни и XP всех пользователей на сервере.

Требования:

• Права администратора
• Команда работает только один раз
• Требует подтверждения через кнопки

Что сбрасывается:

• Уровень → 0
• XP → 0

Что сохраняется:

• Время в голосовых каналах
• Количество сообщений
• Репутация

---

🔐 Команды супер-админа

Супер-админ ID: 1414975197269987471

Генерация рейтингов

!generateratings

Описание: Генерирует все rating значения для всех участников сервера.

Генерируемые рейтинги:

• Ship (0-100%)
• Gay (0-100%)
• IQ (0-200)
• PP (0-30 см)
• Mustache (0-100, редко 1000-1500)
• Fat (0-100%)
• Boykisser (0-100%)

Особенности:

• Не перезаписывает существующие значения
• Пропускает ботов
• Генерирует для всех участников сервера

---

🗄️ База данных

SQLite с автоматической миграцией из JSON:

• config - конфигурация
• user_stats - статистика пользователей
• reputation - репутация
• ship_pairs - ship пары
• custom_roles - кастомные роли
• voice_channels - личные каналы
• counter_stats - статистика счетчика

---

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

1. Запуск:

gradle run

2. Настройка:

!voice-setup trigger #создать-канал
!voice-setup category Личные каналы
!voice-setup text-channel #управление

!counter-setup channel #счетчик
!counter-setup format 【👥】Участники: {count}

!log-setup moderation #логи
!log-setup levelup #level-up

3. Готово! Зайди в канал-триггер → создастся личный канал

---

📦 Структура проекта

src/main/java/creator/loki/
├── audio/          # TTS и аудио
├── command/        # Команды
│   └── impl/
│       ├── entertainment/  # Игры и взаимодействия
│       ├── moderation/     # Модерация
│       ├── roles/          # Кастомные роли
│       ├── setup/          # Настройка
│       ├── stats/          # Статистика
│       └── utility/        # Утилиты
├── config/         # Конфигурация
├── core/           # Ядро бота
├── counter/        # Счетчик участников
├── data/           # JSON хранилище
├── database/       # SQLite + миграция
├── level/          # Система уровней
├── listener/       # Event listeners
├── voice/          # Личные каналы
└── util/           # Утилиты

---

🎯 Особенности

✅ Dependency Injection (Google Guice)
✅ SQLite с автомиграцией из JSON
✅ Graceful shutdown всех компонентов
✅ Логирование (SLF4J + Logback)
✅ Кэширование (Caffeine)
✅ Rate limiting и cooldowns
✅ Метрики производительности
✅ Модульная архитектура

---

📝 Права бота

Необходимые права:

• ✅ MANAGE_CHANNELS - создание/удаление каналов
• ✅ MOVE_MEMBERS - перемещение пользователей
• ✅ MANAGE_PERMISSIONS - выдача прав
• ✅ MANAGE_ROLES - управление ролями
• ✅ BAN_MEMBERS - баны
• ✅ KICK_MEMBERS - кики
• ✅ MANAGE_MESSAGES - удаление сообщений
• ✅ VIEW_AUDIT_LOG - просмотр логов

---

🔄 Обновления

v2.0 (2026-05-11)

• ✅ SQLite база данных
• ✅ Автомиграция из JSON
• ✅ Личные голосовые каналы
• ✅ Счетчик участников
• ✅ Логи модерации
• ✅ Уведомления level up
• ✅ Обработчик кнопок для войс-каналов

v1.0

• Базовая система уровней
• Команды развлечений
• Модерация
• Кастомные роли

---

Версия: 2.0
Дата: 2026-05-11
Автор: Loki Bot Team