Перейти к содержанию

Установка

Следуйте этим шагам, чтобы правильно установить скрипт на вашем боте.

  1. Скачайте модуль и распакуйте папку

    Получите папку модуля (обычно в формате .zip или .rar) с официального источника. Используйте инструмент, такой как WinRAR или 7-Zip, чтобы извлечь папку скрипта на ваш компьютер.

  2. Создание ваших ключей API YouTube

    • Вход на платформу разработчиков Google
      Перейдите на: Дашборд, чтобы войти или создать аккаунт для доступа к дашборду.

    • Создание проекта
      Нажмите Создать проект, затем введите имя вашего проекта и подтвердите создание.

    • Активация API YouTube на вашем аккаунте Google
      Перейдите на: YouTube API, чтобы активировать API Google.

    • Создание вашего приложения
      Нажмите Учетные данные или перейдите по этой ссылке: Учетные данные


      Нажмите Создать учетные данные, затем выберите API-ключи


      Заполните следующие поля:

      • Имя (название вашего приложения, например: BotYoutube)
      • Ограничения приложения => IP-адреса и введите IP-адрес вашего VPS/вашей машины
      • В разделе ограничений API выберите YouTube Data API v3

      Затем подтвердите создание. Ключ будет отображен, чтобы вы могли вставить его в файл .env.


    • ⚠️ Если вы не хотите платить, у вас есть лимит на количество запросов в день
      Через модуль вы можете добавить до 5 YouTube-аккаунтов. Если вам нужно больше, вам нужно будет изменить это на странице Квоты

  3. Настройте переменные окружения

    Откройте файл .env, предоставленный со скриптом, и добавьте и измените необходимые переменные окружения для правильной работы модуля.

    • youtubeChannelID : ID канала, куда будут отправляться уведомления YouTube
    • youtubeRoleID : ID роли пользователей, желающих получать уведомления (обычно роль участника для уведомления всего сервера или роль, созданная вами, чтобы участники могли выбрать эту роль для получения уведомлений о новом видео!)
    • youtubeAPIKey : Ключ API YouTube (См. шаг 2)
    • youtubeChannelFollowerID : ID голосового канала, который будет обновляться в отношении количества подписчиков (Настройте аккаунт в коде, смотрите следующий шаг)
  4. Скопируйте/переместите файлы/код в ваш проект

    Скопируйте следующие файлы в соответствующие папки вашего проекта Discord-бота:

    • commands/notification/notification-add.js : в папку ваших команд
    • commands/notification/notification-list.js : в папку ваших команд
    • commands/notification/notification-remove.js : в папку ваших команд
    • utils/notification/youtube.js : в папку ваших утилит
    • utils/utils.js : в папку ваших утилит

    Также скопируйте код инициализации модуля в ваш основной файл index.js. В этом файле мы добавили prisma, напрямую связанную с объектом “client”, вставьте этот код в ваш файл или настройте его в соответствии с тем, как вы используете prisma.

    ❗ Если хотите, вы можете изменить PSEUDO_UPDATE_CHANNEL_STAT, чтобы обновить статистический канал, или закомментировать эту строку. Псевдоним должен совпадать с тем, что записано в базе данных.

    Изображение уведомления Youtube
  5. Обновите схему базы данных

    Добавьте модель данных для получения уведомлений о новых видео YouTube в ваш файл prisma/schema.prisma и выполните необходимые миграции, чтобы применить изменения к вашей базе данных. Выполните следующую команду:

    Окно терминала
    npx prisma generate
    npx prisma migrate dev --name add_youtube_notification
  6. Установите зависимости

    Убедитесь, что необходимые зависимости установлены, проверив ваш package.json и выполнив:

    Окно терминала
    npm install
  7. Перезапустите бота

    Перезапустите вашего бота, чтобы скрипт был загружен.


  • Для команды /notification-add вам нужно ввести имя канала YouTube, которое указано в URL канала. Пример: https://www.youtube.com/@Joyca => Имя, которое нужно ввести при использовании команды, это Joyca (без @).