Module Événements : guide de configuration pour les admins

Ce guide accompagne les administrateurs pour activer le module Événements, lancer un événement saisonnier, régler les récompenses et piloter les événements depuis Discord, le hub /setup et le tableau de bord web. Pour savoir comment les événements se vivent côté membres (apparitions, messages thématiques, chasses, score), consultez la page de la fonctionnalité Événements communautaires.

Activer ou désactiver le module

Le module Événements est activé par défaut, donc /event pour les membres et la carte d'administration des événements dans /setup sont disponibles immédiatement. Pour le désactiver (ou le réactiver) :

1. Ouvrez le tableau de bord Levlix et sélectionnez votre serveur.
2. Allez dans Modules et basculez le module Événements. Vous pouvez aussi le faire dans /setup sous Communauté, Événements.
3. Le changement atteint Discord en moins d'une minute.

Un événement à la fois

Un serveur fait tourner au plus un événement à la fois. Un événement démarre de l'une de deux façons :

• Manuellement : un admin choisit l'un des neuf thèmes et un dernier jour. L'événement se termine à 23:59:59 UTC ce jour-là.
• Saison automatique : une fois activée, Levlix consulte le calendrier chaque jour à 00:05 UTC et au démarrage du bot. Si un thème est de saison et qu'aucun événement n'est en cours, il lance ce thème et le termine avec la période du thème.

La saison automatique respecte vos décisions. Un thème déjà lancé dans sa période en cours n'est pas relancé, donc un événement que vous avez terminé plus tôt reste terminé. Un événement lancé manuellement bloque la saison automatique jusqu'à sa fin.

Pour démarrer, Levlix a besoin d'au moins un salon textuel non exclu où il peut voir le salon, envoyer des messages, ajouter des réactions et lire l'historique des messages. Sinon, le lancement est refusé avec un message qui vous l'indique. Si la publication dans un salon échoue pendant l'événement, Levlix ignore ce salon jusqu'à la fin de l'événement.

La carte d'administration dans Discord

Les admins disposant de la permission Gérer le serveur ouvrent la carte d'administration des événements dans /setup : choisissez Communauté, puis Événements, puis Ouvrir la gestion des événements.

La carte comporte quatre onglets, choisis dans un menu en bas :

• Statut : si un événement est en cours, quand il se termine et combien de membres, d'apparitions et de trouvailles il compte jusqu'ici. Prolonger déplace la date de fin, Terminer l'événement le termine après confirmation et lance immédiatement le tour des gagnants. Sans événement en cours, choisissez un thème sous Thème à lancer et saisissez la date de fin (YYYY-MM-DD, UTC).
• Récompenses : le taux de versement, le bonus des places 1 à 3 et le rôle des gagnants. Modifier les valeurs ouvre un formulaire pour le versement (0 à 200 %), les trois bonus et le nombre de meilleurs membres qui reçoivent le rôle des gagnants (1 à 10). Choisissez le rôle dans Rôle des gagnants (facultatif) ; Retirer le rôle des gagnants le supprime.
• Annonces : le salon d'annonces, le rôle à mentionner et l'interrupteur de saison automatique (Activer la saison automatique ou Désactiver la saison automatique).
• Classement : le top 10 de l'événement en cours et les cinq derniers événements passés avec leurs gagnants.

Les salons exclus, le niveau d'activité et le temps de recharge se règlent sur le tableau de bord web ; la carte y renvoie.

Récompenses

• Versement : chaque gain de score rapporte score × payout / 100 points du serveur, arrondis à l'inférieur. La valeur par défaut est 100 %, la plage de 0 à 200 %. À 0 %, l'événement se joue uniquement pour le classement et les bonus.
• Points bonus : les places 1, 2 et 3 reçoivent par défaut 500, 300 et 150 points du serveur (de 0 à 100 000 chacune). Les bonus sont toujours versés en entier, quel que soit le taux de versement.
• Rôle des gagnants : facultatif. À la fin de chaque événement, Levlix l'attribue aux meilleurs membres (les 3 premiers par défaut). Ils le gardent jusqu'au début de l'événement suivant ; Levlix le leur retire alors.
• Égalités : à score égal, le membre dont la dernière action qui a rapporté des points est la plus ancienne est classé devant.

Annonces

Levlix publie trois messages par événement : le lancement (avec les récompenses en jeu), un avertissement 24 heures avant la fin, et le tour des gagnants avec le top 10. Ils sont envoyés dans le salon d'annonces, ou dans le salon système du serveur si aucun n'est défini ; sans l'un ni l'autre, ils ne sont pas publiés. Le rôle à mentionner n'est mentionné que dans les messages de lancement et des gagnants.

Le hub de configuration

Dans /setup, la page Événements sous Communauté active ou désactive le module et contient l'essentiel : Lancer les événements selon le calendrier (saison automatique), Salon d'annonces et Rôle à mentionner. Ouvrir la gestion des événements ouvre la carte d'administration décrite plus haut, Ouvrir le tableau de bord la page d'administration web.

Le tableau de bord web

• Page des événements du serveur (/server/{id}/events, visible par tous les membres) : l'événement en cours avec les participants, les apparitions, les trouvailles et votre propre score, le classement, les derniers gagnants et le calendrier des douze prochains mois.
• Page d'administration des événements (/server/{id}/events/admin, pour les gestionnaires) : lancer un événement avec un thème et un dernier jour, modifier la fin ou y mettre fin maintenant, les récompenses et le rôle des gagnants, le salon d'annonces, le rôle à mentionner et Démarrer avec la saison (saison automatique), le classement et l'archive des événements terminés avec leurs gagnants.

Trois paramètres n'existent que sur la page d'administration web :

• Niveau d'activité : Faible (moitié moins d'apparitions), Normal ou Élevé (moitié plus d'apparitions). En Normal, un chat actif reçoit environ 6 apparitions d'emoji, 2 messages thématiques et 1 chasse par heure.
• Temps de recharge : secondes entre deux apparitions ou messages qui rapportent des points à un même membre, de 0 à 600 (60 par défaut). Les chasses n'ont pas de temps de recharge.
• Salons exclus : salons et catégories entières où rien n'apparaît et où les messages ne comptent pas dans l'activité du chat.

Référence des commandes des membres

Cette commande est disponible pour tout le monde lorsque le module est activé :

Se désinscrire vaut pour tous les événements sur tous les serveurs qui utilisent Levlix : les réactions et les propositions de chasse des membres désinscrits ne comptent pas, et leurs messages ne comptent pas dans l'activité du chat.

Liste de contrôle de la configuration

• Choisissez un salon d'annonces, sinon les messages vont dans le salon système ou ne sont pas publiés.
• Décidez si vous activez la saison automatique ou si vous lancez les thèmes manuellement.
• Vérifiez les récompenses : le taux de versement, les trois bonus et, si vous en voulez un, un rôle des gagnants.
• Excluez sur le tableau de bord web les salons où les apparitions dérangeraient (règles, annonces, support).
• Assurez-vous que Levlix peut envoyer des messages, ajouter des réactions et lire l'historique des messages dans vos salons de discussion.