Desafíos y Cartas

Descripción

Guía de Usuario

Anime su comunidad con desafíos semanales validados por el staff, cartas coleccionables, cajas de botín, una caja fuerte con código secreto y apariciones sorpresa en el chat. Dirigido a los administradores que quieren darle un propósito a la moneda de su servidor.

Qué hace

• Publica desafíos semanales que los miembros eligen, y luego valida sus pruebas en un canal dedicado.
• Permite coleccionar cartas (6 rarezas) agrupadas en colecciones, obtenidas en sobres de pago.
• Vende cajas de botín cuyo contenido se sortea según probabilidades.
• Abre una caja fuerte que los miembros intentan desbloquear con un código secreto.
• Lanza eventos reactivos: una recompensa aparece al azar en el chat, para los primeros que hagan clic.
• Gestiona el prestigio, las insignias y los objetos raros, todos visibles en un perfil.

Inicio Rápido (Admin)

1. Cree primero una moneda en el módulo «Multi-Monedas»: todo este módulo se apoya en ella (véase Moneda de servidor).
2. Abra el módulo Desafíos y Cartas en el panel de control.
3. Pestaña Desafíos: cree un desafío (título, criterio, recompensa, moneda) y luego declare el canal de validación de esa moneda — es allí donde llegarán las pruebas.
4. Pestaña Cartas: cree una colección y luego algunas cartas; pestaña Sobres: cree un sobre y ajuste sus probabilidades por rareza.
5. Pestaña Cajas fuertes: cree una caja fuerte (código secreto, intentos por día, premio).
6. Pestaña Eventos: ajuste la probabilidad de aparición, la duración y la recompensa — y luego añada al menos un canal autorizado, ya que si no nunca aparecerá nada.
7. Anuncie a los miembros /challengesystem defi liste y /challengesystem profil voir.

Comandos

Todos los comandos están bajo /challengesystem, seguidos de un grupo y luego de una acción.

Para los miembros

Comando	Descripción
/challengesystem defi liste	Muestra los desafíos disponibles, agrupados por moneda.
/challengesystem defi choisir	Elegir un desafío semanal.
/challengesystem defi soumettre_preuve	Enviar un archivo como prueba de haberlo logrado.
/challengesystem profil voir	Su perfil completo (monedas, insignias, objetos, cartas, prestigio).
/challengesystem profil recompenses	Ver las recompensas configuradas en el servidor.
/challengesystem carte moi	Ver su colección de cartas.
/challengesystem collection lister	Ver las colecciones del servidor.
/challengesystem booster ouvrir	Abrir un sobre de cartas (de pago).
/challengesystem lootbox ouvrir	Abrir una caja de botín y descubrir su recompensa.
/challengesystem lootbox voir	Ver el contenido anunciado de una caja de botín.
/challengesystem coffre tenter	Intentar abrir la caja fuerte introduciendo el código.
/challengesystem coffre actif	Ver la caja fuerte en curso.
/challengesystem coffre stats	Ver sus intentos restantes del día.
/challengesystem prestige voir	Ver su nivel de prestigio.
/challengesystem badge voir	Ver sus insignias.
/challengesystem objet voir	Ver sus objetos raros.

Para el staff

Comando	Descripción
/challengesystem defi ajouter	Crear un desafío semanal.
/challengesystem defi config_validation	Definir el canal de validación de las pruebas para una moneda.
/challengesystem carte creer · carte modifier · carte supprimer	Gestionar las cartas (con vista previa antes de publicar).
/challengesystem collection creer	Crear una colección de cartas.
/challengesystem booster creer · booster config_proba	Crear un sobre y ajustar sus probabilidades por rareza.
/challengesystem lootbox ajouter · lootbox ajouter_item	Crear una caja de botín y colocar premios en ella.
/challengesystem coffre creer · coffre fermer	Abrir o cerrar una caja fuerte.
/challengesystem prestige configurer	Definir el umbral de prestigio y el rol asignado.
/challengesystem badge ajouter	Crear una insignia disponible.
/challengesystem objet ajouter	Crear un objeto raro.
/challengesystem event configurer · event onoff	Ajustar y activar los eventos reactivos.
/challengesystem event channels_add · channels_remove · channels_list	Gestionar los canales donde pueden aparecer los eventos.
/challengesystem event forcer	Lanzar un evento de inmediato (prueba).
/challengesystem chaos ajouter · chaos ajouter_effet · chaos liste · chaos ouvrir	Gestionar las Cajas del Caos y sus efectos.

