Saltar al contenido principal

🎉 Sorteos (Giveaways)

Descripción

Guía de Usuario

Lanza sorteos, gestiona múltiples premios, exige roles/puntos, vuelve a sortear ganadores y visualiza participantes — sin complicaciones.

🔎 Qué hace

  • Crea sorteos de 1 o múltiples premios.
  • Botones de participación persistentes (el contador se actualiza).
  • Condiciones de entrada: roles requeridos, puntos (opcional).
  • Peso de posibilidades: cúmulo de roles + roles extra.
  • Fin automático ⏱️, sorteo de ganadores 🏆, reroll fácil.

🚀 Inicio Rápido

  1. Lanza un sorteo simple (premio único): /giveaway duration:1h winners:1 role_1:@Miembro cumul_roles:No varios_items:No gain_multiple:No
  2. O un sorteo multi-premio: el bot te pedirá la lista de premios (uno por línea).
  3. (Opcional) Exigir/consumir puntos: required_points:100consume_points:Sí

🧩 Opciones Importantes

OpciónDescripción
durationej. 10m, 2h, 3d1h10m.
winnersnº de ganadores por premio.
role_1rol obligatorio. role_2 opcional.
cumul_rolessuma role_1 + role_2 para más posibilidades.
bonus_rolesroles que dan oportunidades extra.
plusieurs_itemsactivar multi-premios (el bot pedirá la lista).
gain_multiple¿la misma persona puede ganar varios premios?
required_pointsexigir puntos para participar.
consume_pointsdeducir puntos para participar.
message_idreutilizar un embed existente (se añade una sección "⏰ Fin").

🧰 Gestión Rápida (Admin)

ComandoDescripción
/giveawayCrear (premio único o multi-premio).
/giveaway_listerVer sorteos activos.
/giveaway_participantsListar inscritos por premio.
/giveaway_terminerTerminar ahora y sortear.
/giveaway_annulerCancelar sin sorteo.
/giveaway_relancerProlongar/modificar la duración.
/giveaway_rerollVolver a sortear (uno o varios premios).

👥 Participación (Usuario)

  • Clic en el botón 🎉 Participer (Participar) o en el botón del premio deseado.
  • Si ya estás inscrito, un mini menú te propone desinscribirte (reembolso de puntos si aplica 💸).
  • La etiqueta 📊 Participantes (N) se actualiza sola.

🛟 Solución de Problemas

  • 🚫 Imposible participar: falta rol requerido, o no hay suficientes puntos.
  • 🧮 Contador bloqueado: espera 1–2 s, se actualiza tras escribir en la base de datos.
  • 🎛️ Multi-premios: cada premio tiene su propio botón y lista de participantes.
  • 🔁 Reroll: si "ganadores múltiples" está desactivado, un ganador no puede llevarse dos premios.

❓ FAQ

Preguntas Frecuentes

¿Se puede reutilizar un embed ya publicado? Sí: pasa message_id y (opcional) channel. El bot añade la línea ⏰ Fin.

¿Los puntos se reembolsan si me desinscribo? Sí, si la opción "consumir puntos" estaba activa, el reembolso es automático al desinscribirse.

¿Cómo escribir la duración? Encadena las unidades: 3d1h10m (días/horas/minutos).