Instalación

Sigue estos pasos para instalar correctamente el script en tu bot.

Precaución

Estas instrucciones suponen que ya tienes un bot de Discord funcional y que sabes cómo añadir scripts a tu bot.

Pasos de instalación

1. Descarga el módulo y descomprime la carpeta

   Obtén la carpeta del módulo (normalmente en formato .zip o .rar) desde la fuente oficial.
   Usa una herramienta como WinRAR o 7-Zip para extraer la carpeta del script en tu equipo.

2. Configura las variables de entorno

   Abre el archivo .env incluido con el script y añade/modifica las variables de entorno necesarias para el correcto funcionamiento del módulo.

   • guildID : ID del servidor de Discord donde está desplegado el bot
   • animationRoleWinnerAnimationID : ID del rol de ganadores de eventos
   • animationChannelEventID : ID del canal donde se enviarán los mensajes de animación

3. Copia/mueve los archivos/código a tu proyecto

   Copia los siguientes archivos en las carpetas correspondientes de tu proyecto de bot de Discord:

   • commands/animation-add.js : en la carpeta de tus comandos slash
   • commands/animation-list.js : en la carpeta de tus comandos slash
   • commands/animation-remove.js : en la carpeta de tus comandos slash
   • commands/animation-message.js : en la carpeta de tus comandos slash
   • events/interactionCreate.js : copie la parte útil del código de este archivo para codificarla en el suyo
   • utils/arguments/post-message.js : en la carpeta de utilidades
   • utils/animation.js : en la carpeta de utilidades

   Copia también el código de inicialización del módulo en tu archivo principal index.js. En nuestro archivo, Prisma está vinculado directamente al objeto “client”: añade este código a tu proyecto o ajústalo según tu forma de usar Prisma.

4. Actualiza el esquema de la base de datos

   Añade el modelo de datos para las animaciones en tu archivo prisma/schema.prisma y ejecuta las migraciones necesarias para aplicar los cambios a tu base de datos. Ejecuta los siguientes comandos:

   npx prisma generate
   
   npx prisma migrate dev --name add_animation_model

5. Instala las dependencias

   Asegúrate de que las dependencias necesarias estén instaladas revisando tu package.json y ejecutando:

   npm install

6. Reinicia el bot

   Reinicia tu bot para que el script se cargue.

Modificar los permisos de los comandos

Accede a tu servidor y ve a Configuración del servidor > Integraciones. En la sección Bots y aplicaciones, haz clic en tu bot.

En la pestaña Comandos, puedes añadir excepciones para gestionar los permisos de los diferentes comandos añadidos por nuestro módulo.

Si no configuras estos permisos, todos los miembros de tu servidor tendrán acceso a los comandos del módulo.

Consejos

• Prueba los comandos slash /animation-add, /animation-list, /animation-remove, /animation-message en un servidor de pruebas antes de desplegarlos en producción.
• En index.js puedes modificar la programación para retirar el rol “Ganador de eventos” según tus necesidades. (Actualmente está configurado para ejecutarse todos los días a las 23:59).