Sommaire
Guide du module Concours de Levlix
Le module Concours de Levlix permet aux admins de publier des concours à durée limitée qui rapportent des points du serveur. Les membres participent en un clic et les gagnants sont tirés au sort automatiquement.
Voir aussi : Automatisation des concours.
Fonctionnement d'un concours
- Un admin définit un titre, un prix en points, un nombre de gagnants et une durée. Levlix publie le concours dans le salon choisi avec un bouton Participer au concours.
- Les membres cliquent sur le bouton pour participer. Chaque membre peut participer une fois, et le compteur de participations du message se met à jour après chaque participation.
- À la fin du minuteur, Levlix tire les gagnants au sort, crédite le prix sur le solde de chaque gagnant et publie l'annonce des gagnants dans le même salon. Le message d'origine affiche le résultat et perd son bouton.
- Le message du concours et l'annonce des gagnants sont des cartes dans la langue du serveur. Le bouton Dans ma langue affiche la même carte dans votre propre langue, visible par vous seul.
- Les concours en cours survivent à un redémarrage du bot : les boutons sont rattachés et les minuteurs de fin reprogrammés. Un concours dont l'heure de fin est passée pendant que le bot était hors ligne est tiré dès le retour du bot.
Créer un concours
/giveaway create channel: #giveaways
Le salon est facultatif ; sans lui, Levlix utilise le salon par défaut des paramètres, ou le salon actuel. La commande ouvre un formulaire :
| Champ | Description |
|---|---|
| Titre du concours | Titre du message, jusqu'à 255 caractères |
| Description | Texte facultatif, jusqu'à 1 000 caractères. Par défaut : « Bonne chance à tous les participants ! » |
| Prix en points | Points crédités à chaque gagnant. Doit être un nombre positif |
| Nombre de gagnants | Entre 1 et 20 (par défaut 1) |
| Durée | 60m, 1h, 1d, 2d12h et similaires. Un nombre seul compte en minutes. Par défaut 60m |
/giveaway create-advanced ouvre le même formulaire avec une option supplémentaire require_game_id qui remplace la valeur par défaut du serveur pour ce concours : seuls les membres ayant un Game ID enregistré peuvent participer.
Depuis le tableau de bord web
Sur la page Concours, cliquez sur Nouveau concours et remplissez Titre, Description, Prix en points, Gagnants, Salon et Durée (heures). Exiger un Game ID limite les participations aux membres ayant un Game ID enregistré. Créer un concours confie le concours au bot, qui le publie dans le salon exactement comme /giveaway create : même message, même bouton Participer au concours, même tirage et même versement automatiques.
Les limites sont celles de la commande : jusqu'à 20 gagnants et de 1 à 720 heures. Vous devez avoir la permission d'envoyer des messages dans le salon, et le bot aussi.
Gérer les concours
Chaque message de concours affiche son ID dans le pied de page ; les commandes d'administration l'utilisent :
| Commande | Description |
|---|---|
/giveaway end giveaway_id: <id> |
Termine le concours maintenant, tire les gagnants et verse le prix. Terminer plus tôt sur le tableau de bord fait la même chose |
/giveaway cancel giveaway_id: <id> |
Clôt le concours sans gagnants. Le message est marqué ANNULÉ et un avis est envoyé dans le salon |
/giveaway stats giveaway_id: <id> |
Statut, prix, participations, gagnants, date de création, temps restant et lien vers le message. L'ID se complète automatiquement à partir des concours récents. Sans giveaway_id, vous obtenez un aperçu des concours du serveur |
Créer, terminer, annuler et consulter les statistiques nécessite Gérer le serveur (ou Administrateur), ou le rôle d'admin défini dans les paramètres. /giveaway settings nécessite Gérer le serveur.
Paramètres
/giveaway settings default_channel: #giveaways admin_role: @Giveaway Team enabled: True require_game_id: False
Seules les options que vous indiquez sont modifiées. Sans options, la commande affiche les paramètres actuels. Les mêmes paramètres se trouvent aussi dans /setup sous Engagement puis Concours.
| Option | Description |
|---|---|
default_channel |
Salon utilisé lorsque /giveaway create est lancé sans salon |
admin_role |
Rôle autorisé à créer et gérer des concours en plus d'Administrateur et Gérer le serveur |
enabled |
Active ou désactive la création de concours. Lorsqu'elle est désactivée, les commandes de création répondent « Les concours sont actuellement désactivés sur ce serveur. » |
require_game_id |
Valeur par défaut pour tout le serveur : seuls les membres ayant un Game ID enregistré peuvent participer |
Pour les membres
/giveaway prizes
Ouvre un hub privé avec trois onglets :
| Onglet | Description |
|---|---|
| En cours | Tous les concours en cours avec leur prix, leur heure de fin et leurs participations. Participer vous inscrit à un concours directement depuis le hub |
| Mes participations | Les concours en cours auxquels vous participez |
| Mes gains | Combien de concours et de points vous avez gagnés, avec vos victoires récentes |
Le hub n'est visible que par vous.
Tableau de bord web
Ouvrez votre serveur dans le tableau de bord et choisissez Concours dans la barre latérale (rôle de modérateur ou supérieur). La page affiche des compteurs pour les concours actifs, les participations totales, les prix totaux et les concours terminés, une carte par concours actif avec un bouton Terminer plus tôt, et les 50 derniers concours passés avec le prix, les gagnants, les participations et la date de fin.
Nouveau concours lance un concours (voir Depuis le tableau de bord web). Terminer plus tôt demande une confirmation, puis le bot tire les gagnants, verse le prix et les annonce dans le salon du concours, exactement comme /giveaway end.
FAQ
Que se passe-t-il s'il y a moins de participations que de gagnants ? Levlix tire autant de gagnants qu'il y a de participations. Sans aucune participation, il annonce qu'il n'y avait pas assez de participants.
Un membre peut-il participer deux fois ? Non. Un deuxième clic répond « Vous participez déjà à ce concours ! ». Les participations sont aussi refusées une fois l'heure de fin passée.
Les concours peuvent-ils se dérouler en messages privés ? Non. Les concours fonctionnent uniquement sur les serveurs.