Ajustes desde el panel de control

El módulo se presenta en diez pestañas y cubre todo lo que hacen los comandos de staff — en general de forma más cómoda (tablas, formularios, selectores de roles y de canales):

• Desafíos — lista de los desafíos (título, tipo, criterio, tipo y valor de la recompensa, moneda asociada, prueba requerida o no) y tabla de los canales de validación por moneda.
• Cartas — cartas (nombre, descripción, imagen por URL, rareza, colección) y colecciones.
• Sobres — precio, moneda, número de cartas obtenidas (mín./máx.) y tabla de sorteo por tipo y rareza con un peso.
• Cajas de botín — cajas (precio, moneda, stock) y sus premios con un peso de sorteo.
• Cajas fuertes — código secreto, pista, intentos por día, premio y la opción «desactivar las demás cajas fuertes activas».
• Prestigio — umbral (total de las monedas), rol asignado, multiplicador mostrado en la ficha de prestigio.
• Insignias — nombre, emoji, imagen y rol de Discord asignado con la insignia (opcional).
• Objetos raros — nombre, descripción, emoji, imagen.
• Eventos — probabilidad por mensaje (0 a 1), tiempo de espera, número de ganadores, duración, recompensa.
• Caos — Cajas del Caos y sus efectos: pérdida global, boost de casino, bonificación global, cierre de la tienda, inversión de las ganancias.

Bueno saberlo

• El panel de control muestra un aviso «Módulo inestable — en desarrollo». Es reciente y puede cambiar sin previo aviso: pruébelo en un canal discreto antes de anunciar un evento a todo el servidor.
• Nada funciona sin una moneda. Desafíos, sobres, cajas de botín, cajas fuertes y eventos están todos vinculados a una moneda del módulo Multi-Monedas. Sin una moneda creada, los formularios permanecerán vacíos.
• Los desafíos no se validan solos. El «tipo» y el «criterio» son texto libre: el bot no mide ningún progreso. El miembro elige el desafío, envía un archivo como prueba y un miembro del staff aprueba o rechaza con los botones del mensaje publicado en el canal de validación. Sin un canal de validación configurado para la moneda del desafío, la prueba no llega a ninguna parte.
• Un desafío solo puede elegirse una vez por miembro: no existe la opción de «volver a jugarlo».
• El prestigio pone los contadores a cero. Cuando el total de las monedas de un miembro alcanza el umbral, todos sus saldos se ponen a 0, su nivel de prestigio sube 1 y se le concede el rol configurado. Anúncielo con claridad, o sus miembros lo vivirán como una pérdida.
• Caja fuerte: el código se almacena cifrado (nadie puede volver a leerlo en la base de datos), los intentos están limitados por día (de 1 a 100, 5 por defecto) y se restablecen cada día. Crear una caja fuerte desactiva las anteriores por defecto.
• Los eventos reactivos solo aparecen en los canales que usted indique. Mientras no se añada ningún canal, la probabilidad de aparición no sirve de nada. El bot también necesita permiso para escribir en esos canales.
• Las compras se cobran antes del sorteo: al abrir una caja de botín o un sobre se comprueba el saldo, se reserva el stock y luego se sortea el premio. Un stock agotado bloquea la apertura.
• No todos los comandos de staff están protegidos de la misma forma. La mayoría exigen «Gestionar el servidor» o «Administrador», pero algunos comandos de creación (los desafíos y las cajas de botín en particular) no comprueban nada por parte del bot. Restrinja /challengesystem a sus roles de confianza desde Ajustes del servidor → Integraciones.
• El módulo cuenta con más de cuarenta subcomandos: prefiera el panel de control para la configuración y deje a los miembros solo los comandos de consulta y de juego.