EL BOT

📋 Обзор бота

EL Bot - это специализированный Discord бот, разработанный для кланов Мира Танков. Бот предоставляет широкий функционал для управления кланом, отслеживания статистики игроков, автоматизации резервов и приема новых участников.

• Интеграция с API Lesta Games
• Подробная статистика игроков и кланов
• Система авторизации через OAuth
• Встроенный веб-сервер для OAuth аутентификации
• Активация клановых резервов по расписанию
• Военкомат с настраиваемыми вопросами
• Автоматическое присвоение ролей
• Система приветствий новых участников

🎮 Информационные команды

ℹ️

/инфо игрок

Получение подробной информации об игроке Мира Танков

инфо игрок [никнейм] [скрытое]

Параметры:

• никнейм - игровой ник или упоминание участника сервера (необязательно)
• скрытое - показать результат только автору команды (необязательно, выбор "Да")

Функции:

• Автодополнение никнеймов при вводе (от 3 символов)
• Отображение общей статистики игрока
• Показ WN8 рейтинга и цветовой индикатор
• Информация о клане и роли в нем
• Генерация userbar статистики

👤

Инфо танкиста

Показать информацию об аккаунте пользователя через контекстное меню

ПКМ по пользователю → Приложения → Инфо танкиста

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

• Автоматический поиск никнейма в имени пользователя
• Быстрый доступ к статистике без ввода команд
• Работает как в серверах, так и в личных сообщениях

👤 Управление профилем

🔐

/профиль авторизоваться

Авторизация на сервере с привязкой аккаунта Lesta Games

профиль авторизоваться

Процесс авторизации:

• Автоматическое присвоение никнейма по шаблону сервера
• Присвоение ролей на основе WN8 и членства в клане

Дополнительные функции:

• Автоматическое создание цветовых WN8 ролей
• Управление клановыми и дружественными ролями
• Валидация имени пользователя (только кириллица)

🗑️

/профиль удалить

Удаление данных пользователя из базы бота

профиль удалить

Возможности удаления:

• Удаление конкретного аккаунта Lesta Games
• Полное удаление всех данных пользователя
• Интерактивный интерфейс с выбором опций

Что удаляется:

• Токены доступа к API
• Персональные данные и имя
• Связи Discord ID с аккаунтами

🛡️ Управление резервами

⏰

/резервы расписание

Только администраторы

Настройка автоматической активации резервов по расписанию

резервы расписание

Возможности:

• Настройка времени активации (выбор часа)
• Автоматическая проверка наличия резервов
• Уведомления о недостаточном количестве

🎖️ Военкомат

📝

/военкомат заявка

Подача заявки на вступление в клан

военкомат заявка

Требования:

• Предварительная авторизация через /профиль авторизоваться
• Настроенный военкомат на сервере

Процесс:

• Заполнение анкеты с настраиваемыми вопросами
• Автоматическая проверка статистики
• Анализ топ техники игрока
• Отправка заявки в специальный канал
• Уведомление офицеров клана

Анализ статистики:

• Проверка статистики по топ технике
• Расчет побед и среднего урона
• Анализ боевых режимов
• Формирование рейтинга техники

⚙️ Администрирование

🔧

/сервер настроить_сервер

Только администраторы

Мастер настройки бота для текущего сервера

сервер настроить_сервер

Требования:

• Авторизация администратора
• Членство в клане с ролью офицера штаба и выше
• Актуальный токен доступа к API

Настройки:

• Подключение к API Lesta Games
• Настройка ID клана
• Выбор каналов для уведомлений
• Настройка шаблона никнеймов
• Настройка ролей (клановая, дружественная)
• Настройка командного чата

🎨

/сервер панель_авторизации

Только администраторы

Создание панели с кнопками авторизации

сервер панель_авторизации

Функции:

• Создание красивого embed сообщения
• Интерактивные кнопки для авторизации
• Выбор канала для публикации

⚙️

/сервер настроить_военкомат

Только администраторы

Настройка параметров военкомата

сервер настроить_военкомат

Настройки:

• Настраиваемые вопросы для анкеты
• Выбор канала для отправки панели

👥

/сервер кто_не_авторизован

Только администраторы

Показать список участников клана, не авторизованных на сервере

сервер кто_не_авторизован

Функции:

• Сравнение списка участников клана с авторизованными пользователями
• Постраничный вывод с пагинацией (по 8 участников)
• Интерактивные кнопки для получения информации
• Прямые ссылки на профили игроков
• Автоматическое перенаправление на настройку сервера при необходимости

👋

/сервер приветствие

Только администраторы

Настройка приветствия новых участников сервера

сервер приветствие

Возможности:

• Настраиваемое сообщение приветствия
• Выбор канала для приветствий
• Личные сообщения при отсутствии канала
• Добавление иконки сервера
• Упоминание нового участника

🔄 Автоматические функции

🔧 Технические особенности

Бот построен на современных технологиях и обеспечивает надежную работу 24/7:

🏗️ Архитектура

• Модульная структура с системой Cogs
• Асинхронная обработка запросов
• Надежная система логирования с loguru
• Автоматическое обновление токенов
• Система планировщиков для фоновых задач
• Обработка ошибок и восстановление
• Интерактивные View компоненты
• Мастера настройки для сложных операций

📊 Интеграции

• Lesta Games API (Мир Танков)
• Tankomatic.ru для генерации userbar
• PostgreSQL для хранения данных
• OAuth 2.0 для безопасной аутентификации

🔒 Безопасность

• OAuth 2.0 аутентификация через Lesta Games
• Автоматическое истечение сессий
• Проверка прав доступа для команд
• Защита от SQL инъекций
• Валидация входных данных
• Эфемерные ответы для конфиденциальных данных