Bot de Puré

^{(La ilustración original le pertenece a カンパ, quien no forma parte de ni está relacionado con el proyecto de desarrollo de Bot de Puré)}

Bot de entretenimiento, búsqueda de imágenes y utilidades generales varias para Discord. Utiliza comandos tradicionales con adiciones inspiradas en terminales como --flags o los nuevamente introducidos comandos estandarizados de /barra.
Como personaje, es una robot torpe y agresiva en algunos casos, pero parece meterle ganas.

[!IMPORTANT] Ejecutar una copia local te dará una experiencia más responsiva con Bot de Puré y te permitirá modificar su comportamiento a gusto.

Para aquellos que quieran ejecutar una copia local:

• Introduce los archivos ./localenv.json y ./remoteenv.json, ambos con el siguiente formato (no compartas los datos con nadie):

  {
  "token": "<<El Token de la aplicación de Discord sobre la cual operarás el bot>>",
  "dburi": "<<La URI de la Base de Datos de MongoDB que usarás>>",
  "booruapikey": "<<La clave de API de una cuenta de Gelbooru>>",
  "booruuserid": "<<La ID de usuario de la misma cuenta de Gelbooru>>",
  "pixivtoken": "<<El Refresh Token de una cuenta de pixiv>>",
  "imgurclientid": "<<La ID de cliente de una cuenta de Gelbooru>>"
  }

• localenv.json se usa para un entorno de desarrollo, mientras que remoteenv.json se usa para un entorno de producción. Esta solución no es para nada elegante pero me ha estado funcionando bien de momento
• Al ejecutar con Node, usas la bandera -d para usar el entorno de desarrollo y -p para el entorno de producción

  node . -d

Índice

• Tecnologías Principales
• Características
• Convenciones de Desarrollo
• Integrantes

Tecnologías Principales

• Node.js
• discord.js
• MongoDB / Mongoose

Características

• Personalización a nivel de servidor y usuario

• Soporte de comandos por mensaje (p!) y por uso de barra (/) Comando de Mensaje	Comando Slash

• Fácil y rápida automatización en servidores gracias al uso de Asistentes de Configuración:

  • Usa el Asistente PuréFeed para programar el envío de imágenes de Gelbooru en un canal, con las tags que quieras
    
  • Usa el Asistente PuréVoice para configurar una categoría de canales de voz dinámicos avanzados (sesiones PuréVoice)
    
  • Usa el Asistente de Confesiones para facilitar la distribución de confesiones anónimas, seguras y con protección contra abusos
    

• Fáciles y rápidas configuraciones de usuario por medio del comando p!yo o /yo
  

  • Configura nombres automáticos de sesión y otras preferencias de usuario para sesiones de voz (PuréVoice)
  • Corrección automática de previsualizaciones de enlaces de Twitter/X (Puréet) y pixiv (Purépix)
  • Edita tus suscripciones a tags de Feeds de imágenes (PuréFeed)
  • Soporte de español, inglés y (parcialmente) japonés

• Fácil reproducción de música con sencilla gestión de colas de reproducción
  

• Soporte de comandos personalizados de servidor

  • Se los llama "Tubérculos", contienen una TuberID y una respuesta que ejecutan al ser invocados
    
  • Los "Tubérculos simples" envían texto y/o archivos
    
  • Los "Tubérculos avanzados" ejecutan una serie de instrucciones PuréScript para enviar respuestas más elaboradas
    
  • Puedes leer la documentación detallada del lenguaje PuréScript aquí
    

• Herramientas de moderación y estadísticas (más por venir)

• Minijuegos (más por venir)

• Wiki de comandos y guías de uso básico por medio del comando p!ayuda

  Metas

• Brindar más herramientas de personalización a nivel de servidor, canal y usuario; que sean fáciles de entender y ejecutar

• Ofrecer potentes herramientas de automatización que empoderen a TODOS los usuarios y aumenten la actividad del servidor

• Ofrecer una amplia capacidad de moderación y auditoría en diferentes campos

• Sostener un ambiente relajado y casual con comandos de entretenimiento

• Tropezarse y aprender sobre la marcha

• Divertirse

  Objetivos actuales

• Terminar PuréScript

• Agregar ejemplos interactivos de comandos con p!ayuda

• Minijuegos individuales y tipo "fiesta"

• Agregar GIFs infográficos en comandos

• Crear página de ayuda Web para no limitarse a mensajes de Discord

Convenciones de Desarrollo

Con el fin de trabajar de forma más eficiente y organizada, se siguen las siguientes convenciones

• Comandos
  • deben tener aliases siempre que sea posible
  • los aliases deberían ser sinónimos, versiones acortadas o las iniciales del nombre del comando
  • se deberían incluir aliases en inglés siempre que sea posible
  • siempre que sea aplicable, debería haber una versión por mensaje y una versión por "/" del comando
  • Deben tener una página de ayuda lo más descriptiva y breve posible
• Parámetros
  • deberían de ser los más intuitivos ya que forman parte del uso básico de la mayoría de comandos
  • se deben ingresar en un orden específico, a menos que:
  • el darles un orden vuelva muy confuso al comando en cuestión
  • el orden de los mismos sea por motivos demasiado abstractos
• Banderas
  • se deben de poder ingresar en cualquier orden
  • deben tener, si es posible, versiones cortas y largas
  • las versiones cortas deberían ser la inicial de la contraparte larga
  • las versiones largas solo deberían tener caracteres alfabéticos

Integrantes

Personas involucradas en el desarrollo de Bot de Puré, con sus tags de Discord.

Desarrolladores

• papitaconpure Papita con Puré#6932

  Participantes

• imbreaker. Imagine Breaker#6299
• sassafras_doya Sassafras#3331

  Colaboradores

• rakkidei Rakkidei#4790
• superarathys12 Super Arathy's 12#8235
• taton Taton#0122

[!NOTE] Empecé este proyecto con 0 conocimiento sobre JavaScript y para cuando me di cuenta creció demasiado, así que ando navegando unos 5 años de mi propia deuda técnica.

[!NOTE] No esperes ningún tipo de madurez tanto emocional como intelectual si lees el código o usas a Bot de Puré