Установка

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

Внимание

Эти инструкции предполагают, что у вас уже есть рабочий Discord‑бот и вы знаете, как добавлять скрипты в бота.

Этапы установки

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

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

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

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

   • guildID : ID сервера Discord, на котором развернут бот
   • animationRoleWinnerAnimationID : ID роли победителей событий
   • animationChannelEventID : ID канала, в который будут отправляться сообщения анимации

3. Скопируйте/переместите файлы/код в ваш проект

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

   • commands/animation-add.js : в папку с вашими slash‑командами
   • commands/animation-list.js : в папку с вашими slash‑командами
   • commands/animation-remove.js : в папку с вашими slash‑командами
   • commands/animation-message.js : в папку с вашими slash‑командами
   • events/interactionCreate.js : скопируйте нужную часть кода из этого файла, чтобы закодировать ее в своем файле
   • utils/arguments/post-message.js : в папку утилит
   • utils/animation.js : в папку утилит

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

4. Обновите схему базы данных

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

   npx prisma generate
   
   npx prisma migrate dev --name add_animation_model

5. Установите зависимости

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

   npm install

6. Перезапустите бота

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

Изменить разрешения команд

Войдите на свой сервер, затем перейдите в Настройки сервера > Интеграции. В разделе Боты и приложения нажмите на своего бота.

На вкладке Команды вы можете добавить исключения для управления разрешениями различных команд, добавленных нашим модулем.

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

Советы

• Протестируйте slash‑команды /animation-add, /animation-list, /animation-remove, /animation-message на тестовом сервере перед развертыванием в продакшн.
• В index.js вы можете изменить расписание снятия роли “Победитель события” по своему усмотрению. (В текущей конфигурации задача выполняется ежедневно в 23:59).