Об этом проекте

Egg Shen Bot — это многофункциональный Discord-бот для самостоятельного хостинга, ориентированный на поиск развлечений и активности сообщества. Он выполняет поиск по семи типам медиа — фильмы, сериалы, эпизоды, видеоигры, настольные игры и книги — возвращая насыщенные эмбеды с синопсисами и рейтингами, агрегированными из нескольких источников, а также ссылки на страницу каждого сервиса для этого медиа. Среди указанных источников рейтингов и ссылок — IMDb, Letterboxd, Trakt, Rotten Tomatoes и JustWatch, а доступность стриминга обеспечивается через интеграцию с TMDB и Watchmode. Помимо поиска, бот предлагает систему турнирных сеток, поддерживающую групповые этапы из 4–12 групп, wildcards и раунды плей-офф с одинарным выбыванием. Инструменты для совместных просмотров включают таймеры, отслеживание истории просмотров и статистику сервера, а также команду announce. Социальные функции включают интерактивные опросы, поиск саундтреков, команду «magic potion» и опциональную генерацию изображений с помощью ИИ. Опциональная функция Event Requests позволяет участникам сообщества отправлять запросы на совместные просмотры через веб-форму с использованием Discord OAuth; модераторы одобряют или отклоняют их, а одобренные события создаются как Discord Scheduled Events. Управление сервером охватывает настраиваемые разрешения, переключение сервисов рейтингов, предпочтения по регионам и пользовательские эмодзи через команду конфигурации, а также команды модерации для перезапуска и статистики. В проекте документированы встроенное ограничение скорости как защита от затрат, уведомления и напоминания, а также статистика использования. Развёртывание выполняется самостоятельно: каждый экземпляр независим, использует собственное приложение Discord, собственный сервер и собственные локальные файлы данных для настроек, таймеров и турниров, без общего бэкенда или центральной учётной записи. Требования: Node.js 20 или выше, токен Discord-бота и ключ TMDB API, с опциональными ключами для Watchmode, OMDb, Trakt, RAWG, Google Books и OpenAI. Настройка включает клонирование репозитория, установку зависимостей, настройку файла .env, развёртывание слэш-команд и запуск бота. Кодовая база организована для расширения в каталогах src/commands, src/services, src/utils, public (веб-форма запроса событий) и docs (документация VitePress) и выпущена под лицензией MIT.